Set-AzPublicIpAddress

パブリック IP アドレスを更新します。

構文

Default (既定)

Set-AzPublicIpAddress
    -PublicIpAddress <PSPublicIpAddress>
    [-DdosCustomPolicyId <String>]
    [-RemoveDdosCustomPolicy]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

説明

Set-AzPublicIpAddress コマンドレットは、パブリック 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 アドレス リソースを取得します。 2 番目のコマンドは、パブリック 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 アドレス リソースを取得します。 2 番目のコマンドは、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 アドレス リソースを取得します。 2 番目のコマンドは、DomainNameLabel プロパティを必要な dns プレフィックスに設定します。 Set-AzPublicIPAddress コマンドは、更新されたオブジェクトを使用してパブリック IP アドレス リソースを更新します。 DomainNameLabel と Fqdn は、想定どおりに変更されます。

例 4: DDoS カスタム ポリシーをサポートされているパブリック IP アドレスに関連付ける

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

Set-AzPublicIpAddress -PublicIpAddress $publicIp -DdosCustomPolicyId $ddosCustomPolicyId

最初のコマンドは、標準のパブリック IP アドレスを取得します。 2 番目のコマンドは、DDoS カスタム ポリシーをパブリック IP アドレスに関連付けます。 サービスは、パブリック IP アドレスにサポートされている添付ファイル (ネットワーク インターフェイスなど) があることを検証します。

例 5: DDoS カスタム ポリシーの関連付けを削除する

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

Set-AzPublicIpAddress -PublicIpAddress $publicIp -RemoveDdosCustomPolicy

最初のコマンドは、パブリック IP アドレスを取得します。 2 番目のコマンドは、DDoS カスタム ポリシーの関連付けを削除します。

パラメーター

-AcquirePolicyToken

このリソース操作のAzure Policy トークンを自動的に取得します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AsJob

バックグラウンドでコマンドレットを実行する

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ChangeReference

このリソース操作の変更参照リソース ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DdosCustomPolicyId

サポートされているパブリック IP アドレスに関連付ける DDoS カスタム ポリシー ID。 サービスは、パブリック IP アドレスの添付ファイルが DDoS カスタム ポリシーをサポートしているかどうかを検証します。 このパラメーターは、 -RemoveDdosCustomPolicyでは使用できません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
エイリアス:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PublicIpAddress

パブリック IP アドレスを設定する必要がある状態を表すパブリック IP アドレス オブジェクトを指定します。

パラメーターのプロパティ

型:PSPublicIpAddress
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RemoveDdosCustomPolicy

パブリック IP アドレスから DDoS カスタム ポリシーの関連付けを削除します。 このパラメーターは、 -DdosCustomPolicyIdでは使用できません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

入力

PSPublicIpAddress

出力

PSPublicIpAddress