Share via

Set-AzDnsRecordSet

  • Referencia
Módulo:
Az.Dns

Novedades un conjunto de registros DNS.

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

Especifica el objeto RecordSet que se va a actualizar.

Type:DnsRecordSet
Position:Named
Default value:None
Required:True
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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.