Delen via

New-AzDnsZone

  • Referentie
Module:
Az.Dns

Hiermee maakt u een nieuwe DNS-zone.

Syntaxis

New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneId <String>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneName <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZone <DnsZone>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De New-AzDnsZone cmdlet maakt een nieuwe DNS-zone (Domain Name System) in de opgegeven resourcegroep. U moet een unieke DNS-zonenaam opgeven voor de parameter Name of de cmdlet retourneert een fout. Nadat de zone is gemaakt, gebruikt u de cmdlet New-AzDnsRecordSet om recordsets in de zone te maken. U kunt de parameter bevestigen en $ConfirmPreference Windows PowerShell-variabele gebruiken om te bepalen of de cmdlet u om bevestiging vraagt.

Voorbeelden

Voorbeeld 1: Een DNS-zone maken

$Zone = New-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

Met deze opdracht maakt u een nieuwe DNS-zone met de naam myzone.com in de opgegeven resourcegroep en slaat u deze vervolgens op in de $Zone variabele.

Voorbeeld 2: Een privé-DNS-zone maken door id's van virtuele netwerken op te geven

$ResVirtualNetworkId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testresgroup/providers/Microsoft.Network/virtualNetworks/resvnet"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetworkId @($ResVirtualNetworkId)

Met deze opdracht maakt u een nieuwe privé-DNS-zone met de naam myprivatezone.com in de opgegeven resourcegroep met een gekoppeld virtueel netwerk voor resolutie (opgeven van de id) en slaat u deze vervolgens op in de variabele $Zone.

Voorbeeld 3: Een privé-DNS-zone maken door virtuele netwerkobjecten op te geven

$ResVirtualNetwork = Get-AzVirtualNetwork -Name "resvnet" -ResourceGroupName "testresgroup"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetwork @($ResVirtualNetwork)

Met deze opdracht maakt u een nieuwe privé-DNS-zone met de naam myprivatezone.com in de opgegeven resourcegroep met een gekoppeld virtueel netwerk voor resolutie (waarnaar wordt verwezen door $ResVirtualNetwork variabele) en slaat deze vervolgens op in de variabele $Zone.

Voorbeeld 4: Een DNS-zone met delegering maken door de naam van de bovenliggende zone op te geven

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneName "zone.com"

Met deze opdracht maakt u een nieuwe onderliggende DNS-zone met de naam mychild.zone.com in de opgegeven resourcegroep en slaat u deze op in de $Zone variabele. Er wordt ook delegatie toegevoegd in de bovenliggende DNS-zone met de naam zone.com zich in hetzelfde abonnement en dezelfde resourcegroep bevindt als onderliggende zone.

Voorbeeld 5: Een DNS-zone met delegatie maken door de bovenliggende zone-id op te geven

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneId "/subscriptions/**67e2/resourceGroups/other-rg/providers/Microsoft.Network/dnszones/zone.com"

Met deze opdracht maakt u een nieuwe onderliggende DNS-zone met de naam mychild.zone.com in de opgegeven resourcegroep en slaat u deze op in de $Zone variabele. Er wordt ook delegatie toegevoegd in de bovenliggende DNS-zone met de naam zone.com in een ander abonnement voor de resourcegroep dat is opgegeven, hetzelfde is als die van de onderliggende zone die is gemaakt.

Voorbeeld 6: Een DNS-zone met delegering maken door het bovenliggende zoneobject op te geven

$PZone = New-AzDnsZone -Name "zone.com" -ResourceGroupName "MyResourceGroup" 
$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZone @($PZone)

Met deze opdracht maakt u een nieuwe onderliggende DNS-zone met de naam mychild.zone.com in de opgegeven resourcegroep en slaat u deze op in de $Zone variabele. Er wordt ook delegatie toegevoegd in de bovenliggende DNS-zone met de naam zone.com zoals doorgegeven in het ParentZone-object

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DefaultProfile

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

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

-Name

Hiermee geeft u de naam van de DNS-zone die moet worden gemaakt.

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

-ParentZone

De volledige naam van de bovenliggende zone om delegatie toe te voegen (zonder afsluitpunt).

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

-ParentZoneId

De resource-id van de bovenliggende zone om delegatie toe te voegen (zonder afsluitpunt).

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

-ParentZoneName

De volledige naam van de bovenliggende zone om delegatie toe te voegen (zonder afsluitpunt).

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

-RegistrationVirtualNetwork

De lijst met virtuele netwerken die hostnamenrecords voor virtuele machines registreren in deze DNS-zone, alleen beschikbaar voor privézones.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RegistrationVirtualNetworkId

De lijst met virtuele netwerk-id's waarmee hostnamen van virtuele machines in deze DNS-zone worden geregistreerd, alleen beschikbaar voor privézones.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResolutionVirtualNetwork

De lijst met virtuele netwerken die records in deze DNS-zone kunnen omzetten, alleen beschikbaar voor privézones.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResolutionVirtualNetworkId

De lijst met virtuele netwerk-id's die records in deze DNS-zone kunnen omzetten, alleen beschikbaar voor privézones.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de resourcegroep op waarin de zone moet worden gemaakt.

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

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

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

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

-ZoneType

Het type zone, Openbaar of Privé. Zones zonder type of met een type Openbaar worden beschikbaar gesteld op het openbare DNS-servervlak voor gebruik in de DNS-hiërarchie. Zones met een type Privé zijn alleen zichtbaar vanuit de set gekoppelde virtuele netwerken (deze functie is in preview). Deze eigenschap kan niet worden gewijzigd voor een zone.

Type:Nullable<T>[ZoneType]
Geaccepteerde waarden:Public, Private
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

Nullable<T>[[Microsoft.Azure.Management.Dns.Models.ZoneType, Microsoft.Azure.Management.Dns, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Hashtable

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Uitvoerwaarden

DnsZone

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 Confirm:$Trueopgeeft, wordt u door deze cmdlet gevraagd om bevestiging voordat deze wordt uitgevoerd. Als u Confirm:$Falseopgeeft, wordt u niet om bevestiging gevraagd.