Remove-AzDnsRecordSet

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

レコード セットを削除します。

構文

Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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

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

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

削除する RecordSet の名前を指定します。 レコード セットを名前で指定する場合は、ゾーン パラメーターまたは ZoneName パラメーターと ResourceGroupName パラメーターを使用して DNS ゾーンを指定する必要があります。 または、RecordSet パラメーターを使用して渡される RecordSet オブジェクトを使用してレコード セットを指定することもできます。

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

-Overwrite

RecordSet オブジェクトを使用してレコード セットを指定する場合、ローカル RecordSet オブジェクトが取得されてから Azure DNS でレコード セットが変更された場合、レコード セットは削除されません。 これにより、同時変更の保護が提供されます。 これは、同時変更に関係なくレコード セットを 削除する Overwrite パラメーターを使用して抑制できます。

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

-PassThru

Passthru

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

-RecordSet

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

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

-RecordType

DNS レコードの種類を指定します。 有効な値は次の通りです。

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • TXT SOA レコードは、ゾーンが削除されると自動的に削除されます。 SOA レコードを手動で削除することはできません。
Type:RecordType
Accepted values:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

削除する RecordSet を含む DNS ゾーンを含むリソース グループを指定します。 このパラメーターは、Nameパラメーターと ZoneName パラメーターを使用してレコード セットと DNS ゾーンが指定されている場合にのみ適用されます。 または、RecordSet パラメーターまたは Name パラメーターと Zone パラメーターを使用してレコード セットを指定することもできます。

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

-Zone

削除する RecordSet を含む DNS ゾーンを指定します。 このパラメーターは、Name パラメーターを使用してレコード セットを指定する場合にのみ適用されます。 または、RecordSet パラメーターまたは Name、ZoneName、および ResourceGroupName パラメーターを使用してレコード セットを指定することもできます。

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

-ZoneName

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

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

入力

RecordType

String

DnsZone

DnsRecordSet

出力

Boolean

メモ

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