New-AzPrivateDnsRecordSet

Referens

Modul:: Az.PrivateDns

Skapar en postuppsättning i en privat DNS-zon.

Syntax

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

Cmdleten New-AzPrivateDnsRecordSet skapar en ny DNS-postuppsättning (Private Domain Name System) med det angivna namnet och skriver i den angivna privata zonen. Ett RecordSet-objekt är en uppsättning privata DNS-poster med samma namn och typ. Observera att namnet är relativt till den privata zonen och inte det fullständigt kvalificerade namnet. Parametern PrivateDnsRecord anger posterna i postuppsättningen. Den här parametern tar en matris med privata DNS-poster som skapats med New-AzPrivateDnsRecordConfig. Du kan använda pipelineoperatorn för att skicka ett PSPrivateDnsZone-objekt till den här cmdleten, eller så kan du skicka ett PSPrivateDnsZone-objekt som zonparameter, eller ange zonen med dess ResourceId, eller så kan du ange zonen efter namn. Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse. Om det redan finns en matchande RecordSet (samma namn och posttyp) måste du ange parametern Skriv över, annars skapar cmdleten inte en ny RecordSet .

Exempel

Exempel 1: Skapa en postuppsättning av typen A

$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  :

I det här exemplet skapas en RecordSet med namnet www i den privata zonen myzone.com. Postuppsättningen är av typ A och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda privat DNS-post.

Exempel 2: Skapa en postuppsättning av typen AAAA

$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  :

I det här exemplet skapas en RecordSet med namnet www i den privata zonen myzone.com. Postuppsättningen är av typen AAAA och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda privat DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 3: Skapa en postuppsättning av typen CNAME

$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  :

I det här exemplet skapas en RecordSet med namnet www i den privata zonen myzone.com. Postuppsättningen är av typen CNAME och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda privat DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 4: Skapa en postuppsättning av typen MX

$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  :

Det här kommandot skapar en RecordSet med namnet www i den privata zonen myzone.com. Postuppsättningen är av typen MX och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda privat DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 5: Skapa en postuppsättning av typen PTR

$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  :

Det här kommandot skapar en RecordSet med namnet 4 i den privata zonen 3.2.1.in-addr.arpa. Postuppsättningen är av typen PTR och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda privat DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 6: Skapa en postuppsättning av typen SRV

$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  :

Det här kommandot skapar en RecordSet med namnet _sip._tcp i den privata zonen myzone.com. Postuppsättningen är av typen SRV och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda privat DNS-post som pekar på IP-adressen 2001.2.3.4. Tjänsten (sip) och protokollet (tcp) anges som en del av postuppsättningens namn, inte som en del av postdata. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 7: Skapa en postuppsättning av typen TXT

$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  :

Det här kommandot skapar en RecordSet med namnet text i den privata zonen myzone.com. Postuppsättningen är av typen TXT och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda privat DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 8: Skapa en postuppsättning i zonexemplet

$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  :

Det här kommandot skapar en RecordSet i toppen (eller roten) för den privata zonen myzone.com. För att göra detta anges postuppsättningens namn som "@" (inklusive dubbla citattecken). Du kan inte skapa CNAME-poster i toppen av en zon. Detta är en begränsning av DNS-standarderna. det är inte en begränsning för Privat DNS i Azure. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 9: Skapa en postuppsättning med jokertecken

$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  :

Det här kommandot skapar en RecordSet med namnet * i den privata zonen myzone.com. Det här är en postuppsättning med jokertecken. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 10: Skapa en tom postuppsättning

$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  :

Det här kommandot skapar en RecordSet med namnet * i den privata zonen myzone.com. Postuppsättningen är av typ A och har en TTL på 1 timme (3 600 sekunder). Det här är en tom postuppsättning som fungerar som en platshållare som du senare kan lägga till poster till.

Exempel 11: Skapa en postuppsättning och ignorera all bekräftelse

$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

Det här kommandot skapar en RecordSet. Parametern Överskrivning säkerställer att den här postuppsättningen skriver över alla befintliga postuppsättningar med samma namn och typ (befintliga poster i den postuppsättningen går förlorade). Parametern Confirm med värdet $False undertrycker bekräftelseprompten.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Metadata

En hash-tabell som representerar resurstaggar.

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Namnet på posterna i den här postuppsättningen (i förhållande till namnet på zonen och utan en avslutande punkt).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Overwrite

Misslyckas inte om postuppsättningen redan finns.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ParentResourceId

Resurs-ID för privat DNS-zon.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-PrivateDnsRecord

De privata dns-poster som ingår i den här postuppsättningen.

Typ:	PSPrivateDnsRecordBase[]
Alias:	PrivateDnsRecords
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RecordType

Typen av privata DNS-poster i den här postuppsättningen.

Typ:	RecordType
Godkända värden:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Den resursgrupp som zonen tillhör.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Ttl

TTL-värdet för alla poster i den här postuppsättningen.

Typ:	UInt32
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Zone

PrivateDnsZone-objektet som representerar zonen där postuppsättningen ska skapas.

Typ:	PSPrivateDnsZone
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ZoneName

Zonen där postuppsättningen ska skapas (utan en avslutande punkt).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

PSPrivateDnsZone

String

Utdata

PSPrivateDnsRecordSet

Dela via