New-AzDnsRecordSet

Hiermee maakt u een DNS-recordset.

Syntax

Fields (Standaard)

New-AzDnsRecordSet
    -Name <String>
    -ZoneName <String>
    -ResourceGroupName <String>
    -Ttl <UInt32>
    -RecordType <RecordType>
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AliasFields

New-AzDnsRecordSet
    -Name <String>
    -ZoneName <String>
    -ResourceGroupName <String>
    -RecordType <RecordType>
    -TargetResourceId <String>
    [-Ttl <UInt32>]
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

TmFields

New-AzDnsRecordSet
    -Name <String>
    -ZoneName <String>
    -ResourceGroupName <String>
    -Ttl <UInt32>
    -RecordType <RecordType>
    -TrafficManagerProfileId <String>
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object

New-AzDnsRecordSet
    -Name <String>
    -Zone <DnsZone>
    -Ttl <UInt32>
    -RecordType <RecordType>
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AliasObject

New-AzDnsRecordSet
    -Name <String>
    -Zone <DnsZone>
    -RecordType <RecordType>
    -TargetResourceId <String>
    [-Ttl <UInt32>]
    [-Metadata <Hashtable>]
    [-DnsRecords <DnsRecordBase[]>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

TmObject

New-AzDnsRecordSet
    -Name <String>
    -Zone <DnsZone>
    -Ttl <UInt32>
    -RecordType <RecordType>
    -TrafficManagerProfileId <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 Confirm 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 $Records

In 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 $Records

In 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 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-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

In 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 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-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Met 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 van 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 $Records

Met 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 van 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 $Records

Met 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 van 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 $Records

Met 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 van 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 $Records

Met 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 van 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 $Records

Met 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 van 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 $Records

Met 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 van 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 -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.

Voorbeeld 13: Een recordset maken met een Traffic Manager-profiel (TMLink)

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -Ttl 3600 -TrafficManagerProfileId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myprofile"

Met deze opdracht maakt u een RecordSet met de naam www in de zone myzone.com gekoppeld aan een Azure Traffic Manager-profiel (TMLink). De parameter TrafficManagerProfileId accepteert de volledige ARM-resource-id van een Traffic Manager-profiel. Dit is een lege recordset, die fungeert als een tijdelijke aanduiding waaraan u later records kunt toevoegen.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

DnsRecordBase[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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"}.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de naam van de RecordSet die moet worden gemaakt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Overwrite

Geeft aan dat deze cmdlet de opgegeven RecordSet overschrijft als deze al bestaat.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RecordType

Hiermee geeft u het type DNS-record dat moet worden gemaakt. Geldige waarden zijn:

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • TXT SOA-records worden automatisch gemaakt wanneer de zone wordt gemaakt en kan niet handmatig worden gemaakt.

Parametereigenschappen

Type:RecordType
Default value:None
Geaccepteerde waarden:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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 .

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Fields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
AliasFields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
TmFields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-TargetResourceId

Alias doelresource-id.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

AliasFields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
AliasObject
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TrafficManagerProfileId

Hiermee geeft u de volledige resource-id van een Azure Traffic Manager-profiel om een TMLink-recordset te maken. Hiermee wordt de DNS-record gekoppeld aan een Traffic Manager-profiel, waardoor de mogelijkheden voor verkeerbeheer worden ingeschakeld. Deze parameter sluiten elkaar wederzijds uit met TargetResourceId.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

TmFields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
TmObject
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Ttl

Hiermee geeft u de Time to Live (TTL) voor de DNS RecordSet.

Parametereigenschappen

Type:UInt32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Fields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
Object
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 .

Parametereigenschappen

Type:DnsZone
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Object
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
AliasObject
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
TmObject
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 .

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Fields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
AliasFields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
TmFields
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase

Uitvoerwaarden

DnsRecordSet

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.