Sdílet prostřednictvím

Set-AzPrivateDnsZone

  • Reference
Modul:
Az.PrivateDns

Aktualizuje zónu privátního DNS ze skupiny prostředků.

Syntaxe

Set-AzPrivateDnsZone
   -ResourceGroupName <String>
   -Name <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -ResourceId <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -PrivateZone <PSPrivateDnsZone>
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzPrivateDnsZone trvale aktualizuje privátní zónu DNS (Domain Name System) ze zadané skupiny prostředků. Objekt PrivateDns Zone můžete předat pomocí parametru PrivateZone nebo pomocí operátoru kanálu, případně můžete zadat parametry Name a ResourceGroupName. Pomocí parametru Confirm a $ConfirmPreference proměnné Prostředí Windows PowerShell můžete určit, jestli vás rutina vyzve k potvrzení. Při zadávání zóny pomocí PrivateDnsZone objektu (předaného prostřednictvím kanálu nebo parametru Zone) se zóna neaktualizuje, pokud byla změněna v Azure DNS, protože se načetla místní PrivateDnsZone objektu (operace přímo s prostředkem zóny DNS se čítají jako změny, operace se sadami záznamů v rámci zóny ne). To poskytuje ochranu pro souběžné změny zóny. To lze potlačit pomocí parametru Přepsat, který aktualizuje zónu bez ohledu na souběžné změny.

Příklady

Příklad 1: Aktualizace privátní zóny

Set-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup" -Tag @{tag1="value1";tag2="value2"}

Name                          : myzone.com
ResourceId                    : "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/PrivateZones/myzone.com"
ResourceGroupName             : MyResourceGroup
Location					  : 
Etag                          : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                          : {tag1="value1";tag2="value2"}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

Tento příkaz aktualizuje zónu s názvem myzone.com ze skupiny prostředků MyResourceGroup s poskytnutými značkami. K načtení aktualizované zóny použijte Get-AzPrivateDnsZone.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve 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 privátního DNS, kterou tato rutina aktualizuje. Musíte také zadat parametr ResourceGroupName. Alternativně můžete zadat privátní zónu DNS pomocí parametru Zone.

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

-Overwrite

Při zadávání zóny pomocí objektu PrivateDnsZone (předaného prostřednictvím kanálu nebo parametru Zone) se zóna neaktualizuje, pokud byla změněna v Azure DNS, protože se načetla místní Objekt DnsZone (operace přímo s prostředkem zóny DNS se počítají jako změny, operace se sadami záznamů v rámci zóny ne). To poskytuje ochranu pro souběžné změny zóny. To lze potlačit pomocí parametru Přepsat, 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

-PrivateZone

Objekt zóny, který chcete nastavit.

Typ:PSPrivateDnsZone
Position:Named
Default value:None
Vyžadováno:True
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. Alternativně můžete určit privátní zónu DNS pomocí objektu DnsZone předaného prostřednictvím kanálu nebo parametru Zone.

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

-ResourceId

ID prostředku privátní zóny DNS.

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

-Tag

Tabulka hash, která představuje značky prostředků.

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

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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

String

PSPrivateDnsZone

Výstupy

PSPrivateDnsZone