New-AzDnsZone

Crea una nuova zona DNS.

Sintassi

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>]

Descrizione

Il cmdlet New-AzDnsZone crea una nuova zona DNS (Domain Name System) nel gruppo di risorse specificato. È necessario specificare un nome di zona DNS univoco per il parametro Name oppure il cmdlet restituirà un errore. Dopo aver creato la zona, usare il cmdlet New-AzDnsRecordSet per creare set di record nella zona. È possibile usare il parametro Confirm e $ConfirmPreference variabile di Windows PowerShell per controllare se il cmdlet richiede la conferma.

Esempio

Esempio 1: Creare una zona DNS

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

Questo comando crea una nuova zona DNS denominata myzone.com nel gruppo di risorse specificato e quindi la archivia nella variabile $Zone.

Esempio 2: Creare una zona DNS privato specificando gli ID di rete virtuale

$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)

Questo comando crea una nuova zona DNS privato denominata myprivatezone.com nel gruppo di risorse specificato con una rete virtuale di risoluzione associata (specificandone l'ID) e quindi la archivia nella variabile $Zone.

Esempio 3: Creare una zona DNS privato specificando oggetti di rete virtuale

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

Questo comando crea una nuova zona DNS privato denominata myprivatezone.com nel gruppo di risorse specificato con una rete virtuale di risoluzione associata (a cui fa riferimento $ResVirtualNetwork variabile) e quindi la archivia nella variabile $Zone.

Esempio 4: Creare una zona DNS con delega specificando il nome della zona padre

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

Questo comando crea una nuova zona DNS figlio denominata mychild.zone.com nel gruppo di risorse specificato e archivia nella variabile $Zone. Aggiunge inoltre la delega nella zona DNS padre denominata zone.com che si trova nella stessa sottoscrizione e gruppo di risorse della zona figlio.

Esempio 5: Creare una zona DNS con delega specificando l'ID zona padre

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

Questo comando crea una nuova zona DNS figlio denominata mychild.zone.com nel gruppo di risorse specificato e archivia nella variabile $Zone. Aggiunge anche la delega nella zona DNS padre denominata zone.com nel gruppo di risorse altra sottoscrizione fornita da rg è uguale a quella della zona figlio creata.

Esempio 6: Creare una zona DNS con delega specificando l'oggetto zona padre

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

Questo comando crea una nuova zona DNS figlio denominata mychild.zone.com nel gruppo di risorse specificato e archivia nella variabile $Zone. Aggiunge inoltre la delega nella zona DNS padre denominata zone.com come passato nell'oggetto ParentZone

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome della zona DNS da creare.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ParentZone

Nome completo della zona padre da aggiungere la delega (senza un punto di terminazione).

Type:DnsZone
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ParentZoneId

ID risorsa della zona padre da aggiungere la delega (senza un punto di terminazione).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ParentZoneName

Nome completo della zona padre da aggiungere la delega (senza un punto di terminazione).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RegistrationVirtualNetwork

Elenco di reti virtuali che registreranno i record dei nomi host delle macchine virtuali in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RegistrationVirtualNetworkId

Elenco di ID di rete virtuale che registreranno i record dei nomi host delle macchine virtuali in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetwork

Elenco di reti virtuali in grado di risolvere i record in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetworkId

Elenco di ID di rete virtuale in grado di risolvere i record in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Specifica il gruppo di risorse in cui creare la zona.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito. Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ZoneType

Tipo di zona, pubblico o privato. Le zone senza un tipo o con un tipo public vengono rese disponibili nel piano di gestione DNS pubblico per l'uso nella gerarchia DNS. Le zone con un tipo privato sono visibili solo da con il set di reti virtuali associate (questa funzionalità è in anteprima). Questa proprietà non può essere modificata per una zona.

Type:Nullable<T>[ZoneType]
Accepted values:Public, Private
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

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]]

Output

DnsZone

Note

È possibile usare il parametro Confirm per controllare se questo cmdlet richiede la conferma. Per impostazione predefinita, il cmdlet richiede la conferma se la variabile di Windows PowerShell $ConfirmPreference ha un valore medio o inferiore. Se si specifica Confirm o Confirm:$True, questo cmdlet richiede la conferma prima dell'esecuzione. Se si specifica Confirm:$False, il cmdlet non richiede la conferma.