Remove-AzDnsRecordConfig

モジュール:

Az.Dns

ローカル レコード セット オブジェクトから DNS レコードを削除します。

構文

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv4Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv6Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Nsdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Exchange <String>
      -Preference <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ptrdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Value <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Priority <UInt16>
      -Target <String>
      -Port <UInt16>
      -Weight <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Cname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -CaaFlags <Byte>
      -CaaTag <String>
      -CaaValue <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -KeyTag <Int32>
      -Algorithm <Int32>
      -DigestType <Int32>
      -Digest <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Usage <Int32>
      -Selector <Int32>
      -MatchingType <Int32>
      -CertificateAssociationData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Order <UInt16>
      -Preference <UInt16>
      -Flags <String>
      -Services <String>
      -Regexp <String>
      -Replacement <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

説明

Remove-AzDnsRecordConfig コマンドレットは、ドメイン ネーム システム (DNS) レコードをレコード セットから削除します。 RecordSet オブジェクトはオフライン オブジェクトであり、Set-AzDnsRecordSet コマンドレットを実行して変更を Microsoft Azure DNS サービスに永続化するまで、そのオブジェクトに対する変更は DNS 応答を変更しません。 レコードを削除するには、そのレコードの種類のすべてのフィールドが完全に一致する必要があります。 SOA レコードを追加または削除することはできません。 SOA レコードは、DNS ゾーンが作成されるときに自動的に作成され、DNS ゾーンが削除されると自動的に削除されます。 パラメーターとして、またはパイプライン演算子を使用して、RecordSet オブジェクトをこのコマンドレットに渡すことができます。

例

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

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから A レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 2: レコード セットから AAAA レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから AAAA レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 3: レコード セットから CNAME レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから CNAME レコードを削除します。 CNAME レコード セットには最大 1 つのレコードを含めることができるため、結果は空のレコード セットになります。

例 4: レコード セットから MX レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから MX レコードを削除します。 レコード名 "@" は、ゾーンの頂点にあるレコード セットを示します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 5: レコード・セットから NS レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Nsdname "ns1.myzone.com" | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから NS レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 6: レコード セットから PTR レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName 3.2.1.in-addr.arpa
Remove-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName "3.2.1.in-addr.arpa" | Remove-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから PTR レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 7: レコード・セットから SRV レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから SRV レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 8: レコード セットから TXT レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Value "This is a TXT Record"  | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから TXT レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 9: レコード・セットから DS レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから DS レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 10: レコード セットから TLSA レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

次の使用例は、既存のレコード セットから TLSA レコードを削除します。 これがレコード セット内の唯一のレコードである場合、結果は空のレコード セットになります。 レコード セットを完全に削除するには、「Remove-AzDnsRecordSet」を参照してください。

例 11: レコード セットから NAPTR レコードを削除する

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Order 100 -Preference 100 -Flags "s" -Services "http" -Regexp "" -Replacement "www.contoso.com"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Order 100 -Preference 100 -Flags "s" -Services "http" -Regexp "" -Replacement "www.contoso.com"  | Set-AzDnsRecordSet

パラメーター

-Algorithm

削除する DS レコードのアルゴリズム フィールド。

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

-CaaFlags

追加する CAA レコードのフラグ。 0 ~ 255 の数値を指定する必要があります。

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

-CaaTag

追加する CAA レコードのタグ フィールド。

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

-CaaValue

追加する CAA レコードの値フィールド。

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

-CertificateAssociationData

削除する TLSA レコードの証明書関連付けデータ フィールド。

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

-Cname

正規名 (CNAME) レコードのドメイン名を指定します。

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

-DefaultProfile

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

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

-Digest

削除する DS レコードのダイジェスト フィールド。

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

-DigestType

削除する DS レコードのダイジェストの種類フィールド。

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

-Exchange

メール交換 (MX) レコードのメール交換サーバー名を指定します。

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

-Ipv4Address

A レコードの IPv4 アドレスを指定します。

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

-Ipv6Address

AAAA レコードの IPv6 アドレスを指定します。

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

-KeyTag

削除する DS レコードのキー タグ フィールド。

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

-MatchingType

削除する TLSA レコードの一致する型フィールド。

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

-Nsdname

ネーム サーバー (NS) レコードのネーム サーバーを指定します。

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

-Order

名前付き権限ポインター (NAPTR) レコードの順序を指定します。

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

-Port

サービス (SRV) レコードのポートを指定します。

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

-Preference

MX/NAPTR レコードの基本設定を指定します。

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

-Priority

SRV レコードの優先順位を指定します。

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

-Ptrdname

ポインター (PTR) レコードのターゲット ドメイン名を指定します。

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

-RecordSet

削除するレコードを含む RecordSet オブジェクトを指定します。

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

-Regexp

名前付き権限ポインター (NAPTR) レコードの正規表現を指定します。

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

-Replacement

名前付き権限ポインター (NAPTR) レコードの置換を指定します。

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

-Selector

削除する TLSA レコードのセレクター フィールド。

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

-Services

名前付き権限ポインター (NAPTR) レコードのサービスを指定します。

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

-Target

SRV レコードのターゲットを指定します。

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

-Usage

削除する TLSA レコードの使用状況フィールド。

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

-Value

TXT レコードの値を指定します。

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

-Weight

SRV レコードの重みを指定します。

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

入力

DnsRecordSet

String

UInt16

Byte

出力

DnsRecordSet

関連リンク

• Add-AzDnsRecordConfig
• Get-AzDnsRecordSet
• Set-AzDnsRecordSet