次の方法で共有

Remove-AzPrivateDnsRecordSet

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

プライベート DNS ゾーンからレコード セットを削除します。

構文

Remove-AzPrivateDnsRecordSet
      -ResourceGroupName <String>
      -ZoneName <String>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -Zone <PSPrivateDnsZone>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -RecordSet <PSPrivateDnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-AzPrivateDnsRecordSet コマンドレットは、指定したゾーンから指定したレコード セットを削除します。 プライベート ゾーンの頂点で自動的に作成される SOA レコードは削除できません。 このコマンドレットに RecordSet オブジェクトを渡すには、パイプライン演算子を使用するか、パラメーターとして、または ResourceId として渡します。 RecordSet オブジェクトを使用せずに名前と種類でレコード セットを識別するには、パイプライン演算子またはパラメーターを使用して PSPrivateDnsZone オブジェクトとしてゾーンをこのコマンドレットに渡す必要があります。または、ZoneName パラメーターと ResourceGroupName パラメーターを指定することもできます。 Confirm パラメーターと Windows PowerShell 変数$ConfirmPreference使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 RecordSet オブジェクトを使用してレコード セットを指定する場合、ローカル RecordSet オブジェクトが取得されてから Azure プライベート DNS でレコード セットが変更された場合、レコード セットは削除されません。 これにより、同時変更の保護が提供されます。 これを抑制する場合は、Overwrite パラメーターを使用します。このパラメーターを使用すると、同時変更に関係なくレコード セットが削除されます。

例

例 1: レコード セットを削除する

$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -RecordSet $RecordSet

最初のコマンドは、指定したレコード セットを取得し、$RecordSet変数に格納します。2 番目のコマンドは、$RecordSetのレコード セットを削除します。

例 2: レコード・セットを削除し、すべての確認を抑制する

$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False

最初のコマンドは、指定されたレコード セットを取得します。 2 番目のコマンドは、その間にレコード セットが変更された場合でも、レコード セットを削除します。 確認プロンプトは表示されません。

パラメーター

-Confirm

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

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

-DefaultProfile

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

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

-Name

レコード セット内のレコードの名前 (ゾーンの名前を基準とし、終了ドットなし)。

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

-Overwrite

オプティミスティック コンカレンシー チェックには、RecordSet パラメーターの ETag フィールドを使用しないでください。

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

-PassThru

パイプラインの下にプライベート ゾーンを削除する操作の結果 (ブール値) を渡すために使用されます。

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

-RecordSet

レコードを追加するレコード セット。

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

-RecordType

レコード セット内のプライベート DNS レコードの種類。

型:RecordType
指定可能な値:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResourceGroupName

ゾーンが属するリソース グループ。

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

-ResourceId

プライベート DNS RecordSet ResourceID。

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

-WhatIf

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

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

-Zone

レコード セットを作成するゾーンを表す PrivateDnsZone オブジェクト。

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

-ZoneName

レコード セットが存在するゾーン (終了ドットなし)。

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

入力

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

出力

Boolean