Compartir a través de


Set-AzDnsZone

Actualiza las propiedades de una zona DNS.

Sintaxis

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

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

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