Freigeben über

Set-AzPrivateDnsZone

  • Referenz
Modul:
Az.PrivateDns

Aktualisiert eine private DNS-Zone aus einer Ressourcengruppe.

Syntax

Set-AzPrivateDnsZone
   -ResourceGroupName <String>
   -Name <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -ResourceId <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -PrivateZone <PSPrivateDnsZone>
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-AzPrivateDnsZone cmdlet aktualisiert dauerhaft eine private Dns-Zone (Domain Name System) aus einer angegebenen Ressourcengruppe. Sie können ein PrivateDnsZone-objekt übergeben, indem Sie den parameter PrivateZone oder den Pipelineoperator verwenden, oder alternativ können Sie den Name und ResourceGroupName Parameter angeben. Sie können den Parameter "Confirm" und $ConfirmPreference Windows PowerShell-Variable verwenden, um zu steuern, ob das Cmdlet Sie zur Bestätigung auffordert. Wenn Sie die Zone mithilfe eines PrivateDnsZone -Objekts angeben (übergeben über die Pipeline oder Zone Parameter), wird die Zone nicht aktualisiert, wenn sie in Azure DNS geändert wurde, da das lokale PrivateDnsZone Objekt abgerufen wurde (nur Vorgänge direkt bei der DNS-Zonenressourcenanzahl als Änderungen, Vorgänge für Datensatzsätze innerhalb der Zone nicht). Dies bietet Schutz für gleichzeitige Zonenänderungen. Dies kann mithilfe des parameters Overwrite unterdrückt werden, der die Zone unabhängig von gleichzeitigen Änderungen aktualisiert.

Beispiele

Beispiel 1: Aktualisiert eine private Zone

Set-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup" -Tag @{tag1="value1";tag2="value2"}

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                          : {tag1="value1";tag2="value2"}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

Mit diesem Befehl wird die Zone namens myzone.com aus der Ressourcengruppe "MyResourceGroup" mit den bereitgestellten Tags aktualisiert. Verwenden Sie Get-AzPrivateDnsZone, um die aktualisierte Zone abzurufen.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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 privaten DNS-Zone an, die dieses Cmdlet aktualisiert. Sie müssen auch den parameter ResourceGroupName angeben. Alternativ können Sie die private DNS-Zone mit dem Parameter Zone angeben.

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

-Overwrite

Wenn Sie die Zone mithilfe eines PrivateDnsZone- Objekts angeben (das über die Pipeline oder Zone Parameter übergeben wird), wird die Zone nicht aktualisiert, wenn sie in Azure DNS geändert wurde, da das lokale DnsZone-Objekt abgerufen wurde (nur Vorgänge direkt bei der DNS-Zonenressource zählen als Änderungen, Vorgänge für Datensatzsätze innerhalb der Zone nicht). Dies bietet Schutz für gleichzeitige Zonenänderungen. Dies kann mithilfe des parameters Overwrite unterdrückt werden, der die Zone unabhängig von gleichzeitigen Änderungen aktualisiert.

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

-PrivateZone

Das festzulegende Zone-Objekt.

Typ:PSPrivateDnsZone
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, die die zu aktualisierende Zone enthält. Sie müssen auch den parameter ZoneName angeben. Alternativ können Sie die private DNS-Zone mithilfe eines DnsZone--Objekts angeben, das entweder über die Pipeline oder den parameter Zone übergeben wird.

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

-ResourceId

Private DNS Zone ResourceID.

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

-Tag

Eine Hashtabelle, die Ressourcentags darstellt.

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

PSPrivateDnsZone

Ausgaben

PSPrivateDnsZone