Compartir a través de


New-AzDnsZone

Crea una nueva zona 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

El cmdlet New-AzDnsZone crea una nueva zona del sistema de nombres de dominio (DNS) en el grupo de recursos especificado. Debe especificar un nombre de zona DNS único para el parámetro Name o el cmdlet devolverá un error. Una vez creada la zona, use el cmdlet New-AzDnsRecordSet para crear conjuntos de registros en la zona. Puede usar el parámetro Confirm y $ConfirmPreference variable de Windows PowerShell para controlar si el cmdlet le pide confirmación.

Ejemplos

Ejemplo 1: Creación de una zona DNS

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

Este comando crea una nueva zona DNS denominada myzone.com en el grupo de recursos especificado y, a continuación, la almacena en la variable $Zone.

Ejemplo 2: Creación de una zona de DNS privado especificando identificadores de red virtual

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

Este comando crea una nueva zona DNS privado denominada myprivatezone.com en el grupo de recursos especificado con una red virtual de resolución asociada (especificando su identificador) y, a continuación, la almacena en la variable $Zone.

Ejemplo 3: Creación de una zona de DNS privado especificando objetos de red virtual

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

Este comando crea una nueva zona DNS privado denominada myprivatezone.com en el grupo de recursos especificado con una red virtual de resolución asociada (a la que hace referencia $ResVirtualNetwork variable) y, a continuación, la almacena en la variable $Zone.

Ejemplo 4: Creación de una zona DNS con delegación especificando el nombre de zona primaria

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

Este comando crea una nueva zona DNS secundaria denominada mychild.zone.com en el grupo de recursos especificado y almacena en la variable $Zone. También agrega delegación en la zona DNS primaria denominada zone.com residiendo en la misma suscripción y grupo de recursos que la zona secundaria.

Ejemplo 5: Creación de una zona DNS con delegación mediante la especificación del identificador de zona primaria

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

Este comando crea una nueva zona DNS secundaria denominada mychild.zone.com en el grupo de recursos especificado y almacena en la variable $Zone. También agrega delegación en la zona DNS primaria denominada zone.com en la suscripción proporcionada por otro grupo de recursos es la misma que la de la zona secundaria creada.

Ejemplo 6: Creación de una zona DNS con delegación especificando el objeto de zona primaria

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

Este comando crea una nueva zona DNS secundaria denominada mychild.zone.com en el grupo de recursos especificado y almacena en la variable $Zone. También agrega delegación en la zona DNS primaria denominada zone.com como se pasa en el objeto ParentZone.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predeterminado:False
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre de la zona DNS que se va a crear.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-ParentZone

Nombre completo de la zona primaria que se va a agregar (sin un punto de terminación).

Tipo:DnsZone
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ParentZoneId

Identificador de recurso de la zona primaria que se va a agregar (sin un punto de terminación).

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ParentZoneName

Nombre completo de la zona primaria que se va a agregar (sin un punto de terminación).

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-RegistrationVirtualNetwork

Lista de redes virtuales que registrarán registros de nombres de host de máquina virtual en esta zona DNS, solo disponibles para zonas privadas.

Tipo:List<T>[IResourceReference]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-RegistrationVirtualNetworkId

La lista de identificadores de red virtual que registrarán registros de nombres de host de máquina virtual en esta zona DNS, solo disponibles para zonas privadas.

Tipo:List<T>[String]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetwork

La lista de redes virtuales que pueden resolver registros en esta zona DNS, solo disponible para zonas privadas.

Tipo:List<T>[IResourceReference]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetworkId

La lista de identificadores de red virtual que pueden resolver registros en esta zona DNS, solo está disponible para zonas privadas.

Tipo:List<T>[String]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica el grupo de recursos en el que se va a crear la zona.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Tipo:Hashtable
Aliases:Tags
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta. Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predeterminado:False
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-ZoneType

Tipo de la zona, Pública o Privada. Las zonas sin un tipo o con un tipo público están disponibles en el plano de servicio DNS público para su uso en la jerarquía dns. Las zonas con un tipo de Privado solo son visibles desde con el conjunto de redes virtuales asociadas (esta característica está en versión preliminar). Esta propiedad no se puede cambiar para una zona.

Tipo:Nullable<T>[ZoneType]
valores aceptados:Public, Private
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

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

Salidas

DnsZone

Notas

Puede usar el parámetro Confirm para controlar si este cmdlet le pide confirmación. De forma predeterminada, el cmdlet le pide confirmación si la variable de Windows PowerShell $ConfirmPreference tiene un valor de Medium o lower. Si especifica Confirm o Confirm:$True, este cmdlet le pedirá confirmación antes de que se ejecute. Si especifica Confirm:$False, el cmdlet no le pide confirmación.