Set-AzPrivateDnsVirtualNetworkLink

モジュール:

Az.PrivateDns

更新/プライベート ゾーンとリソース グループに関連付けられた仮想ネットワーク リンクを設定します。

構文

Set-AzPrivateDnsVirtualNetworkLink
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   [-IsRegistrationEnabled <Boolean>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzPrivateDnsVirtualNetworkLink
   -InputObject <PSPrivateDnsVirtualNetworkLink>
   [-IsRegistrationEnabled <Boolean>]
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzPrivateDnsVirtualNetworkLink
   -ResourceId <String>
   [-IsRegistrationEnabled <Boolean>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzPrivateDnsVirtualNetworkLink コマンドレットは、指定されたリソース グループのゾーンに関連付けられているリンクを更新します。 PSPrivateDnsVirtualNetworkLink オブジェクトは、Link パラメーターを使用するか、パイプライン演算子を使用して渡すか、または名前ZoneName パラメーターと ResourceGroupName パラメーターを指定することもできます。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 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
VirtualNetworkLinkState : Completed
ProvisioningState       : Succeeded

このコマンドは、MyResourceGroup という名前のリソース グループから myzone.com という名前のゾーンにリンクされている mylink という名前のリンクに対して IsRegistrationEnabled を True に設定します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

設定する仮想ネットワーク リンク オブジェクト。

Type:	PSPrivateDnsVirtualNetworkLink
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IsRegistrationEnabled

仮想ネットワーク リンクで登録が有効になっているかどうかを表すブール値。

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

このコマンドレットが削除するリンクの名前を指定します。 ResourceGroupName パラメーターと ZoneName パラメーターも指定する必要があります。 または、リンク パラメーターを使用してプライベート DNS リンクを指定することもできます。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Overwrite

PSPrivateDnsVirtualNetworkLink オブジェクト (パイプラインまたは Link パラメーターを使用して渡されます) を使用してリンクを指定する場合、ローカル PSPrivateDnsVirtualNetworkLink オブジェクトが取得されてから Azure DNS でリンクが変更されている場合、リンクは削除されません。 これにより、同時リンクの変更に対する保護が提供されます。 これは、同時変更に関係なくリンクを 削除する Overwrite パラメーターを使用して抑制できます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

削除するリンクを含むリソース グループの名前を指定します。 ZoneName パラメーターと Name パラメーターも指定する必要があります。 または、パイプラインまたは Link パラメーターを使用して渡される PSPrivateDnsVirtualNetworkLink オブジェクトを使用して、仮想ネットワーク リンクを指定することもできます。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

プライベート DNS ゾーン リソース ID。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

リソース タグを表すハッシュ テーブル。

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ZoneName

このコマンドレットが削除する DNS ゾーンの名前を指定します。 Name パラメーターと ResourceGroupName パラメーターも指定する必要があります。 または、リンク パラメーターを使用してプライベート DNS リンクを指定することもできます。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

入力

PSPrivateDnsVirtualNetworkLink

String

出力

PSPrivateDnsVirtualNetworkLink

関連リンク

• Get-AzPrivateDnsVirtualNetworkLink
• New-AzPrivateDnsVirtualNetworkLink
• Set-AzPrivateDnsVirtualNetworkLink