Compartir a través de

Set-AzDnsRecordSet

  • Referencia
Módulo:
Az.Dns

Actualiza un conjunto de registros DNS.

Sintaxis

Set-AzDnsRecordSet
   -RecordSet <DnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzDnsRecordSet actualiza un conjunto de registros en el servicio Dns de Azure desde un objeto RecordSet local. Puede pasar un objeto RecordSet como parámetro o mediante el operador de canalización. Puede usar el parámetro Confirm y $ConfirmPreference variable de Windows PowerShell para controlar si el cmdlet le pide confirmación. El conjunto de registros no se actualiza si se ha cambiado en Azure DNS desde que se recuperó el objeto RecordSet local. Esto proporciona protección para los cambios simultáneos. Puede suprimir este comportamiento mediante el parámetro Overwrite , que actualiza el conjunto de registros independientemente de los cambios simultáneos.

Ejemplos

Ejemplo 1: Actualización de un conjunto de registros

$RecordSet = Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzDnsRecordSet -RecordSet $RecordSet

# These cmdlets can also be piped:

Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A | Add-AzDnsRecordConfig -Ipv4Address 172.16.0.0 | Add-AzDnsRecordConfig -Ipv4Address 172.31.255.255 | Set-AzDnsRecordSet

El primer comando usa el cmdlet Get-AzDnsRecordSet para obtener el conjunto de registros especificado y, a continuación, lo almacena en la variable $RecordSet. Los comandos segundo y tercero son operaciones fuera de línea para agregar dos registros A al conjunto de registros. El comando final usa el cmdlet Set-AzDnsRecordSet para confirmar la actualización.

Ejemplo 2: Actualización de un registro SOA

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType SOA -Zone $Zone
$RecordSet.Records[0].Email = "admin.myzone.com"
Set-AzDnsRecordSet -RecordSet $RecordSet

El primer comando usa el cmdlet Get-AzDnsRecordset para obtener el conjunto de registros especificado y, a continuación, lo almacena en la variable $RecordSet. El segundo comando actualiza el registro SOA especificado en $RecordSet. El comando final usa el cmdlet Set-AzDnsRecordSet para propagar la actualización en $RecordSet.

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

-Overwrite

Indica que se actualiza el conjunto de registros independientemente de los cambios simultáneos. El conjunto de registros no se actualizará si se ha cambiado en Azure DNS desde que se recuperó el objeto RecordSet local. Esto proporciona protección para los cambios simultáneos. Para suprimir este comportamiento, puede usar el parámetro Overwrite , que da como resultado que el conjunto de registros se actualice 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

-RecordSet

Especifica el objeto RecordSet que se va a actualizar.

Tipo:DnsRecordSet
Posición:Named
Valor predeterminado:None
Requerido:True
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

Entradas

DnsRecordSet

Salidas

DnsRecordSet

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.