Get-AzDnsRecordSet

  • Référence
Module:
Az.Dns

Obtient un jeu d’enregistrements DNS.

Syntax

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

L’applet de commande Get-AzDnsRecordSet obtient le jeu d’enregistrements DNS (Domain Name System) avec le nom et le type spécifiés, dans la zone spécifiée. Si vous ne spécifiez pas les paramètres Name ou RecordType , cette applet de commande retourne tous les jeux d’enregistrements du type spécifié dans la zone. Si vous spécifiez le paramètre RecordType , mais pas le paramètre Name , cette applet de commande retourne tous les jeux d’enregistrements du type d’enregistrement spécifié. Vous pouvez utiliser l’opérateur de pipeline pour passer un objet DnsZone à cette applet de commande, ou passer un objet DnsZone en tant que paramètre Zone , ou vous pouvez également spécifier la zone et le groupe de ressources par nom.

Exemples

Exemple 1 : Obtenir des jeux d’enregistrements avec un nom et un type spécifiés

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

Cette commande obtient le jeu d’enregistrements du type d’enregistrement A nommé www dans le groupe de ressources et la zone spécifiés, puis le stocke dans la variable $RecordSet. Étant donné que les paramètres Name et RecordType sont spécifiés, un seul objet RecordSet est retourné.

Exemple 2 : Obtenir des jeux d’enregistrements d’un type spécifié

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

Cette commande obtient un tableau de tous les jeux d’enregistrements de type A dans la zone nommée myzone.com dans le groupe de ressources nommé MyResourceGroup, puis les stocke dans la variable $RecordSets.

Exemple 3 : Obtenir tous les jeux d’enregistrements dans une zone

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

Cette commande obtient un tableau de tous les jeux d’enregistrements de la zone nommée myzone.com dans le groupe de ressources nommé MyResourceGroup, puis les stocke dans la variable $RecordSets.

Exemple 4 : Obtenir tous les jeux d’enregistrements d’une zone à l’aide d’un objet DnsZone

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

Cet exemple équivaut à l’exemple 3 ci-dessus. Cette fois, le fuseau est spécifié à l’aide d’un objet de zone.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom du Jeu d’enregistrements à obtenir. Si vous ne spécifiez pas le paramètre Name , tous les jeux d’enregistrements du type spécifié sont retournés.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RecordType

Spécifie le type d’enregistrement DNS que cette applet de commande obtient. Les valeurs valides sont :

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SOA
  • SRV
  • TXT Si vous ne spécifiez pas le paramètre RecordType , vous devez également omettre le paramètre Name . Cette applet de commande retourne ensuite tous les jeux d’enregistrements dans la zone (de tous les noms et types).
Type:Nullable<T>[RecordType]
Accepted values:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Spécifie le groupe de ressources qui contient la zone DNS. Le nom de la zone doit également être spécifié à l’aide du paramètre ZoneName . Vous pouvez également spécifier la zone et le groupe de ressources en transmettant un objet DnsZone à l’aide du paramètre Zone .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Zone

Spécifie la zone DNS qui contient le jeu d’enregistrements que cette applet de commande obtient. Vous pouvez également spécifier la zone à l’aide des paramètres ZoneName et ResourceGroupName .

Type:DnsZone
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ZoneName

Spécifie le nom de la zone DNS qui contient le jeu d’enregistrements à obtenir. Le groupe de ressources contenant la zone doit également être spécifié à l’aide du paramètre ResourceGroupName . Vous pouvez également spécifier la zone et le groupe de ressources en transmettant un objet zone DNS à l’aide du paramètre Zone .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

DnsZone

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

Sorties

DnsRecordSet