Partilhar via

Get-AzDnsRecordSet

  • Referência
Módulo:
Az.Dns

Obtém um conjunto de registros DNS.

Sintaxe

Get-AzDnsRecordSet
   [-Name <String>]
   -ZoneName <String>
   -ResourceGroupName <String>
   [-RecordType <RecordType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDnsRecordSet
   [-Name <String>]
   -Zone <DnsZone>
   [-RecordType <RecordType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzDnsRecordSet obtém o conjunto de registros DNS (Sistema de Nomes de Domínio) com o nome e o tipo especificados na zona 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. 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 DnsZone para este cmdlet, ou pode passar um objeto DnsZone como o parâmetro Zone ou, alternativamente, pode especificar a zona e o grupo de recursos pelo nome.

Exemplos

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

$RecordSet = Get-AzDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -Name "www" -RecordType A

Este comando obtém o conjunto de registros do tipo de registro A chamado www no grupo de recursos e na zona especificados 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

$RecordSets = Get-AzDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -RecordType A

Este comando obtém uma matriz de todos os conjuntos de registros do tipo de registro A na zona 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

$RecordSets = Get-AzDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"

Este comando obtém uma matriz de todos os conjuntos de registros na zona 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, usando um objeto DnsZone

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSets = Get-AzDnsRecordSet -Zone $Zone

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

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

Especifica o nome do RecordSet a ser obtido. Se você não especificar o parâmetro Name , todos os conjuntos de registros do tipo especificado serão retornados.

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

-RecordType

Especifica o tipo de registro DNS que esse cmdlet obtém. Os valores válidos são:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SOA
  • SRV
  • TXT Se você não especificar o parâmetro RecordType , também deverá omitir o parâmetro Name . Em seguida, esse cmdlet retorna todos os conjuntos de registros na zona (de todos os nomes e tipos).
Tipo:Nullable<T>[RecordType]
Valores aceites:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

Especifica o grupo de recursos que contém a zona DNS. O nome da zona também deve ser especificado, usando o parâmetro ZoneName . Como alternativa, você pode especificar a zona e o grupo de recursos passando um objeto DnsZone usando o parâmetro Zone .

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

-Zone

Especifica a zona DNS que contém o conjunto de registros obtido por esse cmdlet. Como alternativa, você pode especificar a zona usando os parâmetros ZoneName e ResourceGroupName .

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

-ZoneName

Especifica o nome da zona DNS que contém o conjunto de registros a ser obtido. O grupo de recursos que contém a zona também deve ser especificado, usando o parâmetro ResourceGroupName . Como alternativa, você pode especificar a zona e o grupo de recursos passando um objeto DNS Zone usando o parâmetro Zone .

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

Entradas

String

DnsZone

Nullable<T>[[Microsoft.Azure.Management.Dns.Models.RecordType, Microsoft.Azure.Management.Dns, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Saídas

DnsRecordSet