Compartilhar via

Set-AzPrivateDnsZone

  • Referência
Módulo:
Az.PrivateDns

Atualiza uma zona DNS privada de um grupo de recursos.

Sintaxe

Set-AzPrivateDnsZone
   -ResourceGroupName <String>
   -Name <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -ResourceId <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -PrivateZone <PSPrivateDnsZone>
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzPrivateDnsZone atualiza permanentemente uma zona DNS (Sistema de Nomes de Domínio) privada de um grupo de recursos especificado. Você pode passar um objeto PrivateDnsZone usando o parâmetro PrivateZone ou usando o operador de pipeline ou, como alternativa, você pode especificar os parâmetros de Nome e ResourceGroupName. Você pode usar o parâmetro Confirm e $ConfirmPreference variável do Windows PowerShell para controlar se o cmdlet solicita confirmação. Ao especificar a zona usando um objeto PrivateDnsZone (passado por meio do pipeline ou do parâmetro zona), a zona não será atualizada se tiver sido alterada no DNS do Azure desde que o objeto PrivateDnsZone do local foi recuperado (somente operações diretamente na contagem de recursos de zona DNS como alterações, operações em conjuntos de registros dentro da zona não). Isso fornece proteção para alterações de zona simultâneas. Isso pode ser suprimido usando o parâmetro Substituir, que atualiza a zona independentemente das alterações simultâneas.

Exemplos

Exemplo 1: atualiza uma zona privada

Set-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup" -Tag @{tag1="value1";tag2="value2"}

Name                          : myzone.com
ResourceId                    : "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/PrivateZones/myzone.com"
ResourceGroupName             : MyResourceGroup
Location					  : 
Etag                          : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                          : {tag1="value1";tag2="value2"}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

Esse comando atualiza a zona chamada myzone.com do grupo de recursos chamado MyResourceGroup com as marcas fornecidas. Use Get-AzPrivateDnsZone para recuperar a zona atualizada.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome da zona DNS privada que este cmdlet atualiza. Você também deve especificar o parâmetro ResourceGroupName. Como alternativa, você pode especificar a zona DNS privada usando o parâmetro Zone.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Overwrite

Ao especificar a zona usando um objeto PrivateDnsZone (passado por meio do pipeline ou do parâmetro zona de), a zona não será atualizada se tiver sido alterada no DNS do Azure desde que o objeto DnsZone de local foi recuperado (somente operações diretamente na contagem de recursos de zona DNS como alterações, operações em conjuntos de registros dentro da zona não). Isso fornece proteção para alterações de zona simultâneas. Isso pode ser suprimido usando o parâmetro Substituir, que atualiza a zona independentemente das alterações simultâneas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrivateZone

O objeto de zona a ser definido.

Tipo:PSPrivateDnsZone
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos que contém a zona a ser atualizada. Você também deve especificar o parâmetro ZoneName. Como alternativa, você pode especificar a zona DNS privada usando um objeto DnsZone, passado por meio do pipeline ou do parâmetro zona.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceId

ResourceID de zona DNS privada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tag

Uma tabela de hash que representa marcas de recurso.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Saídas