Remove-AzDnsRecordSet
構文
Fields
Remove-AzDnsRecordSet
-Name <String>
-RecordType <RecordType>
-ZoneName <String>
-ResourceGroupName <String>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Mixed
Remove-AzDnsRecordSet
-Name <String>
-RecordType <RecordType>
-Zone <DnsZone>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Object
Remove-AzDnsRecordSet
-RecordSet <DnsRecordSet>
[-Overwrite]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-AzDnsRecordSet コマンドレットは、指定したゾーンから指定したレコード セットを削除します。
ゾーンの頂点に自動的に作成される SOA またはネーム サーバー (NS) レコードは削除できません。
パイプライン演算子を使用するか、パラメーターとして RecordSet オブジェクトをこのコマンドレットに渡すことができます。
RecordSet オブジェクトを使用せずに名前と種類でレコード セットを識別するには、パイプライン演算子またはパラメーターとして DnsZone オブジェクトとしてゾーンをこのコマンドレットに渡す必要があります。または、ZoneName パラメーターと ResourceGroupName パラメーターを指定することもできます。
Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。
RecordSet オブジェクトを使用してレコード セットを指定する場合、ローカル RecordSet オブジェクトが取得されてから Azure DNS でレコード セットが変更された場合、 レコード セット は削除されません。
これにより、同時変更の保護が提供されます。
これを抑制する場合は、 Overwrite パラメーターを使用します。このパラメーターを使用すると、同時変更に関係なくレコード セットが削除されます。
例
例 1: レコード セットを削除する
$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet
最初のコマンドは、指定したレコード セットを取得し、$RecordSet変数に格納します。2 番目のコマンドは、$RecordSetのレコード セットを削除します。
例 2: レコード・セットを削除し、すべての確認を抑制する
$RecordSet = Get-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -RecordSet $RecordSet -Confirm:$False -Overwrite
# Alternatively, the record set can be removed as follows. In this case,
# because the record set is specified by name rather than by object, the
# Overwrite parameter is not applicable.
Remove-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False
最初のコマンドは、指定されたレコード セットを取得します。
2 番目のコマンドは、その間にレコード セットが変更された場合でも、レコード セットを削除します。
確認プロンプトは表示されません。
パラメーター
-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
削除する RecordSet の名前を指定します。
レコード セットを名前で指定する場合は、ゾーン パラメーターまたは ZoneName パラメーターと ResourceGroupName パラメーターを 使用して DNS ゾーンを指定する必要があります。
または、RecordSet パラメーターを使用して渡される RecordSet オブジェクトを使用してレコード セットを指定することもできます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Fields
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
Mixed
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Overwrite
RecordSet オブジェクトを使用してレコード セットを指定する場合、ローカル RecordSet オブジェクトが取得されてから Azure DNS でレコード セットが変更された場合、 レコード セット は削除されません。
これにより、同時変更の保護が提供されます。
これは、同時変更に関係なくレコード セットを削除する Overwrite パラメーターを使用して抑制できます。
パラメーターのプロパティ
パラメーター セット
Object
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PassThru
Passthru
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-RecordSet
削除する RecordSet オブジェクトを指定します。
または、 Name パラメーターと Zone パラメーターを使用するか、 Name 、 ZoneName 、 および ResourceGroupName パラメーターを使用して、レコード セットを指定することもできます。
パラメーターのプロパティ
パラメーター セット
Object
配置: Named
必須: True
パイプラインからの値: True
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-RecordType
DNS レコードの種類を指定します。
有効な値は次のとおりです。
A
AAAA
CNAME
MX
NAPTR
NS
PTR
SRV
TXT SOA レコードは、ゾーンが削除されると自動的に削除されます。
SOA レコードを手動で削除することはできません。
パラメーターのプロパティ
型: RecordType
規定値: None
指定可能な値: A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Fields
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
Mixed
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
-ResourceGroupName
削除する RecordSet を含む DNS ゾーンを含むリソース グループを指定します。
このパラメーターは、 Name パラメーターと ZoneName パラメーターを使用してレコード セットと DNS ゾーンが指定されている場合にのみ適用されます。
または、 RecordSet パラメーターまたは Name パラメーターと Zone パラメーターを使用してレコード セットを指定することもできます。
パラメーターのプロパティ
型: 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
削除する RecordSet を含む DNS ゾーンを指定します。
このパラメーターは、 Name パラメーターを使用してレコード セットを指定する場合にのみ適用されます。
または、 RecordSet パラメーターまたは Name 、 ZoneName 、 および ResourceGroupName パラメーターを使用してレコード セットを指定することもできます。
パラメーターのプロパティ
型: DnsZone
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Mixed
配置: Named
必須: True
パイプラインからの値: True
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ZoneName
削除する RecordSet を含むゾーンの名前を指定します。
Name パラメーターと ResourceGroupName パラメーターも指定する必要があります。
または、 RecordSet パラメーターまたは Name パラメーターと Zone パラメーターを使用して、レコード セットを指定することもできます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
Fields
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: True
残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
出力
メモ
Confirm パラメーターを使用して、このコマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。
既定では、$ConfirmPreference Windows PowerShell 変数の値が Medium 以下の場合は、確認を求めるメッセージが表示されます。
Confirm または Confirm:$True を指定した場合、このコマンドレットは実行前に確認を求められます。
Confirm:$False を指定した場合、コマンドレットは確認を求めません。