Sdílet prostřednictvím

Set-AzDnsRecordSet

  • Reference
Modul:
Az.Dns

Aktualizace sadu záznamů DNS.

Syntaxe

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

Description

Rutina Set-AzDnsRecordSet aktualizuje sadu záznamů ve službě Azure DNS z místního objektu RecordSet . Objekt RecordSet můžete předat jako parametr nebo pomocí operátoru kanálu. Pomocí parametru Confirm a $ConfirmPreference proměnné Windows PowerShellu můžete určit, jestli vás rutina vyzve k potvrzení. Sada záznamů se neaktualizuje, pokud byla změněna v Azure DNS od načtení místního objektu RecordSet . To zajišťuje ochranu souběžných změn. Toto chování můžete potlačit pomocí parametru Přepsání , který aktualizuje sadu záznamů bez ohledu na souběžné změny.

Příklady

Příklad 1: Aktualizace sady záznamů

$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

První příkaz pomocí rutiny Get-AzDnsRecordSet získá zadanou sadu záznamů a pak ji uloží do proměnné $RecordSet. Druhé a třetí příkazy jsou off-line operace pro přidání dvou záznamů A do sady záznamů. Poslední příkaz použije rutinu Set-AzDnsRecordSet k potvrzení aktualizace.

Příklad 2: Aktualizace záznamu SOA

$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

První příkaz pomocí rutiny Get-AzDnsRecordset získá zadanou sadu záznamů a pak ji uloží do proměnné $RecordSet. Druhý příkaz aktualizuje zadaný záznam SOA v $RecordSet. Poslední příkaz používá rutinu Set-AzDnsRecordSet k rozšíření aktualizace v $RecordSet.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Overwrite

Označuje aktualizaci sady záznamů bez ohledu na souběžné změny. Sada záznamů se neaktualizuje, pokud byla změněna v Azure DNS od načtení místního objektu RecordSet . To zajišťuje ochranu souběžných změn. Pokud chcete toto chování potlačit, můžete použít parametr Přepsat , což vede k aktualizaci sady záznamů bez ohledu na souběžné změny.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RecordSet

Určuje sadu záznamů, která se má aktualizovat.

Typ:DnsRecordSet
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí. Ukazuje, co se stane, když se rutina spustí. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

DnsRecordSet

Výstupy

DnsRecordSet

Poznámky

Pomocí parametru Confirm můžete určit, jestli vás tato rutina vyzve k potvrzení. Ve výchozím nastavení vás rutina vyzve k potvrzení, pokud má proměnná $ConfirmPreference Prostředí Windows PowerShell hodnotu Střední nebo nižší. Pokud zadáte Potvrdit nebo Potvrdit:$True, zobrazí se tato rutina před spuštěním výzvy k potvrzení. Pokud zadáte Confirm :$False, rutina vás k potvrzení nezobrazí.