Set-AzDnsRecordSet
Aktualisiert einen DNS-Eintragssatz.
Syntax
Default (Standard)
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 "Confirm" 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 , 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 das Cmdlet Get-AzDnsRecordset , 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 zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-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 |
-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 Overwrite-Parameter verwenden, der dazu führt, dass der Datensatzsatz unabhängig von gleichzeitigen Änderungen aktualisiert wird.
Parametereigenschaften
| Typ: | SwitchParameter |
| 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 |
-RecordSet
Gibt das zu aktualisierende RecordSet an.
Parametereigenschaften
| Typ: | DnsRecordSet |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
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
DnsRecordSet
Ausgaben
DnsRecordSet
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.
