Set-AzDnsZone
Aktualisiert die Eigenschaften einer DNS-Zone.
Syntax
Set-AzDnsZone
-Name <String>
-ResourceGroupName <String>
[-Tag <Hashtable>]
[-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
[-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzDnsZone
-Name <String>
-ResourceGroupName <String>
[-Tag <Hashtable>]
[-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
[-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzDnsZone
-Zone <DnsZone>
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-AzDnsZone aktualisiert die angegebene DNS-Zone im Azure DNS-Dienst. Mit diesem Cmdlet werden die Datensatzsätze in der Zone nicht aktualisiert. Sie können ein DnsZone-Objekt als Parameter oder mithilfe des Pipelineoperators übergeben oder alternativ die Parameter ZoneName und ResourceGroupName angeben. Sie können den Parameter "Confirm" und $ConfirmPreference Windows PowerShell-Variable verwenden, um zu steuern, ob das Cmdlet Sie zur Bestätigung auffordert. Beim Übergeben einer DNS-Zone als Objekt (mit dem Zone-Objekt oder über die Pipeline) wird sie nicht aktualisiert, wenn sie seit dem Abrufen des lokalen DnsZone-Objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Änderungen. Sie können dieses Verhalten mit dem Parameter Overwrite unterdrücken, der die Zone unabhängig von gleichzeitigen Änderungen aktualisiert.
Beispiele
Beispiel 1: Aktualisieren einer DNS-Zone
$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$Zone.Tags = @(@{"Name"="Dept"; "Value"="Electrical"})
Set-AzDnsZone -Zone $Zone
Der erste Befehl ruft die Zone mit dem Namen myzone.com aus der angegebenen Ressourcengruppe ab und speichert sie dann in der variablen $Zone. Der zweite Befehl aktualisiert die Tags für $Zone. Der letzte Befehl führt einen Commit für die Änderung durch.
Beispiel 2: Aktualisieren von Tags für eine Zone
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com" -Tag @(@{"Name"="Dept"; "Value"="Electrical"})
Mit diesem Befehl werden die Tags für die Zone namens myzone.com aktualisiert, ohne zuerst explizit die Zone zu erhalten.
Beispiel 3: Zuordnen einer privaten Zone zu einem virtuellen Netzwerk durch Angeben der ID
$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetworkId @($vnet.Id)
Dieser Befehl ordnet die Privates DNS Zone myprivatezone.com dem virtuellen Netzwerk myvnet als Registrierungsnetzwerk zu, indem seine ID angegeben wird.
Beispiel 4: Zuordnen einer privaten Zone zu einem virtuellen Netzwerk durch Angeben des Netzwerkobjekts.
$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetwork @($vnet)
Dieser Befehl ordnet die Privates DNS Zone myprivatezone.com dem virtuellen Netzwerk myvnet als Registrierungsnetzwerk zu, indem das durch $vnet Variable dargestellte virtuelle Netzwerkobjekt an das Cmdlet Set-AzDnsZone übergeben wird.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Gibt den Namen der zu aktualisierenden DNS-Zone an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Overwrite
Beim Übergeben einer DNS-Zone als Objekt (mit dem Zone-Objekt oder über die Pipeline) wird sie nicht aktualisiert, wenn sie seit dem Abrufen des lokalen DnsZone-Objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Änderungen. Sie können dieses Verhalten mit dem Parameter Overwrite unterdrücken, der die Zone unabhängig von gleichzeitigen Änderungen aktualisiert.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistrationVirtualNetwork
Die Liste der virtuellen Netzwerke, die Hostnameneinträge virtueller Computer in dieser DNS-Zone registrieren, nur für private Zonen verfügbar.
Type: | List<T>[IResourceReference] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RegistrationVirtualNetworkId
Die Liste der virtuellen Netzwerk-IDs, die Hostnamen für virtuelle Computer in dieser DNS-Zone registrieren, nur für private Zonen verfügbar.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResolutionVirtualNetwork
Die Liste der virtuellen Netzwerke, die Einträge in dieser DNS-Zone auflösen können, nur für private Zonen verfügbar.
Type: | List<T>[IResourceReference] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResolutionVirtualNetworkId
Die Liste der virtuellen Netzwerk-IDs, die Datensätze in dieser DNS-Zone auflösen können, nur für private Zonen verfügbar.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 Zone mithilfe eines DnsZone-Objekts mit dem Parameter Zone oder der Pipeline angeben.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}
Type: | Hashtable |
Aliases: | Tags |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Gibt die zu aktualisierende DNS-Zone an. Alternativ können Sie die Zone mit den Parametern ZoneName und ResourceGroupName angeben.
Type: | DnsZone |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
Ausgaben
Hinweise
Mit dem Parameter "Confirm" können Sie steuern, ob dieses Cmdlet Sie zur Bestätigung auffordert. Standardmäßig werden Sie vom Cmdlet zur Bestätigung aufgefordert, wenn die $ConfirmPreference Windows PowerShell-Variable den Wert "Mittel" oder "niedriger" aufweist. Wenn Sie "Confirm" oder "Confirm:$True" angeben, werden Sie mit diesem Cmdlet vor der Ausführung zur Bestätigung aufgefordert. Wenn Sie "Confirm:$False" angeben, werden Sie vom Cmdlet nicht zur Bestätigung aufgefordert.
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für