Add-AzDnsRecordConfig

將 DNS 記錄新增至本機記錄集物件。

Syntax

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Ipv4Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Ipv6Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Nsdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Exchange <String>
   -Preference <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Ptrdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Value <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Priority <UInt16>
   -Target <String>
   -Port <UInt16>
   -Weight <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Cname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -CaaFlags <Byte>
   -CaaTag <String>
   -CaaValue <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -KeyTag <Int32>
   -Algorithm <Int32>
   -DigestType <Int32>
   -Digest <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Usage <Int32>
   -Selector <Int32>
   -MatchingType <Int32>
   -CertificateAssociationData <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Add-AzDnsRecordConfig Cmdlet 會將域名系統 (DNS) 記錄新增至 RecordSet 物件。 RecordSet 對像是離線物件,而且在您執行 Set-AzDnsRecordSet Cmdlet 以將變更保存到 Microsoft Azure DNS 服務之前,才會變更 DNS 回應。 SOA 記錄會在建立 DNS 區域時建立,並在刪除 DNS 區域時移除。 您無法新增或移除SOA記錄,但可以編輯它們。 您可以使用管線運算符, 將 RecordSet 對象傳遞至這個 Cmdlet 做為參數,或使用管線運算符。

範例

範例 1:將 A 記錄新增至記錄集

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

# You can also pipe the above sequence:

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

本範例會將 A 記錄新增至現有的記錄集。

範例 2:將 AAAA 記錄新增至記錄集

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

# You can also pipe the above sequence:

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

本範例會將AAAA記錄新增至現有的記錄集。

範例 3:將 CNAME 記錄新增至記錄集

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

# You can also pipe the above sequence:

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

本範例會將 CNAME 記錄新增至現有的記錄集。 因為 CNAME 記錄集最多可以包含一筆記錄,所以一開始必須是空的記錄集,或者必須使用 Remove-AzDnsRecordConfig 移除現有的記錄。

範例 4:將 MX 記錄新增至記錄集

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

# You can also pipe the above sequence:

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

本範例會將 MX 記錄新增至現有的記錄集。 記錄名稱 “@” 表示區域頂點的記錄集。

範例 5:將 NS 記錄新增至記錄集

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

# You can also pipe the above sequence:

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

本範例會將 NS 記錄新增至現有的記錄集。

範例 6:將 PTR 記錄新增至記錄集

$RecordSet = Get-AzDnsRecordSet -Name 4 -RecordType PTR -ResourceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa
Add-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 | Add-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

本範例會將 PTR 記錄新增至現有的記錄集。

範例 7:將 SRV 記錄新增至記錄集

$RecordSet = Get-AzDnsRecordSet -Name _sip._tcp -RecordType SRV -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-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 | Add-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

本範例會將 SRV 記錄新增至現有的記錄集。

範例 8:將 TXT 記錄新增至記錄集

$RecordSet = Get-AzDnsRecordSet -Name text -RecordType TXT -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-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 | Add-AzDnsRecordConfig -Value "This is a TXT Record" | Set-AzDnsRecordSet

本範例會將 TXT 記錄新增至現有的記錄集。

範例 9:將 DS 記錄新增至記錄集

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType DS -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -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 | Add-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC" | Set-AzDnsRecordSet

範例 10:將 TLSA 記錄新增至記錄集

$RecordSet = Get-AzDnsRecordSet -Name _443._tcp.www -RecordType TLSA -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -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 | Add-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC" | Set-AzDnsRecordSet

參數

-Algorithm

要加入之 DS 記錄的演算法欄位。

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

-CaaFlags

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

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

-CaaTag

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

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

-CaaValue

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

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

-CertificateAssociationData

要新增之 TLSA 記錄的憑證關聯數據欄位。

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

-Cname

指定標準名稱 (CNAME) 記錄的功能變數名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-Digest

要新增之 DS 記錄的摘要欄位。

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

-DigestType

要加入之 DS 記錄的摘要類型欄位。

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

-Exchange

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

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

-Ipv4Address

指定 A 記錄的 IPv4 位址。

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

-Ipv6Address

指定AAAA記錄的IPv6位址。

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

-KeyTag

要新增之 DS 記錄的索引鍵標記欄位。

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

-MatchingType

要新增之 TLSA 記錄的相符類型欄位。

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

-Nsdname

指定名稱伺服器 (NS) 記錄的名稱伺服器名稱。

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

-Port

指定服務 (SRV) 記錄的埠。

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

-Preference

指定 MX 記錄的喜好設定。

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

-Priority

指定 SRV 記錄的優先順序。

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

-Ptrdname

指定指標資源 (PTR) 記錄的目標功能變數名稱。

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

-RecordSet

指定要編輯的 RecordSet 物件。

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

-Selector

要新增之 TLSA 記錄的選取器欄位。

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

-Target

指定 SRV 記錄的目標。

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

-Usage

要新增之 TLSA 記錄的使用方式欄位。

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

-Value

指定 TXT 記錄的值。

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

-Weight

指定 SRV 記錄的權數。

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

輸入

DnsRecordSet

String

UInt16

Byte

輸出

DnsRecordSet