你当前正在访问 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 地址资源。 NRP 将检查给定 IP 是否在 PublicIpPrefix 内部，以及给定 PublicIpPrefix 是否为 BYOIP PublicIpPrefix。给定的公共 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。

类型:	String
接受的值:	Dynamic, Static
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-AsJob

在后台运行 cmdlet

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DdosProtectionMode

用于公共 IP 地址的 DdosProtectionMode

类型:	String
接受的值:	VirtualNetworkInherited, Enabled, Disabled
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-DdosProtectionPlanId

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-DefaultProfile

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

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainNameLabel

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-DomainNameLabelScope

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

类型:	Nullable<T>[PSDomainNameLabelScopeType]
接受的值:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-EdgeZone

扩展位置的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Force

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdleTimeoutInMinutes

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-IpAddress

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-IpAddressVersion

指定 IP 地址的版本。

类型:	String
接受的值:	IPv4, IPv6
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-IpTag

IpTag 列表。

类型:	PSPublicIpTag[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Location

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

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

类型:	String
别名:	ResourceName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-PublicIpPrefix

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

类型:	PSPublicIpPrefix
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ResourceGroupName

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ReverseFqdn

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Sku

公共 IP Sku 名称。

类型:	String
接受的值:	Basic, Standard
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Tag

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

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Tier

公共 IP SKU 层。

类型:	String
接受的值:	Regional, Global
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Zone

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	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

输入

输出

相关链接

其他资源