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

New-AzureRmPublicIpAddress

参考

模块:: AzureRM.Network

创建公共 IP 地址。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmPublicIpAddress
   [-Name <String>]
   -ResourceGroupName <String>
   [-Location <String>]
   [-Sku <String>]
   -AllocationMethod <String>
   [-IpAddressVersion <String>]
   [-DomainNameLabel <String>]
   [-IpTag <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag]>]
   [-PublicIpPrefix <Microsoft.Azure.Commands.Network.Models.PSPublicIpPrefix>]
   [-ReverseFqdn <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

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

示例

1：创建新的公共 IP 地址

$publicIp = New-AzureRmPublicIpAddress -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-AzureRmPublicIpAddress -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-AzureRmPublicIpTag -IpTagType "FirstPartyUsage" -Tag "/Sql"
$publicIp = New-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName -AllocationMethod Static -DomainNameLabel $dnsPrefix -Location $location -IpTags ipTag

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

$publicIp = New-AzureRmPublicIpAddress -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。

参数

-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

-DefaultProfile

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

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

-DomainNameLabel

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

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

-Force

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

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

-IdleTimeoutInMinutes

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

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

-IpAddressVersion

指定 IP 地址的版本。

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

-IpTag

IpTag 列表。

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

-Location

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

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

-WhatIf

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

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

-Zone

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

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

输入

String

List<T>[[Microsoft.Azure.Commands.Network.Models.PSPublicIpTag, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Int32

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Hashtable

输出

PSPublicIpAddress

通过

New-AzureRmPublicIpAddress

语法

说明

示例

1：创建新的公共 IP 地址

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

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

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

参数

-AllocationMethod

-AsJob

-Confirm

-DefaultProfile

-DomainNameLabel

-Force

-IdleTimeoutInMinutes

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-WhatIf

-Zone

输入

输出

其他资源

通过

New-AzureRmPublicIpAddress

语法

说明

示例

1：创建新的公共 IP 地址

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

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

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

参数

-AllocationMethod

-AsJob

-Confirm

-DefaultProfile

-DomainNameLabel

-Force

-IdleTimeoutInMinutes

-IpAddressVersion

-IpTag

-Location

-Name

-PublicIpPrefix

-ResourceGroupName

-ReverseFqdn

-Sku

-Tag

-WhatIf

-Zone

输入

输出

相关链接

其他资源