New-AzPrivateDnsRecordSet

Referentie

Module:: Az.PrivateDns

Hiermee maakt u een recordset in een privé-DNS-zone.

Syntaxis

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

Met de New-AzPrivateDnsRecordSet-cmdlet wordt een nieuwe DNS-recordset (Private Domain Name System) gemaakt met de opgegeven naam en typt u de opgegeven privézone. Een RecordSet-object is een set privé-DNS-records met dezelfde naam en hetzelfde type. Houd er rekening mee dat de naam relatief is ten opzichte van de privézone en niet de volledig gekwalificeerde naam. De parameter PrivateDnsRecord geeft de records in de recordset op. Deze parameter gebruikt een matrix met privé-DNS-records, samengesteld met behulp van New-AzPrivateDnsRecordConfig. U kunt de pijplijnoperator gebruiken om een PSPrivateDnsZone-object door te geven aan deze cmdlet, of u kunt een PSPrivateDnsZone-object doorgeven als de zoneparameter, of u kunt de zone opgeven op basis van de resource-id, of u kunt de zone op naam opgeven. U kunt de parameter Bevestigen en $ConfirmPreference Windows PowerShell-variabele gebruiken om te bepalen of de cmdlet u om bevestiging vraagt. Als er al een overeenkomende RecordSet bestaat (dezelfde naam en hetzelfde recordtype), moet u de parameter Overschrijven opgeven, anders maakt de cmdlet geen nieuwe RecordSet.

Voorbeelden

Voorbeeld 1: Een recordset van het type A maken

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

In dit voorbeeld wordt een RecordSet gemaakt met de naam www in de privézone myzone.com. De recordset is van het type A en heeft een TTL van 1 uur (3600 seconden). Het bevat één privé-DNS-record.

Voorbeeld 2: Een recordset van het type AAAA maken

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

In dit voorbeeld wordt een RecordSet gemaakt met de naam www in de privézone myzone.com. De recordset is van het type AAAA en heeft een TTL van 1 uur (3600 seconden). Het bevat één privé-DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 3: Een RecordSet van het type CNAME maken

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

In dit voorbeeld wordt een RecordSet gemaakt met de naam www in de privézone myzone.com. De recordset is van het type CNAME en heeft een TTL van 1 uur (3600 seconden). Het bevat één privé-DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 4: Een RecordSet van het type MX maken

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

Met deze opdracht maakt u een RecordSet met de naam www in de privézone myzone.com. De recordset is van het type MX en heeft een TTL van 1 uur (3600 seconden). Het bevat één privé-DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 5: Een recordset van het type PTR maken

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

Met deze opdracht maakt u een RecordSet met de naam 4 in de privézone 3.2.1.in-addr.arpa. De recordset is van het type PTR en heeft een TTL van 1 uur (3600 seconden). Het bevat één privé-DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 6: Een RecordSet van het type SRV maken

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

Met deze opdracht maakt u een RecordSet met de naam _sip._tcp in de privézone myzone.com. De recordset is van het type SRV en heeft een TTL van 1 uur (3600 seconden). Het bevat één privé-DNS-record, die verwijst naar het IP-adres 2001.2.3.4. De service (sip) en het protocol (tcp) worden opgegeven als onderdeel van de naam van de recordset, niet als onderdeel van de recordgegevens. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 7: Een RecordSet van het type TXT maken

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

Met deze opdracht maakt u een recordset met de naam tekst in de privézone myzone.com. De recordset is van het type TXT en heeft een TTL van 1 uur (3600 seconden). Het bevat één privé-DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 8: Een RecordSet maken in de zone-apex

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

Met deze opdracht maakt u een RecordSet in het apex (of de hoofdmap) van de privézone myzone.com. Hiervoor wordt de naam van de recordset opgegeven als @(inclusief de dubbele aanhalingstekens). U kunt geen CNAME-records maken in de apex van een zone. Dit is een beperking van de DNS-standaarden; het is geen beperking van Azure Private DNS. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 9: Een recordset met jokertekens maken

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

Met deze opdracht maakt u een RecordSet met de naam * in de privézone myzone.com. Dit is een recordset met jokertekens. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel van pn_PowerShell_short of als u een recordset met meerdere records wilt maken.

Voorbeeld 10: Een lege recordset maken

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

Met deze opdracht maakt u een RecordSet met de naam * in de privézone myzone.com. De recordset is van het type A en heeft een TTL van 1 uur (3600 seconden). Dit is een lege recordset, die fungeert als een tijdelijke aanduiding waaraan u later records kunt toevoegen.

Voorbeeld 11: Een recordset maken en alle bevestigingen onderdrukken

$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

Met deze opdracht maakt u een RecordSet. De parameter Overschrijven zorgt ervoor dat deze recordset alle bestaande recordset met dezelfde naam en hetzelfde type overschrijft (bestaande records in die recordset gaan verloren). De parameter Bevestigen met een waarde van $False onderdrukt de bevestigingsprompt.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Metadata

Een hashtabel die resourcetags vertegenwoordigt.

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Name

De naam van de records in deze recordset (ten opzichte van de naam van de zone en zonder afsluitpunt).

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Overwrite

Niet mislukken als de recordset al bestaat.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ParentResourceId

Private DNS Zone ResourceID.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PrivateDnsRecord

De privé-DNS-records die deel uitmaken van deze recordset.

Type:	PSPrivateDnsRecordBase[]
Aliassen:	PrivateDnsRecords
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RecordType

Het type privé-DNS-records in deze recordset.

Type:	RecordType
Geaccepteerde waarden:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceGroupName

De resourcegroep waartoe de zone behoort.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Ttl

De TTL-waarde van alle records in deze recordset.

Type:	UInt32
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Zone

Het PrivateDnsZone-object dat de zone vertegenwoordigt waarin de recordset moet worden gemaakt.

Type:	PSPrivateDnsZone
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ZoneName

De zone waarin de recordset moet worden gemaakt (zonder een afsluitpunt).

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

PSPrivateDnsZone

String

Uitvoerwaarden

PSPrivateDnsRecordSet

Delen via