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

Set-AzPublicIpAddress

更新公共 IP 地址。

语法

Default (默认值)

Set-AzPublicIpAddress
    -PublicIpAddress <PSPublicIpAddress>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

Set-AzPublicIpAddress cmdlet 更新公共 IP 地址。

示例

示例 1:更改公共 IP 地址的分配方法

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.PublicIpAllocationMethod = "Static"

Set-AzPublicIpAddress -PublicIpAddress $publicIp

Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

第一个命令获取资源组$rgName中名称$publicIPName的公共 IP 地址资源。 第二个命令将公共 IP 地址对象的分配方法设置为“Static”。 Set-AzPublicIPAddress 命令使用更新的对象更新公共 IP 地址资源,并将分配方法修改为“Static”。 将立即分配公共 IP 地址。

示例 2:添加公共 IP 地址的 DNS 域标签

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings = @{"DomainNameLabel" = "newdnsprefix"}

Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

第一个命令获取资源组$rgName中名称$publicIPName的公共 IP 地址资源。 Second 命令将 DomainNameLabel 属性设置为所需的 dns 前缀。 Set-AzPublicIPAddress 命令使用更新的对象更新公共 IP 地址资源。 DomainNameLabel 和 Fqdn 按预期修改。

示例 3:更改公共 IP 地址的 DNS 域标签

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

$publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"

Set-AzPublicIpAddress -PublicIpAddress $publicIp

$publicIp = Get-AzPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName

第一个命令获取资源组$rgName中名称$publicIPName的公共 IP 地址资源。 Second 命令将 DomainNameLabel 属性设置为所需的 dns 前缀。 Set-AzPublicIPAddress 命令使用更新的对象更新公共 IP 地址资源。 DomainNameLabel 和 Fqdn 按预期修改。

参数

-AsJob

在后台运行 cmdlet

参数属性

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

参数集

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

-DefaultProfile

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

参数属性

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

参数集

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

-PublicIpAddress

指定一个公共 IP 地址对象,该对象表示应设置公共 IP 地址的状态。

参数属性

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

参数集

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

CommonParameters

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

输入

PSPublicIpAddress

输出

PSPublicIpAddress