New-AzDnsZone

  • Référence
Module:
Az.Dns

Crée une zone DNS.

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

L’applet de commande New-AzDnsZone crée une zone DNS (Domain Name System) dans le groupe de ressources spécifié. Vous devez spécifier un nom de zone DNS unique pour le paramètre Name ou l’applet de commande renvoie une erreur. Une fois la zone créée, utilisez l’applet de commande New-AzDnsRecordSet pour créer des jeux d’enregistrements dans la zone. Vous pouvez utiliser le paramètre Confirm et $ConfirmPreference variable Windows PowerShell pour contrôler si l’applet de commande vous invite à confirmer.

Exemples

Exemple 1 : Créer une zone DNS

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

Cette commande crée une zone DNS nommée myzone.com dans le groupe de ressources spécifié, puis la stocke dans la variable $Zone.

Exemple 2 : Créer une zone DNS privé en spécifiant des ID de réseau virtuel

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

Cette commande crée une zone DNS privé nommée myprivatezone.com dans le groupe de ressources spécifié avec un réseau virtuel de résolution associé (en spécifiant son ID), puis la stocke dans la variable $Zone.

Exemple 3 : Créer une zone de DNS privé en spécifiant des objets de réseau virtuel

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

Cette commande crée une zone DNS privé nommée myprivatezone.com dans le groupe de ressources spécifié avec un réseau virtuel de résolution associé (référencé par $ResVirtualNetwork variable), puis la stocke dans la variable $Zone.

Exemple 4 : Créer une zone DNS avec délégation en spécifiant le nom de la zone parente

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

Cette commande crée une zone DNS enfant nommée mychild.zone.com dans le groupe de ressources et stocke dans la variable $Zone. Il ajoute également la délégation dans la zone DNS parente nommée zone.com résidant dans le même abonnement et le même groupe de ressources que la zone enfant.

Exemple 5 : Créer une zone DNS avec délégation en spécifiant l’ID de zone parent

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

Cette commande crée une zone DNS enfant nommée mychild.zone.com dans le groupe de ressources et stocke dans la variable $Zone. Il ajoute également la délégation dans la zone DNS parente nommée zone.com dans l’abonnement fourni par le groupe de ressources autre que celui de la zone enfant créée.

Exemple 6 : Créer une zone DNS avec délégation en spécifiant l’objet de zone parente

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

Cette commande crée une zone DNS enfant nommée mychild.zone.com dans le groupe de ressources et stocke dans la variable $Zone. Il ajoute également la délégation dans la zone DNS parente nommée zone.com telle qu’elle est passée dans l’objet ParentZone

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

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

-Name

Spécifie le nom de la zone DNS à créer.

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

-ParentZone

Nom complet de la zone parente à ajouter une délégation (sans point de fin).

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

-ParentZoneId

ID de ressource de la zone parente à ajouter une délégation (sans point de fin).

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

-ParentZoneName

Nom complet de la zone parente à ajouter une délégation (sans point de fin).

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

-RegistrationVirtualNetwork

Liste des réseaux virtuels qui inscrivent des enregistrements de noms d’hôte de machine virtuelle dans cette zone DNS, disponibles uniquement pour les zones privées.

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

-RegistrationVirtualNetworkId

Liste des ID de réseau virtuel qui inscrivent des enregistrements de noms d’hôte de machine virtuelle dans cette zone DNS, disponibles uniquement pour les zones privées.

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

-ResolutionVirtualNetwork

La liste des réseaux virtuels en mesure de résoudre les enregistrements dans cette zone DNS, disponible uniquement pour les zones privées.

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

-ResolutionVirtualNetworkId

Liste des ID de réseau virtuel capables de résoudre les enregistrements dans cette zone DNS, disponibles uniquement pour les zones privées.

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

-ResourceGroupName

Spécifie le groupe de ressources dans lequel créer la zone.

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

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{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

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée. Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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

-ZoneType

Type de zone, public ou privé. Les zones sans type ou avec un type public sont rendues disponibles sur le plan de service DNS public à utiliser dans la hiérarchie DNS. Les zones avec un type privé sont visibles uniquement à partir de l’ensemble de réseaux virtuels associés (cette fonctionnalité est en préversion). Cette propriété ne peut pas être modifiée pour une zone.

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

Entrées

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

Sorties

DnsZone

Notes

Vous pouvez utiliser le paramètre Confirm pour contrôler si cette applet de commande vous invite à confirmer. Par défaut, l’applet de commande vous invite à confirmer si la variable Windows PowerShell $ConfirmPreference a une valeur moyenne ou inférieure. Si vous spécifiez Confirm ou Confirm :$True, cette applet de commande vous invite à confirmer son exécution. Si vous spécifiez Confirm :$False, l’applet de commande ne vous invite pas à confirmer.