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
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(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 パラメーターを使用して抑制できます。
パラメーターのプロパティ
パラメーター セット
Object
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PassThru
Passthru
パラメーターのプロパティ
パラメーター セット
(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を参照してください。
出力
メモ
DNS ゾーンの削除による影響が大きい可能性があるため、既定では、このコマンドレットは、$ConfirmPreference Windows PowerShell 変数に None 以外の値があるかどうかを確認するメッセージを表示します。
Confirm または Confirm:$True を指定した場合、このコマンドレットは実行前に確認を求められます。
Confirm:$False を指定した場合、コマンドレットは確認を求めません。