Set-AzPrivateDnsVirtualNetworkLink
プライベート ゾーンとリソース グループに関連付けられている仮想ネットワーク リンクを更新または設定します。
構文
Fields (既定)
Set-AzPrivateDnsVirtualNetworkLink
-ResourceGroupName <String>
-ZoneName <String>
-Name <String>
[-IsRegistrationEnabled <Boolean>]
[-ResolutionPolicy <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Object
Set-AzPrivateDnsVirtualNetworkLink
-InputObject <PSPrivateDnsVirtualNetworkLink>
[-IsRegistrationEnabled <Boolean>]
[-ResolutionPolicy <String>]
[-Tag <Hashtable>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceId
Set-AzPrivateDnsVirtualNetworkLink
-ResourceId <String>
[-IsRegistrationEnabled <Boolean>]
[-ResolutionPolicy <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-AzPrivateDnsVirtualNetworkLink コマンドレットは、指定されたリソース グループのゾーンに関連付けられているリンクを更新します。
PSPrivateDnsVirtualNetworkLink オブジェクトは、Link パラメーターを使用するか、パイプライン演算子を使用して渡すか、または名前 ZoneName パラメーターと ResourceGroupName パラメーターを指定することもできます。
Confirm パラメーターと $ConfirmPreference Windows PowerShell 変数を使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。
PSPrivateDnsVirtualNetworkLink オブジェクトを使用してゾーンを指定する場合 (パイプラインまたは Link パラメーター) は、ローカル PSPrivateDnsVirtualNetworkLink オブジェクトが取得されてからAzure DNSで変更された場合、リンクは更新されません。 これにより、同時リンクの変更に対する保護が提供されます。 これは、同時変更に関係なくリンクを更新する Overwrite パラメーターを使用して抑制できます。
例
例 1: リンクを設定する
Set-AzPrivateDnsVirtualNetworkLink -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Name "mylink" -Tag @{} -IsRegistrationEnabled $true
Name : mylink
ResourceId : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.N
etwork/privateDnsZones/myzone.com/virtualNetworkLinks/mylink
ResourceGroupName : MyResourceGroup
ZoneName : myzone.com
VirtualNetworkId : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.N
etwork/virtualNetworks/myvirtualnetwork
Location :
Etag : "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Tags : {}
RegistrationEnabled : True
ResolutionPolicy : Default
VirtualNetworkLinkState : Completed
ProvisioningState : Succeeded
このコマンドは、MyResourceGroup という名前のリソース グループから myzone.com という名前のゾーンにリンクされている mylink という名前のリンクに対して IsRegistrationEnabled を True に設定します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
設定する仮想ネットワーク リンク オブジェクト。
Object
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IsRegistrationEnabled
仮想ネットワーク リンクで登録が有効になっているかどうかを表すブール値。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
このコマンドレットが削除するリンクの名前を指定します。
ResourceGroupName パラメーターと ZoneName パラメーターも指定する必要があります。
または、 リンク パラメーターを使用してプライベート DNS リンクを指定することもできます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Fields
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Overwrite
PSPrivateDnsVirtualNetworkLink オブジェクトを使用してリンクを指定する場合 (パイプラインまたは Linkパラメーター)、ローカル PSPrivateDnsVirtualNetworkLink オブジェクトが取得されてからAzure DNSで変更された場合、リンクは削除されません。
これにより、同時リンクの変更に対する保護が提供されます。
これは、同時変更に関係なくリンクを削除する Overwrite パラメーターを使用して抑制できます。
パラメーターのプロパティ
パラメーター セット
Object
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResolutionPolicy
仮想ネットワーク リンクの解決ポリシーを指定します
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResourceGroupName
削除するリンクを含むリソース グループの名前を指定します。
ZoneName パラメーターと Name パラメーターも指定する必要があります。
または、パイプラインまたは Link パラメーターを使用して渡される PSPrivateDnsVirtualNetworkLink オブジェクトを使用して、仮想ネットワーク リンク を指定することもできます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Fields
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResourceId
Private DNS ゾーン ResourceID。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ResourceId
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Tag
リソース タグを表すハッシュ テーブル。
パラメーターのプロパティ
| 型: | Hashtable
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ZoneName
このコマンドレットが削除する DNS ゾーンの名前を指定します。
Name パラメーターと ResourceGroupName パラメーターも指定する必要があります。
または、 リンク パラメーターを使用してプライベート DNS リンクを指定することもできます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Fields
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力