你当前正在访问 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

此命令将创建新的公共 IP 地址资源。为指向此资源的公共 IP 地址$dnsPrefix.$location.cloudapp.azure.com创建 DNS 记录。 公共 IP 地址将立即分配给此资源，因为 -AllocationMethod 被指定为“Static”。 如果指定为“动态”，则仅当启动（或创建）关联的资源（例如 VM 或负载均衡器）时，才会分配公共 IP 地址。 Iptag 用于指定与资源关联的标记。 可以使用 New-AzureRmPublicIpTag 指定 Iptag，并通过 -IpTags 作为输入传递。

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。

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases: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

-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

-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:List<T>[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:False
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

-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:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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