Compartir a través de

New-AzDnsZone

  • Referencia
Módulo:
Az.Dns

Crea una nueva zona DNS.

Sintaxis

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
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ParentZone

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

Tipo:DnsZone
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ParentZoneId

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ParentZoneName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResolutionVirtualNetwork

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

Tipo:List<T>[IResourceReference]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Tag

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

Tipo:Hashtable
Alias:Tags
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.