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 "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 $RecordSet Variablen. 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 variablen $RecordSet. 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

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

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

Gibt das zu aktualisierende RecordSet an.

Type:DnsRecordSet
Position:Named
Default value:None
Required:True
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

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.