Set-AzDnsZone

  • Riferimento
Modulo:
Az.Dns

Aggiornamenti le proprietà di una zona DNS.

Sintassi

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

Descrizione

Il cmdlet Set-AzDnsZone aggiorna la zona DNS specificata nel servizio DNS di Azure. Questo cmdlet non aggiorna i set di record nella zona. È possibile passare un oggetto DnsZone come parametro o usando l'operatore pipeline oppure, in alternativa, è possibile specificare i parametri ZoneName e ResourceGroupName . È possibile usare il parametro Confirm e $ConfirmPreference variabile di Windows PowerShell per controllare se il cmdlet richiede la conferma. Quando si passa una zona DNS come oggetto (usando l'oggetto Zone o tramite la pipeline), non viene aggiornata se è stata modificata in DNS di Azure dopo il recupero dell'oggetto DnsZone locale. In questo modo viene fornita la protezione per le modifiche simultanee. È possibile eliminare questo comportamento con il parametro Sovrascrivi , che aggiorna la zona indipendentemente dalle modifiche simultanee.

Esempio

Esempio 1: Aggiornare una zona DNS

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

Il primo comando ottiene la zona denominata myzone.com dal gruppo di risorse specificato e quindi la archivia nella variabile $Zone. Il secondo comando aggiorna i tag per $Zone. Il comando finale esegue il commit della modifica.

Esempio 2: Aggiornare i tag per una zona

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

Questo comando aggiorna i tag per la zona denominata myzone.com senza prima ottenere esplicitamente la zona.

Esempio 3: Associazione di una zona privata a una rete virtuale specificandone l'ID

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

Questo comando associa la zona DNS privato myprivatezone.com alla rete virtuale myvnet come rete di registrazione specificandone l'ID.

Esempio 4: Associazione di una zona privata a una rete virtuale specificando l'oggetto di rete.

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

Questo comando associa la zona DNS privato myprivatezone.com alla rete virtuale myvnet come rete di registrazione passando l'oggetto di rete virtuale rappresentato dalla variabile $vnet al cmdlet Set-AzDnsZone.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome della zona DNS da aggiornare.

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

-Overwrite

Quando si passa una zona DNS come oggetto (usando l'oggetto Zone o tramite la pipeline), non viene aggiornata se è stata modificata in DNS di Azure dopo il recupero dell'oggetto DnsZone locale. In questo modo viene fornita la protezione per le modifiche simultanee. È possibile eliminare questo comportamento con il parametro Sovrascrivi , che aggiorna la zona indipendentemente dalle modifiche simultanee.

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

-RegistrationVirtualNetwork

Elenco di reti virtuali che registreranno i record dei nomi host delle macchine virtuali in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RegistrationVirtualNetworkId

Elenco di ID di rete virtuale che registreranno i record dei nomi host delle macchine virtuali in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetwork

Elenco di reti virtuali in grado di risolvere i record in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetworkId

Elenco di ID di rete virtuale in grado di risolvere i record in questa zona DNS, disponibile solo per le zone private.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Specifica il nome del gruppo di risorse che contiene la zona da aggiornare. È inoltre necessario specificare il parametro ZoneName. In alternativa, è possibile specificare la zona usando un oggetto DnsZone con il parametro Zone o la pipeline.

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

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito. Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

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

-Zone

Specifica la zona DNS da aggiornare. In alternativa, è possibile specificare la zona usando i parametri ZoneName e ResourceGroupName .

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

Input

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

Output

DnsZone

Note

È possibile usare il parametro Confirm per controllare se questo cmdlet richiede la conferma. Per impostazione predefinita, il cmdlet richiede la conferma se la variabile di Windows PowerShell $ConfirmPreference ha un valore medio o inferiore. Se si specifica Confirm o Confirm:$True, questo cmdlet richiede la conferma prima dell'esecuzione. Se si specifica Confirm:$False, il cmdlet non richiede la conferma.