Udostępnij za pośrednictwem

Set-AzDnsZone

  • Odwołanie
Moduł:
Az.Dns

Aktualizuje właściwości strefy DNS.

Składnia

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>]

Opis

Polecenie cmdlet Set-AzDnsZone aktualizuje określoną strefę DNS w usłudze Azure DNS. To polecenie cmdlet nie aktualizuje zestawów rekordów w strefie. Obiekt DnsZone można przekazać jako parametr lub za pomocą operatora potoku. Alternatywnie można określić parametry ZoneName i ResourceGroupName. Możesz użyć parametru Confirm i $ConfirmPreference zmiennej programu Windows PowerShell, aby kontrolować, czy polecenie cmdlet wyświetli monit o potwierdzenie. Podczas przekazywania strefy DNS jako obiektu (przy użyciu obiektu Zone lub potoku) nie jest aktualizowana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania lokalnego obiektu DnsZone. Zapewnia to ochronę współbieżnych zmian. To zachowanie można pominąć za pomocą parametru Zastąp , który aktualizuje strefę niezależnie od współbieżnych zmian.

Przykłady

Przykład 1. Aktualizowanie strefy DNS

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

Pierwsze polecenie pobiera strefę o nazwie myzone.com z określonej grupy zasobów, a następnie zapisuje ją w zmiennej $Zone. Drugie polecenie aktualizuje tagi dla $Zone. Ostatnie polecenie zatwierdza zmianę.

Przykład 2. Aktualizowanie tagów dla strefy

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

To polecenie aktualizuje tagi strefy o nazwie myzone.com bez uprzedniego jawnego pobierania strefy.

Przykład 3: Kojarzenie strefy prywatnej z siecią wirtualną przez określenie jego identyfikatora

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

To polecenie kojarzy strefę Prywatna strefa DNS myprivatezone.com z siecią wirtualną myvnet jako sieć rejestracji, określając jej identyfikator.

Przykład 4: Kojarzenie strefy prywatnej z siecią wirtualną przez określenie obiektu sieciowego.

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

To polecenie kojarzy strefę Prywatna strefa DNS myprivatezone.com z siecią wirtualną myvnet jako sieć rejestracji, przekazując obiekt sieci wirtualnej reprezentowany przez zmienną $vnet do polecenia cmdlet Set-AzDnsZone.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę strefy DNS do zaktualizowania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Overwrite

Podczas przekazywania strefy DNS jako obiektu (przy użyciu obiektu Zone lub potoku) nie jest aktualizowana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania lokalnego obiektu DnsZone. Zapewnia to ochronę współbieżnych zmian. To zachowanie można pominąć za pomocą parametru Zastąp , który aktualizuje strefę niezależnie od współbieżnych zmian.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RegistrationVirtualNetwork

Lista sieci wirtualnych, które będą rejestrować rekordy hostów maszyn wirtualnych w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[IResourceReference]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RegistrationVirtualNetworkId

Lista identyfikatorów sieci wirtualnej, które będą rejestrować rekordy nazw hostów maszyn wirtualnych w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResolutionVirtualNetwork

Lista sieci wirtualnych, które mogą rozpoznawać rekordy w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[IResourceReference]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResolutionVirtualNetworkId

Lista identyfikatorów sieci wirtualnej, które mogą rozpoznawać rekordy w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów, która zawiera strefę do zaktualizowania. Należy również określić parametr ZoneName. Alternatywnie można określić strefę przy użyciu obiektu DnsZone z parametrem Zone lub potokiem.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tags
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane. Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Zone

Określa strefę DNS do zaktualizowania. Alternatywnie można określić strefę przy użyciu parametrów ZoneName i ResourceGroupName .

Typ:DnsZone
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

DnsZone

Uwagi

Możesz użyć parametru Confirm, aby określić, czy to polecenie cmdlet wyświetli monit o potwierdzenie. Domyślnie polecenie cmdlet wyświetla monit o potwierdzenie, jeśli zmienna programu Windows PowerShell $ConfirmPreference ma wartość Średnia lub niższa. Jeśli określisz opcję Potwierdź lub Potwierdź:$True, to polecenie cmdlet wyświetli monit o potwierdzenie przed jego uruchomieniem. Jeśli określisz wartość Confirm:$False, polecenie cmdlet nie wyświetli monitu o potwierdzenie.