Delen via

Set-AzDnsZone

  • Referentie
Module:
Az.Dns

Hiermee worden de eigenschappen van een DNS-zone bijgewerkt.

Syntax

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 cmdlet Set-AzDnsZone werkt de opgegeven DNS-zone bij in de Azure DNS-service. 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 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 koppelt u de Privé-DNS zone myprivatezone.com aan het virtuele netwerk myvnet als een registratienetwerk door het virtuele netwerkobject dat wordt vertegenwoordigd door $vnet variabele door te geven aan de cmdlet Set-AzDnsZone.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters: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 zoneparameter of de pijplijn.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

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

Type:Hashtable
Aliases:Tags
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd. Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:False
Vereist:False
Accept pipeline input:False
Accept wildcard characters: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
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters: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 Bevestigen:$True opgeeft, wordt u door deze cmdlet gevraagd om bevestiging voordat deze wordt uitgevoerd. Als u Confirm:$False opgeeft, wordt u niet om bevestiging gevraagd.