次の方法で共有


Remove-AzDnsZone

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

構文

Fields

Remove-AzDnsZone
    -Name <String>
    -ResourceGroupName <String>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object

Remove-AzDnsZone
    -Zone <DnsZone>
    [-Overwrite]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

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

例 1: ゾーンを削除する

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

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

パラメーター

-Confirm

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

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

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

パラメーター セット

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

-DefaultProfile

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

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

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

パラメーター セット

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

-Name

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

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

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

パラメーター セット

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

-Overwrite

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

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

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

パラメーター セット

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

-PassThru

Passthru

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

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

パラメーター セット

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

-ResourceGroupName

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

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

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

パラメーター セット

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

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

-Zone

削除する DNS ゾーンを指定します。 渡された DnsZone オブジェクトは、パイプラインを介して渡すこともできます。 または、 ZoneName パラメーターと ResourceGroupName パラメーターを使用して、削除する DNS ゾーンを指定することもできます。

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

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

パラメーター セット

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

CommonParameters

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

入力

String

DnsZone

出力

Boolean

メモ

DNS ゾーンの削除による影響が大きい可能性があるため、既定では、このコマンドレットは、$ConfirmPreference Windows PowerShell 変数に None 以外の値があるかどうかを確認するメッセージを表示します。 Confirm または Confirm:$True を指定した場合、このコマンドレットは実行前に確認を求められます。 Confirm:$False を指定した場合、コマンドレットは確認を求めません。