Sdílet prostřednictvím

Set-AzDnsZone

  • Reference
Modul:
Az.Dns

Aktualizuje vlastnosti zóny DNS.

Syntaxe

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

Description

Rutina Set-AzDnsZone aktualizuje zadanou zónu DNS ve službě Azure DNS. Tato rutina neaktualizuje sady záznamů v zóně. Objekt DnsZone můžete předat jako parametr nebo pomocí operátoru kanálu, případně můžete zadat parametry ZoneName a ResourceGroupName. Pomocí parametru Confirm a $ConfirmPreference proměnné Windows PowerShellu můžete určit, jestli vás rutina vyzve k potvrzení. Při předávání zóny DNS jako objektu (pomocí objektu Zone nebo prostřednictvím kanálu) se neaktualizuje, pokud se změnila v Azure DNS od načtení místního objektu DnsZone. To zajišťuje ochranu souběžných změn. Toto chování můžete potlačit pomocí parametru Přepsání , který aktualizuje zónu bez ohledu na souběžné změny.

Příklady

Příklad 1: Aktualizace zóny DNS

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$Zone.Tags = @(@{"Name"="Dept"; "Value"="Electrical"})
Set-AzDnsZone -Zone $Zone

První příkaz získá zónu s názvem myzone.com ze zadané skupiny prostředků a uloží ji do proměnné $Zone. Druhý příkaz aktualizuje značky pro $Zone. Poslední příkaz potvrdí změnu.

Příklad 2: Aktualizace značek pro zónu

Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com" -Tag @(@{"Name"="Dept"; "Value"="Electrical"})

Tento příkaz aktualizuje značky zóny s názvem myzone.com bez explicitního získání zóny.

Příklad 3: Přidružení privátní zóny k virtuální síti zadáním jeho ID

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetworkId @($vnet.Id)

Tento příkaz přidruží Privátní DNS zónu myprivatezone.com k virtuální síti myvnet jako registrační síť zadáním jeho ID.

Příklad 4: Přidružení privátní zóny k virtuální síti zadáním objektu sítě

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetwork @($vnet)

Tento příkaz přidruží Privátní DNS zónu myprivatezone.com k virtuální síti myvnet jako registrační síť předáním objektu virtuální sítě reprezentované $vnet proměnnou do rutiny Set-AzDnsZone.

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

-Name

Určuje název zóny DNS, která se má aktualizovat.

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

-Overwrite

Při předávání zóny DNS jako objektu (pomocí objektu Zone nebo prostřednictvím kanálu) se neaktualizuje, pokud se změnila v Azure DNS od načtení místního objektu DnsZone. To zajišťuje ochranu souběžných změn. Toto chování můžete potlačit pomocí parametru Přepsání , který aktualizuje zónu 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

-RegistrationVirtualNetwork

Seznam virtuálních sítí, které budou registrovat záznamy názvů hostitelů virtuálních počítačů v této zóně DNS, jsou k dispozici pouze pro privátní zóny.

Typ:List<T>[IResourceReference]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RegistrationVirtualNetworkId

Seznam ID virtuálních sítí, které budou registrovat záznamy názvů hostitelů virtuálních počítačů v této zóně DNS, jsou k dispozici pouze pro privátní zóny.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResolutionVirtualNetwork

Seznam virtuálních sítí schopných přeložit záznamy v této zóně DNS, který je k dispozici pouze pro privátní zóny.

Typ:List<T>[IResourceReference]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResolutionVirtualNetworkId

Seznam ID virtuálních sítí schopných přeložit záznamy v této zóně DNS, který je k dispozici pouze pro privátní zóny.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, která obsahuje zónu, která se má aktualizovat. Musíte také zadat parametr ZoneName. Případně můžete zónu zadat pomocí objektu DnsZone s parametrem Zone nebo kanálem.

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

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tags
Position:Named
Default value:None
Vyžadováno:False
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

-Zone

Určuje zónu DNS, která se má aktualizovat. Případně můžete zónu zadat pomocí parametrů ZoneName a ResourceGroupName .

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

Vstupy

String

Hashtable

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

DnsZone

Výstupy

DnsZone

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