Freigeben über

Get-AzPrivateDnsZone

  • Referenz
Modul:
Az.PrivateDns

Ruft eine private DNS-Zone ab.

Syntax

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

Beschreibung

Das Cmdlet Get-AzPrivateDnsZone Cmdlet ruft eine DNS-Zone (Private Domain Name System) aus der angegebenen Ressourcengruppe ab. Wenn Sie den Parameter Name angeben, wird ein einzelnes PrivateDnsZone--Objekt zurückgegeben. Wenn Sie den parameter Name nicht angeben, wird ein Array zurückgegeben, das alle Zonen in der angegebenen Ressourcengruppe enthält. Sie können das PrivateDnsZone-objekt verwenden, um die Zone zu aktualisieren, z. B. können Sie RecordSet- Objekte hinzufügen.

Beispiele

Beispiel 1: Abrufen einer Zone

$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

In diesem Beispiel wird die private DNS-Zone namens myzone.com aus der angegebenen Ressourcengruppe abgerufen und anschließend in der $Zone Variablen gespeichert.

Beispiel 2: Abrufen aller Zonen in einer Ressourcengruppe

$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

In diesem Beispiel werden alle privaten DNS-Zonen in der angegebenen Ressourcengruppe abgerechnet und anschließend in der variablen $Zones gespeichert.

Beispiel 3: Abrufen aller Zonen in einem Abonnement

$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

In diesem Beispiel werden alle privaten DNS-Zonen im aktuellen Azure-Abonnement und anschließend in der variablen $Zones gespeichert.

Parameter

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der abzurufenden privaten DNS-Zone an. Wenn Sie keinen Wert für den Parameter Name angeben, ruft dieses Cmdlet alle privaten DNS-Zonen in der angegebenen Ressourcengruppe ab. Wenn Sie auch den parameter ResourceGroupName weglassen, ruft dieses Cmdlet alle privaten DNS-Zonen im aktuellen Azure-Abonnement ab.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, die die abzurufende private DNS-Zone enthält. Wenn Sie den ResourceGroupName-nicht angeben, müssen Sie auch den Parameter Name weglassen. In diesem Fall ruft dieses Cmdlet alle privaten DNS-Zonen im aktuellen Azure-Abonnement ab.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

PSPrivateDnsZone