Udostępnij przez

Set-AzPrivateDnsZone

Moduł:
Az.PrivateDns Module

Aktualizuje prywatną strefę DNS z grupy zasobów.

Składnia

Fields (domyślnie) 

Set-AzPrivateDnsZone
    -ResourceGroupName <String>
    -Name <String>
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceId 

Set-AzPrivateDnsZone
    -ResourceId <String>
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object 

Set-AzPrivateDnsZone
    -PrivateZone <PSPrivateDnsZone>
    [-Tag <Hashtable>]
    [-Overwrite]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzPrivateDnsZone trwale aktualizuje prywatną strefę systemu nazw domen (DNS) z określonej grupy zasobów. Obiekt PrivateDnsZone można przekazać przy użyciu parametru PrivateZone lub operatora potoku. Alternatywnie można określić parametry Name 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 określania strefy przy użyciu obiektu PrivateDnsZone (przekazywanego za pośrednictwem potoku lub parametru strefy ) strefa nie jest aktualizowana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania lokalnego obiektu PrivateDnsZone (tylko operacje bezpośrednio na podstawie liczby zasobów strefy DNS jako zmiany, operacje na zestawach rekordów w strefie nie są). Zapewnia to ochronę zmian strefy współbieżnych. Można to pominąć przy użyciu parametru Overwrite , który aktualizuje strefę niezależnie od współbieżnych zmian.

Przykłady

Przykład 1. Aktualizuje strefę prywatną

Set-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup" -Tag @{tag1="value1";tag2="value2"}

Name                          : myzone.com
ResourceId                    : "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/PrivateZones/myzone.com"
ResourceGroupName             : MyResourceGroup
Location					  :
Etag                          : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                          : {tag1="value1";tag2="value2"}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

To polecenie aktualizuje strefę o nazwie myzone.com z grupy zasobów o nazwie MyResourceGroup z podanymi tagami. Użyj Get-AzPrivateDnsZone, aby pobrać zaktualizowaną strefę.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwę prywatnej strefy DNS, którą aktualizuje to polecenie cmdlet. Należy również określić parametr ResourceGroupName . Alternatywnie można określić prywatną strefę DNS przy użyciu parametru Zone .

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Fields
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Overwrite

Podczas określania strefy przy użyciu obiektu PrivateDnsZone (przekazywanego za pośrednictwem potoku lub parametru strefy ) strefa nie jest aktualizowana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania lokalnego obiektu DnsZone (tylko operacje bezpośrednio w strefie DNS zliczają się jako zmiany, operacje na zestawach rekordów w strefie nie). Zapewnia to ochronę zmian strefy współbieżnych. Można to pominąć przy użyciu parametru Overwrite , który aktualizuje strefę niezależnie od współbieżnych zmian.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Object
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrivateZone

Obiekt strefy do ustawienia.

Właściwości parametru

Typ:PSPrivateDnsZone
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Object
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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ć prywatną strefę DNS przy użyciu obiektu DnsZone przekazanego za pośrednictwem potoku lub parametru Zone .

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Fields
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceId

Identyfikator zasobu prywatnej strefy DNS.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ResourceId
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Tag

Tabela skrótów reprezentująca tagi zasobów.

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

PSPrivateDnsZone

Dane wyjściowe

PSPrivateDnsZone