New-AzPrivateDnsRecordSet
Hiermee maakt u een recordset in een Privé-DNS zone.
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
Met de cmdlet New-AzPrivateDnsRecordSet maakt u een nieuwe DNS-recordset (Private Domain Name System) 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 van 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 Privé-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 -OverwriteMet 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
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metadata
Een hashtabel die resourcetags vertegenwoordigt.
| Type: | Hashtable |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| standaardwaarde: | None |
| Vereist: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Overwrite
Niet mislukken als de recordset al bestaat.
| Type: | SwitchParameter |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentResourceId
Privé-DNS Zone ResourceID.
| Type: | String |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrivateDnsRecord
De privé-DNS-records die deel uitmaken van deze recordset.
| Type: | PSPrivateDnsRecordBase[] |
| Aliases: | PrivateDnsRecords |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecordType
Het type Privé-DNS records in deze recordset.
| Type: | RecordType |
| geaccepteerde waarden: | A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
De resourcegroep waartoe de zone behoort.
| Type: | String |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Ttl
De TTL-waarde van alle records in deze recordset.
| Type: | UInt32 |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
Het PrivateDnsZone-object dat de zone vertegenwoordigt waarin de recordset moet worden gemaakt.
| Type: | PSPrivateDnsZone |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ZoneName
De zone waarin de recordset moet worden gemaakt (zonder een afsluitpunt).
| Type: | String |
| Position: | Named |
| standaardwaarde: | None |
| Vereist: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Invoerwaarden
Uitvoerwaarden
Azure PowerShell
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor