Set-AzDnsRecordSet
Atualiza um conjunto de registros DNS.
Sintaxe
Default (Default)
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 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 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 das 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, em seguida, armazena-o 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, em seguida, armazena-o 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 no $RecordSet.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Propriedades do parâmetro
| Tipo: | IAzureContextContainer |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Overwrite
Indica atualizar o conjunto de registros independentemente das 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 das alterações simultâneas.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecordSet
Especifica o RecordSet a ser atualizado.
Propriedades do parâmetro
| Tipo: | DnsRecordSet |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
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 solicitará confirmação se a variável $ConfirmPreference Windows PowerShell tiver um valor médio ou inferior. Se você especificar Confirmar ou Confirmar:$True, esse cmdlet solicitará a confirmação antes de ser executado. Se você especificar Confirm:$False, o cmdlet não solicitará confirmação.
