New-AzDnsRecordConfig
建立新的 DNS 記錄本機物件。
Syntax
New-AzDnsRecordConfig
-Ipv4Address <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Ipv6Address <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Nsdname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Exchange <String>
-Preference <UInt16>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Ptrdname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Value <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Priority <UInt16>
-Target <String>
-Port <UInt16>
-Weight <UInt16>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Cname <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-CaaFlags <Byte>
-CaaTag <String>
-CaaValue <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-KeyTag <Int32>
-Algorithm <Int32>
-DigestType <Int32>
-Digest <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzDnsRecordConfig
-Usage <Int32>
-Selector <Int32>
-MatchingType <Int32>
-CertificateAssociationData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
New-AzDnsRecordConfig Cmdlet 會建立本機 DnsRecord 物件。 這些物件的陣列會使用 DnsRecords 參數傳遞至 New-AzDnsRecordSet Cmdlet，以指定要在記錄集中建立的記錄。
範例
範例 1：建立類型為 A 的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records
# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -IPv4Address 1.2.3.4)
# To create a record set containing multiple records, use New-AzDnsRecordConfig to add each record to the $Records array,
# then call New-AzDnsRecordSet, as follows:
$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此範例會在區域中建立 名為 www 的 RecordSet myzone.com。 記錄集的類型為 A，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。
範例 2：建立 AAAA 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此範例會在區域中建立 名為 www 的 RecordSet myzone.com。 記錄集的類型為AAAA，且TTL為1小時（3600秒）。 其中包含單一 DNS 記錄。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 3：建立 CNAME 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此範例會在區域中建立 名為 www 的 RecordSet myzone.com。 記錄集的類型為 CNAME，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 4：建立 MX 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此命令會在區域中建立 名為 www 的 RecordSet myzone.com。 記錄集的類型為 MX，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 5：建立 NS 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Nsdname ns1-01.azure-dns.com
$RecordSet = New-AzDnsRecordSet -Name "ns1" -RecordType NS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此命令會在區域中建立 名為 ns1 的 RecordSet myzone.com。 記錄集的類型為 NS，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 6：建立 PTR 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -DnsRecords $Records此命令會在 區域 3.2.1.in-addr.arpa 中建立名為 4 的 RecordSet 。 記錄集的類型為 PTR，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 7：建立 SRV 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此命令會在 區域中建立名為 _sip._tcp 的 RecordSet myzone.com。 記錄集的類型為 SRV，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄，指向 IP 位址 2001.2.3.4。 服務 （sip） 和通訊協定 （tcp） 會指定為記錄集名稱的一部分，而不是記錄數據的一部分。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 8：建立 TXT 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此命令會在區域中建立 名為 text 的 RecordSet myzone.com。 記錄集的類型為 TXT，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 9：建立 DS 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "childds" -RecordType DS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此命令會在區域中建立 名為 childds 的 RecordSet myzone.com。 記錄集的類型為 DS，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。 記錄數據包含子區域 DNSKEY 記錄的索引鍵標記、演算法、摘要類型和摘要。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
範例 10：建立 TLSA 類型的 RecordSet
$Records = @()
$Records += New-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records此命令會在 區域中建立名為 _443._tcp.www 的 RecordSet myzone.com。 記錄集的類型為 TLSA，且 TTL 為 1 小時（3600 秒）。 其中包含單一 DNS 記錄。 記錄數據包含憑證關聯數據的使用量、選取器和比對類型。 若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。
參數
-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 |
-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 |
輸入
輸出
相關連結
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應