New-AzDnsZone

Módulo:
Az.Dns Module

Crea una nueva zona DNS.

Sintaxis

Ids (valor predeterminado) 

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

Names 

New-AzDnsZone
    -Name <String>
    -ResourceGroupName <String>
    [-ZoneType <ZoneType>]
    [-ParentZoneName <String>]
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Objects 

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 Windows variable de 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 pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ParentZone

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

Propiedades de parámetro

Tipo:DnsZone
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Objects
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ParentZoneId

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Ids
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ParentZoneName

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Names
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

List<T>[IResourceReference]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Objects
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

List<T>[String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Ids
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResolutionVirtualNetwork

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

Propiedades de parámetro

Tipo:

List<T>[IResourceReference]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Objects
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResolutionVirtualNetworkId

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

Propiedades de parámetro

Tipo:

List<T>[String]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Ids
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceGroupName

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Tag

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

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Tags

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:

Nullable<T>[ZoneType]

Valor predeterminado:None
Valores aceptados:Public, Private
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Nullable<T>

Hashtable

List<T>

List<T>

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 PowerShell $ConfirmPreference Windows 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.