Set-AzureRmPublicIpAddress
設定公用IP位址的目標狀態。
警告
自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源 。
語法
Set-AzureRmPublicIpAddress
-PublicIpAddress <PSPublicIpAddress>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Set-AzureRmPublicIpAddress Cmdlet 會設定公用 IP 位址的目標狀態。
範例
1:變更公用IP位址的配置方法
PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
PS C:\> $publicIp.PublicIpAllocationMethod = "Static"
PS C:\> Set-AzureRmPublicIpAddress -PublicIpAddress $publicIp
PS C:\> Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
第一個命令會取得資源群組中名稱為$publicIPName的公用IP位址資源$rgName。 第二個命令會將公用IP位址物件的配置方法設定為 「Static」。。 Set-AzureRmPublicIPAddress 命令會使用更新的物件來更新公用 IP 位址資源,並將配置方法修改為 'Static'。 公用IP位址會立即配置。
2:變更公用IP位址的 DNS 網域標籤
PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
PS C:\> $publicIp.DnsSettings.DomainNameLabel = "newdnsprefix"
PS C:\> Set-AzureRmPublicIpAddress -PublicIpAddress $publicIp
PS C:\> $publicIp = Get-AzureRmPublicIpAddress -Name $publicIpName -ResourceGroupName $rgName
第一個命令會取得資源群組中名稱為$publicIPName的公用IP位址資源$rgName。 第二個命令會將 DomainNameLabel 屬性設定為必要的 dns 前置詞。 Set-AzureRmPublicIPAddress 命令會使用更新的物件來更新公用 IP 位址資源。 DomainNameLabel & Fqdn 會如預期般修改。
參數
-AsJob
在背景執行 Cmdlet
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PublicIpAddress
指定 PublicIpAddress 物件,代表應該設定公用 IP 位址的目標狀態。
類型: | PSPublicIpAddress |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
輸入
參數:PublicIpAddress (ByValue)