New-AzDnsRecordSet
Hiermee maakt u een DNS-recordset.
Syntax
New-AzDnsRecordSet
-Name <String>
-ZoneName <String>
-ResourceGroupName <String>
-Ttl <UInt32>
-RecordType <RecordType>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDnsRecordSet
-Name <String>
-ZoneName <String>
-ResourceGroupName <String>
[-Ttl <UInt32>]
-RecordType <RecordType>
-TargetResourceId <String>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDnsRecordSet
-Name <String>
-Zone <DnsZone>
-Ttl <UInt32>
-RecordType <RecordType>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDnsRecordSet
-Name <String>
-Zone <DnsZone>
[-Ttl <UInt32>]
-RecordType <RecordType>
-TargetResourceId <String>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
De cmdlet New-AzDnsRecordSet maakt een nieuwe DNS-recordset (Domain Name System) met de opgegeven naam en typ de opgegeven zone. Een RecordSet-object is een set DNS-records met dezelfde naam en hetzelfde type. Houd er rekening mee dat de naam relatief is ten opzichte van de zone en niet de volledig gekwalificeerde naam. De parameter DnsRecords specificeert de records in de recordset. Deze parameter gebruikt een matrix van DNS-records, samengesteld met behulp van New-AzDnsRecordConfig. U kunt de pijplijnoperator gebruiken om een DnsZone-object door te geven aan deze cmdlet, of u kunt een DnsZone-object doorgeven als de zoneparameter , 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-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 $RecordsIn dit voorbeeld wordt een RecordSet gemaakt met de naam www in de zone myzone.com. De recordset is van het type A en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record.
Voorbeeld 2: Een recordset van het type AAAA maken
$Records = @()
$Records += New-AzDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsIn dit voorbeeld wordt een RecordSet gemaakt met de naam www in de zone myzone.com. De recordset is van het type AAAA en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel 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-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsIn dit voorbeeld wordt een RecordSet gemaakt met de naam www in de zone myzone.com. De recordset is van het type CNAME en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel 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-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsMet deze opdracht maakt u een RecordSet met de naam www in de zone myzone.com. De recordset is van het type MX en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.
Voorbeeld 5: Een recordset van het type NS maken
$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 $RecordsMet deze opdracht maakt u een RecordSet met de naam ns1 in de zone myzone.com. De recordset is van het type NS en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.
Voorbeeld 6: Een recordset van het type PTR maken
$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 $RecordsMet deze opdracht maakt u een RecordSet met de naam 4 in de 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 DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.
Voorbeeld 7: Een RecordSet van het type SRV maken
$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 $RecordsMet deze opdracht maakt u een RecordSet met de naam _sip._tcp in de zone myzone.com. De recordset is van het type SRV en heeft een TTL van 1 uur (3600 seconden). Het bevat één 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 pn_PowerShell_short of als u een recordset met meerdere records wilt maken.
Voorbeeld 8: Een RecordSet van het type TXT maken
$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 $RecordsMet deze opdracht maakt u een recordset met de naam tekst in de zone myzone.com. De recordset is van het type TXT en heeft een TTL van 1 uur (3600 seconden). Het bevat één DNS-record. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.
Voorbeeld 9: Een RecordSet maken in de zone-apex
$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsMet deze opdracht maakt u een RecordSet in het apex (of de hoofdmap) van de 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 DNS. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.
Voorbeeld 10: Een recordset met jokertekens maken
$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsMet deze opdracht maakt u een RecordSet met de naam * in de zone myzone.com. Dit is een recordset met jokertekens. Zie voorbeeld 1 als u een recordset wilt maken met slechts één regel pn_PowerShell_short of als u een recordset met meerdere records wilt maken.
Voorbeeld 11: Een lege recordset maken
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords @()Met deze opdracht maakt u een RecordSet met de naam www in de 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 12: Een recordset maken en alle bevestiging onderdrukken
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (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 |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DnsRecords
Hiermee geeft u de matrix van DNS-records die moeten worden opgenomen in de recordset. U kunt de cmdlet New-AzDnsRecordConfig gebruiken om DNS-recordobjecten te maken. Zie de voorbeelden voor meer informatie.
| Type: | DnsRecordBase[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Metadata
Hiermee geeft u een matrix van metagegevens die aan de RecordSet moeten worden gekoppeld. Metagegevens worden opgegeven met naam-waardeparen die worden weergegeven als hashtabellen, bijvoorbeeld @{"dept"="shopping";" env"="production"}.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Hiermee geeft u de naam van de RecordSet die moet worden gemaakt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Overwrite
Geeft aan dat deze cmdlet de opgegeven RecordSet overschrijft als deze al bestaat.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecordType
Hiermee geeft u het type DNS-record dat moet worden gemaakt. Geldige waarden zijn:
- A
- AAAA
- CNAME
- MX
- NS
- POINTER
- SRV
- TXT SOA-records worden automatisch gemaakt wanneer de zone wordt gemaakt en kan niet handmatig worden gemaakt.
| Type: | RecordType |
| Accepted values: | A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Hiermee geeft u de resourcegroep die de DNS-zone bevat. U moet ook de parameter ZoneName opgeven om de zonenaam op te geven. U kunt ook de zone en resourcegroep opgeven door een DNS-zoneobject door te geven met behulp van de zoneparameter .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TargetResourceId
Alias doelresource-id.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Ttl
Hiermee geeft u de Time to Live (TTL) voor de DNS RecordSet.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Zone
Hiermee geeft u de DnsZone waarin de RecordSet moet worden gemaakt. U kunt ook de zone opgeven met behulp van de parameters ZoneName en ResourceGroupName .
| Type: | DnsZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ZoneName
Hiermee geeft u de naam van de zone waarin de RecordSet moet worden gemaakt. U moet ook de resourcegroep opgeven die de zone bevat met behulp van de parameter ResourceGroupName . U kunt ook de zone en resourcegroep opgeven door een DNS-zoneobject door te geven met behulp van de zoneparameter .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Invoerwaarden
Uitvoerwaarden
Notities
U kunt de parameter Bevestigen gebruiken om te bepalen of deze cmdlet u om bevestiging vraagt. De cmdlet vraagt u standaard om bevestiging als de $ConfirmPreference Windows PowerShell-variabele een waarde gemiddeld of lager heeft. Als u Bevestigen of Bevestigen:$True opgeeft, wordt u door deze cmdlet gevraagd om bevestiging voordat deze wordt uitgevoerd. Als u Confirm:$False opgeeft, wordt u niet om bevestiging gevraagd.