Freigeben über

Set-AzDnsRecordSet

  • Referenz
Modul:
Az.Dns

Aktualisiert einen DNS-Eintragssatz.

Syntax

Set-AzDnsRecordSet
   -RecordSet <DnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-AzDnsRecordSet aktualisiert einen Datensatzsatz im Azure DNS-Dienst aus einem lokalen RecordSet--Objekt. Sie können ein RecordSet-objekt als Parameter oder mithilfe des Pipelineoperators übergeben. Sie können den Parameter Bestätigen und $ConfirmPreference Windows PowerShell-Variable verwenden, um zu steuern, ob das Cmdlet Sie zur Bestätigung auffordert. Der Datensatzsatz wird nicht aktualisiert, wenn er seit dem abrufen des lokalen RecordSet-Objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Änderungen. Sie können dieses Verhalten mithilfe des Overwrite-Parameters unterdrücken, der den Datensatzsatz unabhängig von gleichzeitigen Änderungen aktualisiert.

Beispiele

Beispiel 1: Aktualisieren eines Datensatzsatzes

$RecordSet = Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzDnsRecordSet -RecordSet $RecordSet

# These cmdlets can also be piped:

Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A | Add-AzDnsRecordConfig -Ipv4Address 172.16.0.0 | Add-AzDnsRecordConfig -Ipv4Address 172.31.255.255 | Set-AzDnsRecordSet

Der erste Befehl verwendet das Cmdlet Get-AzDnsRecordSet, um den angegebenen Datensatzsatz abzurufen, und speichert ihn dann in der variablen $RecordSet. Die zweiten und dritten Befehle sind Off-Line-Vorgänge, um dem Datensatzsatz zwei A-Datensätze hinzuzufügen. Der letzte Befehl verwendet das cmdlet Set-AzDnsRecordSet cmdlet, um das Update zu übernehmen.

Beispiel 2: Aktualisieren eines SOA-Eintrags

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType SOA -Zone $Zone
$RecordSet.Records[0].Email = "admin.myzone.com"
Set-AzDnsRecordSet -RecordSet $RecordSet

Der erste Befehl verwendet die Get-AzDnsRecordset Cmdlet, um den angegebenen Datensatzsatz abzurufen, und speichert ihn dann in der $RecordSet Variablen. Der zweite Befehl aktualisiert den angegebenen SOA-Eintrag in $RecordSet. Der letzte Befehl verwendet das cmdlet Set-AzDnsRecordSet, um das Update in $RecordSet zu verteilen.

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

-Overwrite

Gibt an, dass der Datensatzsatz unabhängig von gleichzeitigen Änderungen aktualisiert werden soll. Der Datensatzsatz wird nicht aktualisiert, wenn er seit dem abrufen des lokalen RecordSet- objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Änderungen. Um dieses Verhalten zu unterdrücken, können Sie den parameter Overwrite verwenden, was dazu führt, dass der Datensatzsatz unabhängig von gleichzeitigen Änderungen aktualisiert wird.

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

-RecordSet

Gibt das zu aktualisierende RecordSet- an.

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

-WhatIf

Zeigt, was passiert, 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.

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

Eingaben

Ausgaben

Hinweise

Sie können den Parameter Confirm verwenden, um zu 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 Bestätigen oder Confirm:$Trueangeben, werden Sie mit diesem Cmdlet vor der Ausführung zur Bestätigung aufgefordert. Wenn Sie Confirm:$Falseangeben, werden Sie vom Cmdlet nicht zur Bestätigung aufgefordert.