你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzSynapseFirewallRule

模块:: Az.Synapse Module

创建 Synapse Analytics 防火墙规则。

语法

CreateByNameParameterSet （默认值）

New-AzSynapseFirewallRule
    -WorkspaceName <String>
    -Name <String>
    -StartIpAddress <String>
    -EndIpAddress <String>
    [-ResourceGroupName <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateByNameAllowAllAzureIpParameterSet

New-AzSynapseFirewallRule
    -WorkspaceName <String>
    [-ResourceGroupName <String>]
    [-AllowAllAzureIp]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateByNameAllowAllIpParameterSet

New-AzSynapseFirewallRule
    -WorkspaceName <String>
    [-ResourceGroupName <String>]
    [-AllowAllIp]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateByParentObjectParameterSet

New-AzSynapseFirewallRule
    -WorkspaceObject <PSSynapseWorkspace>
    -Name <String>
    -StartIpAddress <String>
    -EndIpAddress <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateByParentObjectAllowAllAzureIpParameterSet

New-AzSynapseFirewallRule
    -WorkspaceObject <PSSynapseWorkspace>
    [-AllowAllAzureIp]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateByParentObjectAllowAllIpParameterSet

New-AzSynapseFirewallRule
    -WorkspaceObject <PSSynapseWorkspace>
    [-AllowAllIp]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

New-AzSynapseFirewallRule cmdlet 创建 Azure Synapse Analytics 防火墙规则。

示例

示例 1

New-AzSynapseFirewallRule -WorkspaceName ContosoWorkspace -Name ContosoFirewallRule -StartIpAddress "0.0.0.0" -EndIpAddress "255.255.255.255"

此命令在名为 ContosoFirewallRule 的工作区 ContosoWorkspace 下创建名为 ContosoFirewallRule 的防火墙规则。

示例 2

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | New-AzSynapseFirewallRule -Name ContosoFirewallRule -StartIpAddress "0.0.0.0" -EndIpAddress "255.255.255.255"

此命令通过管道在工作区下创建名为 ContosoFirewallRule 的防火墙规则。

示例 3

New-AzSynapseFirewallRule -WorkspaceName ContosoWorkspace -AllowAllAzureIP

此命令创建允许工作区下的所有 Azure IP 的防火墙规则。

参数

-AllowAllAzureIp

创建允许所有 Azure IP 都有权访问的特殊防火墙规则。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateByNameAllowAllAzureIpParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByParentObjectAllowAllAzureIpParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AllowAllIp

创建允许来自所有 IP 地址的连接的特殊防火墙规则。起始 IP 为 0.0.0.0。结束 IP 为 255.255.255.255。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateByNameAllowAllIpParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByParentObjectAllowAllIpParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AsJob

在后台运行 cmdlet

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EndIpAddress

防火墙规则的结束 IP 地址。必须是 IPv4 格式。必须大于或等于 startIpAddress。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateByNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByParentObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

工作区的防火墙规则名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	FirewallRuleName

参数集

CreateByNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByParentObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

资源组名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateByNameParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByNameAllowAllAzureIpParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByNameAllowAllIpParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-StartIpAddress

防火墙规则的起始 IP 地址。必须是 IPv4 格式。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateByNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByParentObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WorkspaceName

Synapse 工作区的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateByNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByNameAllowAllAzureIpParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByNameAllowAllIpParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WorkspaceObject

工作区输入对象，通常通过管道传递。

参数属性

类型:	PSSynapseWorkspace
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateByParentObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByParentObjectAllowAllAzureIpParameterSet

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateByParentObjectAllowAllIpParameterSet

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

New-AzSynapseFirewallRule

语法

CreateByNameParameterSet （默认值）

CreateByNameAllowAllAzureIpParameterSet

CreateByNameAllowAllIpParameterSet

CreateByParentObjectParameterSet

CreateByParentObjectAllowAllAzureIpParameterSet

CreateByParentObjectAllowAllIpParameterSet

说明

示例

示例 1

示例 2

示例 3

参数

-AllowAllAzureIp

参数属性

参数集

-AllowAllIp

参数属性

参数集

-AsJob

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-EndIpAddress

参数属性

参数集

-Name

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-StartIpAddress

参数属性

参数集

-WhatIf

参数属性

参数集

-WorkspaceName

参数属性

参数集

-WorkspaceObject

参数属性

参数集

CommonParameters

输入

PSSynapseWorkspace

输出

Microsoft.Azure.Commands.Synapse.Models.PSSynapseIpFirewallRule

反馈