Delen via

New-AzDnsZone

  • Referentie
Module:
Az.Dns

Hiermee maakt u een nieuwe DNS-zone.

Syntax

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 cmdlet New-AzDnsZone maakt een nieuwe DNS-zone (Domain Name System) in de opgegeven resourcegroep. U moet een unieke DNS-zonenaam opgeven voor de naamparameter 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 oplossingsnetwerk (de id opgeven) en slaat deze vervolgens op in de $Zone variabele.

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 oplossingsnetwerk (waarnaar wordt verwezen door $ResVirtualNetwork variabele) en slaat deze vervolgens op in de $Zone variabele.

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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:False
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-ParentZone

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

Type:DnsZone
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ParentZoneId

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

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ParentZoneName

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

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Aliases:Tags
Position:Named
standaardwaarde:None
Vereist:False
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. Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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 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.