Compartir a través de


Set-AzPrivateDnsRecordSet

Actualiza o establece un conjunto de registros en una zona DNS privada.

Sintaxis

Set-AzPrivateDnsRecordSet
   -RecordSet <PSPrivateDnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzPrivateDnsRecordSet actualiza un conjunto de registros en el servicio DNS privado 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 DNS privado de Azure 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-AzPrivateDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# These cmdlets can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 172.16.0.0, 172.31.255.255}
Metadata          :
IsAutoRegistered  :

El primer comando usa el cmdlet Get-AzPrivateDnsRecordSet 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-AzPrivateDnsRecordSet para confirmar la actualización.

Ejemplo 2: Actualización de un registro SOA

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SOA/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : Myresourcegroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SOA
Records           : {[internal.cloudapp.net,admin.myzone.com,3600,300,2419200,300]}
Metadata          :
IsAutoRegistered  :

El primer comando usa el cmdlet Get-AzPrivateDnsRecordSet 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-AzPrivateDnsRecordSet para propagar la actualización en $RecordSet.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
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

No use el campo ETag del parámetro RecordSet para las comprobaciones de simultaneidad optimista.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RecordSet

Conjunto de registros en el que se va a agregar el registro.

Tipo:PSPrivateDnsRecordSet
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 el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSPrivateDnsRecordSet

Salidas

PSPrivateDnsRecordSet