Compartilhar via

Get-AzPrivateDnsZone

  • Referência
Módulo:
Az.PrivateDns

Obtém uma zona DNS privada.

Sintaxe

Get-AzPrivateDnsZone
   [-ResourceGroupName <String>]
   [-Name <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzPrivateDnsZone obtém uma zona DNS (Sistema de Nomes de Domínio Privado) do grupo de recursos especificado. Se você especificar o parâmetro Name, um único objeto PrivateDnsZone será retornado. Se você não especificar o parâmetro Name, uma matriz que contém todas as zonas no grupo de recursos especificado será retornada. Você pode usar o objeto PrivateDnsZone para atualizar a zona, por exemplo, você pode adicionar objetos RecordSet a ele.

Exemplos

Exemplo 1: Obter uma zona

$Zone = Get-AzPrivateDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com"

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                          : {}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

Este exemplo obtém a zona DNS privada chamada myzone.com do grupo de recursos especificado e, em seguida, a armazena na variável $Zone.

Exemplo 2: Obter todas as zonas em um grupo de recursos

$Zones = Get-AzPrivateDnsZone -ResourceGroupName "MyResourceGroup"

Name                  : zone1.com
ResourceId            : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Micros
                        oft.Network/privateDnsZones/zone1.com
ResourceGroupName     : MyResourceGroup
Location              :
Etag                  : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                  :
NumberOfRecordSets    : 1
MaxNumberOfRecordSets : 5000

Name                  : zone2.com
ResourceId            : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Micros
                        oft.Network/privateDnsZones/zone2.com
ResourceGroupName     : MyResourceGroup
Location              :
Etag                  : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                  :
NumberOfRecordSets    : 1
MaxNumberOfRecordSets : 5000

Este exemplo obtém todas as zonas DNS privadas no grupo de recursos especificado e, em seguida, armazena-as na variável $Zones.

Exemplo 3: Obter todas as zonas em uma assinatura

$Zones = Get-AzPrivateDnsZone

Name                  : zone1.com
ResourceId            : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup1/providers/Micros
                        oft.Network/privateDnsZones/zone1.com
ResourceGroupName     : MyResourceGroup1
Location              :
Etag                  : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                  :
NumberOfRecordSets    : 1
MaxNumberOfRecordSets : 5000

Name                  : zone2.com
ResourceId            : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup2/providers/Micros
                        oft.Network/privateDnsZones/zone2.com
ResourceGroupName     : MyResourceGroup2
Location              :
Etag                  : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                  :
NumberOfRecordSets    : 1
MaxNumberOfRecordSets : 5000

Este exemplo obtém todas as zonas DNS privadas na assinatura atual do Azure e as armazena na variável $Zones.

Parâmetros

-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 a ser acessada. Se você não especificar um valor para o parâmetro Name, esse cmdlet obterá todas as zonas DNS privadas no grupo de recursos especificado. Se você também omitir o parâmetro ResourceGroupName, esse cmdlet obterá todas as zonas DNS privadas na assinatura atual do Azure.

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

-ResourceGroupName

Especifica o nome do grupo de recursos que contém a zona DNS privada a ser acessada. Se você não especificar o ResourceGroupName, também deverá omitir o parâmetro nome do. Nesse caso, esse cmdlet obtém todas as zonas DNS privadas na assinatura atual do Azure.

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

Entradas

None

Saídas