Set-AzPrivateDnsRecordSet
Atualizações/Define um conjunto de registros em uma zona DNS privada.
Sintaxe
Set-AzPrivateDnsRecordSet
-RecordSet <PSPrivateDnsRecordSet>
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Set-AzPrivateDnsRecordSet atualiza um conjunto de registros no serviço DNS Privado 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 Privado 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-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 :
O primeiro comando usa o cmdlet Get-AzPrivateDnsRecordSet para obter o conjunto de registros especificado e, em seguida, armazena-o na variável $RecordSet. O segundo e terceiro comandos são operações off-line para adicionar dois registros A ao conjunto de registros. O comando final usa o cmdlet Set-AzPrivateDnsRecordSet para confirmar a atualização.
Exemplo 2: Atualizar um 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 :
O primeiro comando usa o cmdlet Get-AzPrivateDnsRecordSet 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-AzPrivateDnsRecordSet para propagar a atualização no $RecordSet.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Overwrite
Não use o campo ETag do parâmetro RecordSet para verificações de simultaneidade otimistas.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-RecordSet
O conjunto de registros no qual adicionar o registro.
Tipo: | PSPrivateDnsRecordSet |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
Saídas
Azure PowerShell