Set-AzDnsZone
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
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]]
Output
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.