通过

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

Set-AzPublicIpAddress

  • 参考
模块:
Az.Network

更新公共 IP 地址。

语法

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

-DefaultProfile

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

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

-PublicIpAddress

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

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

输入

PSPublicIpAddress

输出

PSPublicIpAddress