New-AzPrivateDnsRecordSet

參考

模組:: Az.PrivateDns

在私人 DNS 區域中建立記錄集。

語法

New-AzPrivateDnsRecordSet
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -Zone <PSPrivateDnsZone>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzPrivateDnsRecordSet
   -ParentResourceId <String>
   -Name <String>
   -RecordType <RecordType>
   -Ttl <UInt32>
   [-Metadata <Hashtable>]
   [-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzPrivateDnsRecordSet Cmdlet 會使用指定的名稱建立新的私人網域名稱系統（DNS）記錄集，並在指定的私人區域中輸入。 RecordSet 對像是一組具有相同名稱和類型的私人 DNS 記錄。請注意，名稱是相對於私人區域，而不是完整名稱。 PrivateDnsRecord 參數會指定記錄集中的記錄。此參數會採用使用 New-AzPrivateDnsRecordConfig 建構的私人 DNS 記錄陣列。您可以使用管線運算符將 PSPrivateDnsZone 對象傳遞至此 Cmdlet，也可以將 PSPrivateDnsZone 對象當做 Zone 參數傳遞，也可以依其 ResourceId 指定區域，或者您也可以依名稱指定區域。您可以使用 Confirm 參數和 $ConfirmPreference Windows PowerShell 變數來控制 Cmdlet 是否提示您進行確認。如果相符的 RecordSet 已經存在（相同的名稱和記錄類型），您必須指定 Overwrite 參數，否則 Cmdlet 將不會建立新的 RecordSet 。

範例

範例 1：建立類型為 A 的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :


# To create a record set containing multiple records, use New-AzPrivateDnsRecordConfig to add each record to the $Records array,
# then call New-AzPrivateDnsRecordSet, as follows:

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 5.6.7.8}
Metadata          :
IsAutoRegistered  :

此範例會在私人區域中建立名為 www 的 RecordSet myzone.com。記錄集的類型為 A，且 TTL 為 1 小時（3600 秒）。其中包含單一私人 DNS 記錄。

範例 2：建立 AAAA 類型的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:db8::1}
Metadata          :
IsAutoRegistered  :

此範例會在私人區域中建立名為 www 的 RecordSet myzone.com。記錄集的類型為AAAA，且TTL為1小時（3600秒）。其中包含單一私人 DNS 記錄。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 3：建立 CNAME 類型的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/CNAME/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : CNAME
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

此範例會在私人區域中建立名為 www 的 RecordSet myzone.com。記錄集的類型為 CNAME，且 TTL 為 1 小時（3600 秒）。其中包含單一私人 DNS 記錄。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 4：建立 MX 類型的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/MX/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : MX
Records           : {[5,mail.microsoft.com]}
Metadata          :
IsAutoRegistered  :

此命令會在私人區域中建立名為 www 的 RecordSet myzone.com。記錄集的類型為 MX，且 TTL 為 1 小時（3600 秒）。其中包含單一私人 DNS 記錄。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 5：建立 PTR 類型的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name              : 4
ZoneName          : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : PTR
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

此命令會在私人區域 3.2.1.in-addr.arpa 中建立名為 4 的 RecordSet。記錄集的類型為 PTR，且 TTL 為 1 小時（3600 秒）。其中包含單一私人 DNS 記錄。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 6：建立 SRV 類型的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name              : _sip._tcp
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SRV
Records           : {[0,5,8080,sipservice.contoso.com]}
Metadata          :
IsAutoRegistered  :

此命令會在私人區域中建立名為 _sip._tcp 的 RecordSet myzone.com。記錄集的類型為 SRV，且 TTL 為 1 小時（3600 秒）。其中包含單一私人 DNS 記錄，指向 IP 位址 2001.2.3.4。服務（sip）和通訊協定（tcp）會指定為記錄集名稱的一部分，而不是記錄數據的一部分。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 7：建立 TXT 類型的 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/TXT/text
Name              : text
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : TXT
Records           : {This is a TXT Record}
Metadata          :
IsAutoRegistered  :

此命令會在私人區域中建立名為 text 的 RecordSet myzone.com。記錄集的類型為 TXT，且 TTL 為 1 小時（3600 秒）。其中包含單一私人 DNS 記錄。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 8：在區域頂點建立 RecordSet

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

此命令會在私人區域的頂點（或 root）建立 RecordSet myzone.com。若要這樣做，記錄集名稱會指定為 “@” （包括雙引號）。您無法在區域的頂點建立 CNAME 記錄。這是 DNS 標準的條件約束;這不是 Azure 私人 DNS 的限制。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 9：建立通配符記錄集

$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

此命令會在私人區域中建立名為 * 的 RecordSet myzone.com。這是通配符記錄集。若要使用一行pn_PowerShell_short建立 RecordSet，或建立具有多個記錄的記錄集，請參閱範例 1。

範例 10：建立空白的記錄集

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords @()

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/@
Name              : *
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {}
Metadata          :
IsAutoRegistered  :

此命令會在私人區域中建立名為 * 的 RecordSet myzone.com。記錄集的類型為 A，且 TTL 為 1 小時（3600 秒）。這是空的記錄集，可作為您稍後新增記錄的佔位符。

範例 11：建立記錄集並隱藏所有確認

$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite

此命令會建立 RecordSet。 Overwrite 參數可確保此記錄集會以相同的名稱和類型覆寫任何預先存在的記錄集（該記錄集中的現有記錄會遺失）。具有 $False 值的 Confirm 參數會隱藏確認提示。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

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

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Metadata

代表資源標記的哈希表。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

此記錄集中的記錄名稱（相對於區域的名稱，且沒有終止點）。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Overwrite

如果記錄集已經存在，請勿失敗。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ParentResourceId

私人 DNS 區域 ResourceID。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-PrivateDnsRecord

屬於此記錄集一部分的私人 DNS 記錄。

類型:	PSPrivateDnsRecordBase[]
別名:	PrivateDnsRecords
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RecordType

此記錄集中的私人 DNS 記錄類型。

類型:	RecordType
接受的值:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

區域所屬的資源群組。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Ttl

此記錄集中所有記錄的 TTL 值。

類型:	UInt32
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Zone

PrivateDnsZone 物件，代表要在其中建立記錄集的區域。

類型:	PSPrivateDnsZone
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ZoneName

要在其中建立記錄集的區域（不含終止點）。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

PSPrivateDnsZone

String

輸出

PSPrivateDnsRecordSet

共用方式為