次の方法で共有

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

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Overwrite

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

passthru

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RecordSet

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

型:DnsRecordSet
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RecordType

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

  • ある
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • TXT SOA レコードは、ゾーンが削除されると自動的に削除されます。 SOA レコードを手動で削除することはできません。
型:RecordType
指定可能な値:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Zone

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

型:DnsZone
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ZoneName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

RecordType

String

DnsZone

DnsRecordSet

出力

Boolean

メモ

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