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

New-AzPublicIpAddress

参考

模块:: Az.Network

创建公共 IP 地址。

语法

New-AzPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   [-Sku <String>]
   [-Tier <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-DomainNameLabelScope <PSDomainNameLabelScopeType>]
   [-IpTag <PSPublicIpTag[]>]
   [-PublicIpPrefix <PSPublicIpPrefix>]
   [-DdosProtectionMode <String>]
   [-DdosProtectionPlanId <String>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <String[]>]
   [-IpAddress <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzPublicIpAddress cmdlet 创建公共 IP 地址。

示例

示例 1：创建新的公共 IP 地址

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location

此命令将创建新的公共 IP 地址资源。为指向此资源的公共 IP 地址$dnsPrefix.$location.cloudapp.azure.com创建 DNS 记录。公共 IP 地址将立即分配给此资源，因为 -AllocationMethod 被指定为“Static”。如果指定为“动态”，则仅当启动（或创建）关联的资源（例如 VM 或负载均衡器）时，才会分配公共 IP 地址。

示例 2：使用反向 FQDN 创建公共 IP 地址

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -ReverseFqdn $customFqdn

此命令将创建新的公共 IP 地址资源。使用 -ReverseFqdn 参数，Azure 将为分配给此资源的公共 IP 地址创建 DNS PTR 记录（反向查找），指向命令中指定的$customFqdn。作为先决条件，$customFqdn（例如 webapp.contoso.com）应具有指向$dnsPrefix.$location.cloudapp.azure.com的 DNS CNAME 记录（向前查找）。

示例 3：使用 IpTag 创建新的公共 IP 地址

$ipTag = New-AzPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTag $ipTag

示例 4：从前缀创建新的公共 IP 地址

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -PublicIpPrefix $publicIpPrefix -Sku Standard

此命令将创建新的公共 IP 地址资源。为指向此资源的公共 IP 地址$dnsPrefix.$location.cloudapp.azure.com创建 DNS 记录。公共 IP 地址立即从指定的 publicIpPrefix 分配给此资源。此选项仅支持“标准”Sku 和“Static”AllocationMethod。

示例 5：从 BYOIP 前缀创建特定的公共 IP 地址

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -Location $location -IpAddress 0.0.0.0 -PublicIpPrefix $publicIpPrefix -Sku Standard

此命令创建具有特定 IP 的新公共 IP 地址资源。如果给定 IP 位于 PublicIpPrefix 内，并且给定 PublicIpPrefix 为 BYOIP PublicIpPrefix，则 NRP 将检查。给定的公共 IP 地址立即从指定的 publicIpPrefix 分配给此资源。此选项仅支持“标准”Sku 和“Static”AllocationMethod 和 BYOIP PublicIpPrefix。

示例 6：创建新的全局公共 IP 地址

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $domainNameLabel -Location $location -Sku Standard -Tier Global

此命令将创建新的全局公共 IP 地址资源。为指向此资源的公共 IP 地址$dnsPrefix.$location.cloudapp.azure.com创建 DNS 记录。全局公共 IP 地址将立即分配给此资源。此选项仅支持“标准”Sku 和“Static”AllocationMethod。

示例 7：使用 DomainNameLabelScope 创建公共 IP 地址

$publicIp = New-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -DomainNameLabelScope $hasedReusePolicy -Location $location

此命令将创建新的公共 IP 地址资源。使用 -DomainNameLabelScope 参数，Azure 使用 FQDN 中的哈希值为分配给此资源的公共 IP 地址创建 DNS 记录，其策略由$hasedReusePolicy建议。

参数

-AllocationMethod

指定分配公共 IP 地址的方法。此参数的可接受值为：Static 或 Dynamic。

Type:	String
Accepted values:	Dynamic, Static
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-AsJob

在后台运行 cmdlet

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DdosProtectionMode

用于公共 IP 地址的 DdosProtectionMode

Type:	String
Accepted values:	VirtualNetworkInherited, Enabled, Disabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DdosProtectionPlanId

要附加到公共 IP 地址的 DdosProtectionPlan ID

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainNameLabel

指定公共 IP 地址的相对 DNS 名称。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DomainNameLabelScope

为公共 IP 地址指定 DNS 名称的 HashedReusePolicy。

Type:	Nullable<T>[PSDomainNameLabelScopeType]
Accepted values:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EdgeZone

扩展位置的名称。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

强制运行命令而不要求用户确认。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdleTimeoutInMinutes

指定空闲超时（以分钟为单位）。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IpAddress

指定创建 BYOIP publicIpAddress 时的 IP 地址。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IpAddressVersion

指定 IP 地址的版本。

Type:	String
Accepted values:	IPv4, IPv6
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IpTag

IpTag 列表。

Type:	PSPublicIpTag[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

指定要在其中创建公共 IP 地址的区域。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

指定此 cmdlet 创建的公共 IP 地址的名称。

Type:	String
Aliases:	ResourceName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicIpPrefix

指定要从中分配公共 IP 地址的 PSPublicIpPrefix。

Type:	PSPublicIpPrefix
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

指定要在其中创建公共 IP 地址的资源组的名称。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReverseFqdn

指定反向完全限定的域名（FQDN）。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Sku

公共 IP Sku 名称。

Type:	String
Accepted values:	Basic, Standard
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

以哈希表的形式进行键值对。例如：@{key0=“value0”;key1=$null;key2=“value2”}

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tier

公共 IP SKU 层。

Type:	String
Accepted values:	Regional, Global
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

表示为资源分配的 IP 需要来自的可用性区域列表。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

输入

String

PSPublicIpTag[]

PSPublicIpPrefix

Int32

String[]

Hashtable

输出

PSPublicIpAddress

New-AzPublicIpAddress

语法

说明

示例

示例 1：创建新的公共 IP 地址

示例 2：使用反向 FQDN 创建公共 IP 地址

示例 3：使用 IpTag 创建新的公共 IP 地址

示例 4：从前缀创建新的公共 IP 地址

示例 5：从 BYOIP 前缀创建特定的公共 IP 地址

示例 6：创建新的全局公共 IP 地址

示例 7：使用 DomainNameLabelScope 创建公共 IP 地址

参数

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

输入

输出

反馈

其他资源

New-AzPublicIpAddress

语法

说明

示例

示例 1：创建新的公共 IP 地址

示例 2：使用反向 FQDN 创建公共 IP 地址

示例 3：使用 IpTag 创建新的公共 IP 地址

示例 4：从前缀创建新的公共 IP 地址

示例 5：从 BYOIP 前缀创建特定的公共 IP 地址

示例 6：创建新的全局公共 IP 地址

示例 7：使用 DomainNameLabelScope 创建公共 IP 地址

参数

-AllocationMethod

-AsJob

-Confirm

-DdosProtectionMode

-DdosProtectionPlanId

-DefaultProfile

-DomainNameLabel

-DomainNameLabelScope

-EdgeZone

-Force

-IdleTimeoutInMinutes

-IpAddress

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-Tier

-WhatIf

-Zone

输入

输出

相关链接

反馈

其他资源