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

New-AzPublicIpAddress

模块:: Az.Network Module

创建公共 IP 地址。

语法

Default （默认值）

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 被指定为“静态”。如果指定为“动态”，则仅当启动（或创建）关联的资源（例如 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
默认值:	None
接受的值:	Dynamic, Static
支持通配符:	False
不显示:	False

参数集

(All)

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

-AsJob

在后台运行 cmdlet

参数属性

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

参数集

(All)

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

-Confirm

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

参数属性

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

参数集

(All)

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

-DdosProtectionMode

用于公共 IP 地址的 DdosProtectionMode

参数属性

类型:	String
默认值:	None
接受的值:	VirtualNetworkInherited, Enabled, Disabled
支持通配符:	False
不显示:	False

参数集

(All)

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

-DdosProtectionPlanId

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

参数属性

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

参数集

(All)

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

-DefaultProfile

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

参数属性

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

参数集

(All)

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

-DomainNameLabel

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

参数属性

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

参数集

(All)

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

-DomainNameLabelScope

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

参数属性

类型:	Nullable<T>[PSDomainNameLabelScopeType]
默认值:	None
接受的值:	TenantReuse, SubscriptionReuse, ResourceGroupReuse, NoReuse
支持通配符:	False
不显示:	False

参数集

(All)

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

-EdgeZone

扩展位置的名称。

参数属性

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

参数集

(All)

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

-Force

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

参数属性

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

参数集

(All)

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

-IdleTimeoutInMinutes

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

参数属性

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

参数集

(All)

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

-IpAddress

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

参数属性

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

参数集

(All)

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

-IpAddressVersion

指定 IP 地址的版本。

参数属性

类型:	String
默认值:	None
接受的值:	IPv4, IPv6
支持通配符:	False
不显示:	False

参数集

(All)

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

-IpTag

IpTag 列表。

参数属性

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

参数集

(All)

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

-Location

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

参数属性

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

参数集

(All)

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

-Name

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

参数属性

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

参数集

(All)

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

-PublicIpPrefix

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

参数属性

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

参数集

(All)

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

-ResourceGroupName

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

参数属性

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

参数集

(All)

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

-ReverseFqdn

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

参数属性

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

参数集

(All)

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

-Sku

公共 IP Sku 名称。

参数属性

类型:	String
默认值:	None
接受的值:	Basic, Standard, StandardV2
支持通配符:	False
不显示:	False

参数集

(All)

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

-Tag

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

参数属性

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

参数集

(All)

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

-Tier

公共 IP SKU 层。

参数属性

类型:	String
默认值:	None
接受的值:	Regional, Global
支持通配符:	False
不显示:	False

参数集

(All)

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

-WhatIf

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

参数属性

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

参数集

(All)

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

-Zone

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

参数属性

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

参数集

(All)

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

CommonParameters

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

输出

PSPublicIpAddress

反馈

此页面是否有帮助？

通过

New-AzPublicIpAddress

语法

Default （默认值）

说明

示例

示例 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

参数属性

参数集