Partilhar via


Get-AzPrivateDnsRecordSet

Obtém um conjunto de registros de uma zona DNS privada.

Sintaxe

Get-AzPrivateDnsRecordSet
   -ResourceGroupName <String>
   -ZoneName <String>
   [-RecordType <RecordType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPrivateDnsRecordSet
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   -RecordType <RecordType>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPrivateDnsRecordSet
   -Zone <PSPrivateDnsZone>
   -Name <String>
   -RecordType <RecordType>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPrivateDnsRecordSet
   -Zone <PSPrivateDnsZone>
   [-RecordType <RecordType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPrivateDnsRecordSet
   -ParentResourceId <String>
   -Name <String>
   -RecordType <RecordType>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPrivateDnsRecordSet
   -ParentResourceId <String>
   [-RecordType <RecordType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzPrivateDnsRecordSet obtém o conjunto de registros DNS (Sistema de Nomes de Domínio Privado) com o nome e o tipo especificados na zona privada especificada. Se você não especificar os parâmetros Name ou RecordType, esse cmdlet retornará todos os conjuntos de registros do tipo especificado na zona privada. Se você especificar o parâmetro RecordType, mas não o parâmetro Name, esse cmdlet retornará todos os conjuntos de registros do tipo de registro especificado. Você pode usar o operador de pipeline para passar um objeto PSPrivateDnsZone para este cmdlet, ou pode passar um objeto PSPrivateDnsZone como o parâmetro Zone ou, alternativamente, pode especificar a zona e o grupo de recursos pelo nome. Você também pode especificar a zona privada usando a ID do recurso da zona privada.

Exemplos

Exemplo 1: Obter conjuntos de registros com um nome e tipo especificados

Get-AzPrivateDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -Name "www" -RecordType A

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

Este comando obtém o conjunto de registros do tipo de registro A chamado www no grupo de recursos especificado e na zona privada e, em seguida, armazena-o na variável $RecordSet. Como os parâmetros Name e RecordType são especificados, apenas um objeto RecordSet é retornado.

Exemplo 2: Obter conjuntos de registros de um tipo especificado

Get-AzPrivateDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -RecordType A

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www1
Name              : www1
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www2
Name              : www2
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {2.3.4.5}
Metadata          :
IsAutoRegistered  :

Este comando obtém uma matriz de todos os conjuntos de registros do tipo de registro A na zona privada chamada myzone.com no grupo de recursos chamado MyResourceGroup e, em seguida, armazena-os na variável $RecordSets.

Exemplo 3: Obter todos os conjuntos de registros em uma zona privada

Get-AzPrivateDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www1
Name              : www1
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www1
Name              : www1
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:DB80:4009:1803::1005}
Metadata          :
IsAutoRegistered  :

Este comando obtém uma matriz de todos os conjuntos de registros na zona privada chamada myzone.com no grupo de recursos chamado MyResourceGroup e, em seguida, armazena-os na variável $RecordSets.

Exemplo 4: Obter todos os conjuntos de registros em uma zona privada, usando um objeto PSPrivateDnsZone

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www1
Name              : www1
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www1
Name              : www1
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:DB80:4009:1803::1005}
Metadata          :
IsAutoRegistered  :

Este exemplo é equivalente ao Exemplo 3 acima. Desta vez, a zona privada é especificada usando um objeto de zona privada.

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

-Name

O nome dos registros neste conjunto de registros (relativo ao nome da zona e sem um ponto de encerramento).

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

-ParentResourceId

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

-RecordType

O tipo de registos DNS neste conjunto de registos.

Tipo:Nullable<T>[RecordType]
Valores aceites:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT, A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

O grupo de recursos ao qual a zona pertence.

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

-Zone

O objeto DnsZone que representa a zona na qual criar o conjunto de registros.

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

-ZoneName

A zona na qual criar o conjunto de registros (sem um ponto de encerramento).

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

Entradas

PSPrivateDnsZone

String

Saídas

PSPrivateDnsRecordSet