Compartir a través de

Set-AzDnsZone

  • Referencia
Módulo:
Az.Dns

Novedades las propiedades de una zona DNS.

Syntax

Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-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>]
Set-AzDnsZone
   -Zone <DnsZone>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzDnsZone actualiza la zona DNS especificada en el servicio Azure DNS. Este cmdlet no actualiza los conjuntos de registros de la zona. Puede pasar un objeto DnsZone como parámetro o mediante el operador de canalización, o bien puede especificar los parámetros ZoneName y ResourceGroupName . Puede usar el parámetro Confirm y $ConfirmPreference variable de Windows PowerShell para controlar si el cmdlet le pide confirmación. Al pasar una zona DNS como un objeto (mediante el objeto Zone o a través de la canalización), no se actualiza si se ha cambiado en Azure DNS desde que se recuperó el objeto DnsZone local. Esto proporciona protección para los cambios simultáneos. Puede suprimir este comportamiento con el parámetro Overwrite , que actualiza la zona independientemente de los cambios simultáneos.

Ejemplos

Ejemplo 1: Actualización de una zona DNS

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$Zone.Tags = @(@{"Name"="Dept"; "Value"="Electrical"})
Set-AzDnsZone -Zone $Zone

El primer comando obtiene la zona denominada myzone.com del grupo de recursos especificado y, a continuación, la almacena en la variable $Zone. El segundo comando actualiza las etiquetas para $Zone. El comando final confirma el cambio.

Ejemplo 2: Actualización de etiquetas para una zona

Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com" -Tag @(@{"Name"="Dept"; "Value"="Electrical"})

Este comando actualiza las etiquetas de la zona denominada myzone.com sin obtener primero explícitamente la zona.

Ejemplo 3: Asociación de una zona privada con una red virtual especificando su identificador

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetworkId @($vnet.Id)

Este comando asocia el myprivatezone.com de zona de DNS privado a la red virtual myvnet como una red de registro especificando su identificador.

Ejemplo 4: Asociación de una zona privada con una red virtual especificando el objeto de red.

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetwork @($vnet)

Este comando asocia la zona DNS privado myprivatezone.com a la red virtual myvnet como red de registro pasando el objeto de red virtual representado por $vnet variable al cmdlet Set-AzDnsZone.

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 actualizar.

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

-Overwrite

Al pasar una zona DNS como un objeto (mediante el objeto Zone o a través de la canalización), no se actualiza si se ha cambiado en Azure DNS desde que se recuperó el objeto DnsZone local. Esto proporciona protección para los cambios simultáneos. Puede suprimir este comportamiento con el parámetro Overwrite , que actualiza la zona independientemente de los cambios simultáneos.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
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 nombre del grupo de recursos que contiene la zona que se va a actualizar. También debe especificar el parámetro ZoneName. Como alternativa, puede especificar la zona mediante un objeto DnsZone con el parámetro Zone o la canalización.

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

-Zone

Especifica la zona DNS que se va a actualizar. Como alternativa, puede especificar la zona mediante los parámetros ZoneName y ResourceGroupName .

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

Entradas

String

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

DnsZone

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.