次の方法で共有


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

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

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

型: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

削除する 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 パラメーターを使用して抑制できます。

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

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

パラメーター セット

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

-PassThru

Passthru

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

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

パラメーター セット

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

-RecordSet

削除する RecordSet オブジェクトを指定します。 または、 Name パラメーターと Zone パラメーターを使用するか、 NameZoneNameおよび ResourceGroupName パラメーターを使用して、レコード セットを指定することもできます。

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

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

パラメーター セット

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 パラメーターまたは NameZoneNameおよび 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を参照してください。

入力

RecordType

String

DnsZone

DnsRecordSet

出力

Boolean

メモ

Confirm パラメーターを使用して、このコマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 既定では、$ConfirmPreference Windows PowerShell 変数の値が Medium 以下の場合は、確認を求めるメッセージが表示されます。 Confirm または Confirm:$True を指定した場合、このコマンドレットは実行前に確認を求められます。 Confirm:$False を指定した場合、コマンドレットは確認を求めません。