Share via

Remove-AzPrivateDnsZone

  • リファレンス
モジュール:
Az.PrivateDns

リソース グループからプライベート DNS ゾーンを削除します。

構文

Remove-AzPrivateDnsZone
      -ResourceGroupName <String>
      -Name <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -PrivateZone <PSPrivateDnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-AzPrivateDnsZone コマンドレットは、指定されたリソース グループからプライベート Doメイン ネーム システム (DNS) ゾーンを完全に削除します。 ゾーンに含まれるすべてのレコード セットも削除されます。 PrivateZone パラメーターを使用するか、パイプライン演算子を使用して PrivateDnsZone オブジェクトを渡すか、または Name パラメーターと ResourceGroupName パラメーターを指定することもできます。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 PrivateDnsZone オブジェクト (パイプラインまたはゾーン パラメーターを使用して渡されます) を使用してゾーンを指定する場合、ローカル PrivateDnsZone オブジェクトが取得されてから Azure DNS で変更されている場合、ゾーンは削除されません (DNS ゾーン リソースに対する直接の操作のみが変更としてカウントされ、ゾーン内のレコード セットに対する操作は削除されません)。 これにより、同時ゾーンの変更に対する保護が提供されます。 これは、同時変更に関係なくゾーンを 削除する Overwrite パラメーターを使用して抑制できます。

例

例 1: プライベート ゾーンを削除する

Remove-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

このコマンドは、myResourceGroup という名前のリソース グループから myzone.com という名前のゾーンを削除します。

パラメーター

-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

-Name

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

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

-Overwrite

PrivateDnsZone オブジェクト (パイプラインまたはゾーン パラメーターを使用して渡されます) を使用してゾーンを指定する場合、ローカル PrivateDnsZone オブジェクトが取得されてから Azure DNS で変更されている場合、ゾーンは削除されません (DNS ゾーン リソースに対する直接の操作のみが変更としてカウントされ、ゾーン内のレコード セットに対する操作は削除されません)。 これにより、同時ゾーンの変更に対する保護が提供されます。 これは、同時変更に関係なくゾーンを 削除する Overwrite パラメーターを使用して抑制できます。

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

-PassThru

パイプラインの下にプライベート ゾーンを削除する操作の結果 (ブール値) を渡すために使用されます。

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

-PrivateZone

削除するプライベート ゾーン オブジェクト。

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

-ResourceGroupName

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

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

-WhatIf

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

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

入力

PSPrivateDnsZone

String

出力

Boolean