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