Partilhar 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 privada do DNS (Sistema de Nomes de Domínio) de um grupo de recursos especificado. Você pode passar um objeto PrivateDnsZone usando o parâmetro PrivateZone ou usando o operador de pipeline ou, alternativamente, pode especificar o Name e parâmetros 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 Zone), a zona não será atualizada se tiver sido alterada no DNS do Azure desde que o objeto PrivateDnsZone local foi recuperado (apenas as operações diretamente no recurso da zona DNS contam como alterações, as 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 Overwrite, que atualiza a zona independentemente de 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

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

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Overwrite

Ao especificar a zona usando um objeto PrivateDnsZone (passado por meio do pipeline ou do parâmetro Zone), a zona não será atualizada se tiver sido alterada no DNS do Azure desde que o objeto DnsZone local foi recuperado (apenas as operações diretamente no recurso da zona DNS contam como alterações, as 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 Overwrite, que atualiza a zona independentemente de alterações simultâneas.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PrivateZone

O objeto de zona a ser definido.

Tipo:PSPrivateDnsZone
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 pelo pipeline ou pelo parâmetro Zone.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceId

ID de Recursos da Zona DNS Privada.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Tag

Uma tabela de hash que representa marcas de recursos.

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
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:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

PSPrivateDnsZone

Saídas

PSPrivateDnsZone