Delen via

Set-AzDnsZone

  • Referentie
Module:
Az.Dns

Hiermee worden de eigenschappen van een DNS-zone bijgewerkt.

Syntaxis

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

De Set-AzDnsZone cmdlet werkt de opgegeven DNS-zone in de Azure DNS-service bij. Met deze cmdlet worden de recordsets in de zone niet bijgewerkt. U kunt een DnsZone-object doorgeven als parameter of met behulp van de pijplijnoperator. U kunt ook de parameters ZoneName en ResourceGroupName opgeven. U kunt de parameter bevestigen en $ConfirmPreference Windows PowerShell-variabele gebruiken om te bepalen of de cmdlet u om bevestiging vraagt. Wanneer u een DNS-zone doorgeeft als een object (met behulp van het zoneobject of via de pijplijn), wordt deze niet bijgewerkt als deze is gewijzigd in Azure DNS sinds het lokale DnsZone-object is opgehaald. Dit biedt beveiliging voor gelijktijdige wijzigingen. U kunt dit gedrag onderdrukken met de parameter Overschrijven, waarmee de zone wordt bijgewerkt, ongeacht gelijktijdige wijzigingen.

Voorbeelden

Voorbeeld 1: Een DNS-zone bijwerken

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

Met de eerste opdracht wordt de zone met de naam myzone.com opgehaald uit de opgegeven resourcegroep en wordt deze vervolgens opgeslagen in de $Zone variabele. Met de tweede opdracht worden de tags voor $Zone bijgewerkt. Met de laatste opdracht wordt de wijziging doorgevoerd.

Voorbeeld 2: Tags voor een zone bijwerken

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

Met deze opdracht worden de tags voor de zone met de naam myzone.com bijgewerkt zonder eerst expliciet de zone op te halen.

Voorbeeld 3: Een privézone koppelen aan een virtueel netwerk door de id op te geven

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

Met deze opdracht koppelt u de privé-DNS-zone myprivatezone.com aan het virtuele netwerk myvnet als een registratienetwerk door de id op te geven.

Voorbeeld 4: Een privézone koppelen aan een virtueel netwerk door het netwerkobject op te geven.

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

Met deze opdracht wordt de privé-DNS-zone myprivatezone.com gekoppeld aan het myvnet van het virtuele netwerk als een registratienetwerk door het virtuele netwerkobject dat wordt vertegenwoordigd door $vnet variabele door te geven aan de Set-AzDnsZone cmdlet.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de DNS-zone die moet worden bijgewerkt.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Overwrite

Wanneer u een DNS-zone doorgeeft als een object (met behulp van het zoneobject of via de pijplijn), wordt deze niet bijgewerkt als deze is gewijzigd in Azure DNS sinds het lokale DnsZone-object is opgehaald. Dit biedt beveiliging voor gelijktijdige wijzigingen. U kunt dit gedrag onderdrukken met de parameter Overschrijven, waarmee de zone wordt bijgewerkt, ongeacht gelijktijdige wijzigingen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RegistrationVirtualNetwork

De lijst met virtuele netwerken die hostnamenrecords voor virtuele machines registreren in deze DNS-zone, alleen beschikbaar voor privézones.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RegistrationVirtualNetworkId

De lijst met virtuele netwerk-id's waarmee hostnamen van virtuele machines in deze DNS-zone worden geregistreerd, alleen beschikbaar voor privézones.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResolutionVirtualNetwork

De lijst met virtuele netwerken die records in deze DNS-zone kunnen omzetten, alleen beschikbaar voor privézones.

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResolutionVirtualNetworkId

De lijst met virtuele netwerk-id's die records in deze DNS-zone kunnen omzetten, alleen beschikbaar voor privézones.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam op van de resourcegroep die de zone bevat die moet worden bijgewerkt. U moet ook de parameter ZoneName opgeven. U kunt ook de zone opgeven met behulp van een DnsZone-object met de parameter Zone of de pijplijn.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Type:Hashtable
Aliassen:Tags
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd. Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Zone

Hiermee geeft u de DNS-zone die moet worden bijgewerkt. U kunt ook de zone opgeven met behulp van de parameters ZoneName en ResourceGroupName.

Type:DnsZone
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

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

Uitvoerwaarden

DnsZone

Notities

U kunt de parameter Bevestigen gebruiken om te bepalen of deze cmdlet u om bevestiging vraagt. De cmdlet vraagt u standaard om bevestiging als de $ConfirmPreference Windows PowerShell-variabele een waarde gemiddeld of lager heeft. Als u bevestigen of Confirm:$Trueopgeeft, wordt u door deze cmdlet gevraagd om bevestiging voordat deze wordt uitgevoerd. Als u Confirm:$Falseopgeeft, wordt u niet om bevestiging gevraagd.