Remove-AzDnsRecordConfig

模組:
Az.Dns Module

從本機記錄集物件移除 DNS 記錄。

語法

A 

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

AAAA 

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

NS 

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

MX 

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

NAPTR 

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

PTR 

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

TXT 

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

SRV 

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

CNAME 

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

Caa 

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

DS 

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

TLSA 

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

Description

Remove-AzDnsRecordConfig Cmdlet 會從記錄集中移除網域名稱系統 （DNS） 記錄。 RecordSet 物件是離線物件，對它的更改不會改變 DNS 回應，直到你執行 Set-AzDnsRecordSet cmdlet 以持久化該變更到Microsoft Azure DNS 服務之後。 若要移除記錄，該記錄類型的所有欄位都必須完全相符。 您無法新增或移除 SOA 記錄。 建立 DNS 區域時會自動建立 SOA 記錄，並在刪除 DNS 區域時自動刪除。 您可以將 RecordSet 物件作為參數傳遞至此 Cmdlet，或使用管線運算子。

範例

範例 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 記錄集最多可以包含一筆記錄，所以結果是空的記錄集。

範例 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
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DS
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-CaaFlags

要新增的 CAA 記錄旗標。 必須是介於 0 到 255 之間的數字。

參數屬性

類型:Byte
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Caa
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-CaaTag

要新增之 CAA 記錄的標籤欄位。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Caa
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-CaaValue

要新增的 CAA 記錄的值欄位。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Caa
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-CertificateAssociationData

要移除之 TLSA 記錄的憑證關聯資料欄位。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

TLSA
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Cname

指定標準名稱 （CNAME） 記錄的網域名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CNAME
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Digest

要移除之 DS 記錄的摘要欄位。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DS
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-DigestType

要移除之 DS 記錄的摘要類型欄位。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DS
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Exchange

指定郵件交換 （MX） 記錄的郵件交換伺服器名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

MX
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Flags

要移除之 NAPTR 記錄的旗標值。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

NAPTR
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Ipv4Address

指定 A 記錄的 IPv4 位址。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

A
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Ipv6Address

指定 AAAA 記錄的 IPv6 位址。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

AAAA
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-KeyTag

要移除的 DS 記錄的索引鍵標籤欄位。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

DS
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-MatchingType

要移除之 TLSA 記錄的相符類型欄位。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

TLSA
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Nsdname

指定名稱伺服器 （NS） 記錄的名稱伺服器。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

NS
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Order

指定具名授權指標 （NAPTR） 記錄的順序。

參數屬性

類型:UInt16
預設值:None
支援萬用字元:False
不要顯示:False

參數集

NAPTR
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Port

指定服務 （SRV） 記錄的連接埠。

參數屬性

類型:UInt16
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SRV
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Preference

指定 MX/NAPTR 記錄的喜好設定。

參數屬性

類型:UInt16
預設值:None
支援萬用字元:False
不要顯示:False

參數集

MX
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
NAPTR
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Priority

指定 SRV 記錄的優先順序。

參數屬性

類型:UInt16
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SRV
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Ptrdname

指定指標 （PTR） 記錄的目標網域名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

PTR
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-RecordSet

指定包含要移除之記錄的 RecordSet 物件。

參數屬性

類型:DnsRecordSet
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Regexp

指定具名授權指標 （NAPTR） 記錄的規則運算式。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

NAPTR
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Replacement

指定具名授權指標 （NAPTR） 記錄的取代。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

NAPTR
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Selector

要移除之 TLSA 記錄的選取器欄位。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

TLSA
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Services

指定具名授權指標 （NAPTR） 記錄的服務。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

NAPTR
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Target

指定 SRV 記錄的目標。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SRV
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Usage

要移除之 TLSA 記錄的使用情形欄位。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

TLSA
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Value

指定 TXT 記錄的值。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

TXT
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Weight

指定 SRV 記錄的權重。

參數屬性

類型:UInt16
預設值:None
支援萬用字元:False
不要顯示:False

參數集

SRV
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

DnsRecordSet

String

UInt16

Byte

輸出

DnsRecordSet