Freigeben über


Get-AzPrivateDnsZone

Ruft eine private DNS-Zone ab.

Syntax

Default (Standard)

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

Beschreibung

Das Cmdlet Get-AzPrivateDnsZone 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 mit allen Zonen in der angegebenen Ressourcengruppe zurückgegeben. Sie können das PrivateDnsZone-Objekt verwenden, um die Zone zu aktualisieren, z. B. können Sie ihr 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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

PSPrivateDnsZone