Dela via

Set-AzDnsZone

  • Referens
Modul:
Az.Dns

Uppdateringar egenskaperna för en DNS-zon.

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

Cmdleten Set-AzDnsZone uppdaterar den angivna DNS-zonen i Azure DNS-tjänsten. Den här cmdleten uppdaterar inte postuppsättningarna i zonen. Du kan skicka ett DnsZone-objekt som en parameter eller med hjälp av pipelineoperatorn, eller så kan du ange parametrarna ZoneName och ResourceGroupName . Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse. När du skickar en DNS-zon som ett objekt (med zonobjektet eller via pipelinen) uppdateras den inte om den har ändrats i Azure DNS sedan det lokala DnsZone-objektet hämtades. Detta ger skydd för samtidiga ändringar. Du kan förhindra det här beteendet med parametern Overwrite , som uppdaterar zonen oavsett samtidiga ändringar.

Exempel

Exempel 1: Uppdatera en DNS-zon

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

Det första kommandot hämtar zonen med namnet myzone.com från den angivna resursgruppen och lagrar den sedan i variabeln $Zone. Det andra kommandot uppdaterar taggarna för $Zone. Det sista kommandot checkar in ändringen.

Exempel 2: Uppdatera taggar för en zon

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

Det här kommandot uppdaterar taggarna för zonen med namnet myzone.com utan att först uttryckligen hämta zonen.

Exempel 3: Associera en privat zon med ett virtuellt nätverk genom att ange dess ID

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

Det här kommandot associerar Privat DNS zon myprivatezone.com med det virtuella nätverkets myvnet som ett registreringsnätverk genom att ange dess ID.

Exempel 4: Associera en privat zon med ett virtuellt nätverk genom att ange nätverksobjektet.

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

Det här kommandot associerar Privat DNS zon myprivatezone.com med det virtuella nätverkets myvnet som ett registreringsnätverk genom att skicka det virtuella nätverksobjektet som representeras av $vnet variabel till cmdleten Set-AzDnsZone.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på DNS-zonen som ska uppdateras.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Overwrite

När du skickar en DNS-zon som ett objekt (med zonobjektet eller via pipelinen) uppdateras den inte om den har ändrats i Azure DNS sedan det lokala DnsZone-objektet hämtades. Detta ger skydd för samtidiga ändringar. Du kan förhindra det här beteendet med parametern Overwrite , som uppdaterar zonen oavsett samtidiga ändringar.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RegistrationVirtualNetwork

Listan över virtuella nätverk som registrerar värdnamn för virtuella datorer i den här DNS-zonen, endast tillgänglig för privata zoner.

Typ:List<T>[IResourceReference]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RegistrationVirtualNetworkId

Listan över virtuella nätverks-ID:n som registrerar värdnamn för virtuella datorer i den här DNS-zonen, endast tillgängliga för privata zoner.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResolutionVirtualNetwork

Listan över virtuella nätverk som kan matcha poster i den här DNS-zonen, endast tillgänglig för privata zoner.

Typ:List<T>[IResourceReference]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResolutionVirtualNetworkId

Listan över virtuella nätverks-ID:n som kan matcha poster i den här DNS-zonen, endast tillgängliga för privata zoner.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på resursgruppen som innehåller den zon som ska uppdateras. Du måste också ange parametern ZoneName. Du kan också ange zonen med hjälp av ett DnsZone-objekt med zonparametern eller pipelinen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Alias:Tags
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte. Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Zone

Anger dns-zonen som ska uppdateras. Du kan också ange zonen med parametrarna ZoneName och ResourceGroupName .

Typ:DnsZone
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

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

Utdata

DnsZone

Kommentarer

Du kan använda parametern Bekräfta för att kontrollera om den här cmdleten uppmanar dig att bekräfta. Som standard uppmanar cmdleten dig att bekräfta om $ConfirmPreference Windows PowerShell-variabeln har värdet Medel eller lägre. Om du anger Bekräfta eller Bekräfta:$True uppmanas du att bekräfta den här cmdleten innan den körs. Om du anger Confirm:$False uppmanas du inte att bekräfta cmdleten.