Compartilhar via

Set-AzDnsRecordSet

  • Referência
Módulo:
Az.Dns

Atualiza um conjunto de registros DNS.

Syntax

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

Description

O cmdlet Set-AzDnsRecordSet atualiza um conjunto de registros no serviço DNS do Azure a partir de um objeto RecordSet local. Você pode passar um objeto RecordSet como um parâmetro ou usando o operador de pipeline. Você pode usar o parâmetro Confirm e $ConfirmPreference variável do Windows PowerShell para controlar se o cmdlet solicita a confirmação. O conjunto de registros não será atualizado se tiver sido alterado no DNS do Azure desde que o objeto RecordSet local foi recuperado. Isso fornece proteção para alterações simultâneas. Você pode suprimir esse comportamento usando o parâmetro Overwrite , que atualiza o conjunto de registros independentemente de alterações simultâneas.

Exemplos

Exemplo 1: Atualizar um 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

O primeiro comando usa o cmdlet Get-AzDnsRecordSet para obter o conjunto de registros especificado e o armazena na variável $RecordSet. O segundo e o terceiro comandos são operações off-line para adicionar dois registros A ao conjunto de registros. O comando final usa o cmdlet Set-AzDnsRecordSet para confirmar a atualização.

Exemplo 2: Atualizar um 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

O primeiro comando usa o cmdlet Get-AzDnsRecordset para obter o conjunto de registros especificado e o armazena na variável $RecordSet. O segundo comando atualiza o registro SOA especificado no $RecordSet. O comando final usa o cmdlet Set-AzDnsRecordSet para propagar a atualização em $RecordSet.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor padrão:False
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

Indica para atualizar o conjunto de registros, independentemente de alterações simultâneas. O conjunto de registros não será atualizado se tiver sido alterado no DNS do Azure desde que o objeto RecordSet local foi recuperado. Isso fornece proteção para alterações simultâneas. Para suprimir esse comportamento, você pode usar o parâmetro Overwrite , que resulta na atualização do conjunto de registros, independentemente de alterações simultâneas.

Tipo:SwitchParameter
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

Especifica o RecordSet a ser atualizado.

Tipo:DnsRecordSet
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado. Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor padrão:False
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

DnsRecordSet

Saídas

DnsRecordSet

Observações

Você pode usar o parâmetro Confirm para controlar se esse cmdlet solicita confirmação. Por padrão, o cmdlet solicita a confirmação se a variável $ConfirmPreference do Windows PowerShell tiver um valor Médio ou inferior. Se você especificar Confirm ou Confirm:$True, esse cmdlet solicitará a confirmação antes de ser executado. Se você especificar Confirm:$False, o cmdlet não solicitará a confirmação.