Udostępnij za pośrednictwem

Set-AzPrivateDnsVirtualNetworkLink

  • Odwołanie
Moduł:
Az.PrivateDns

Aktualizuje/ustawia łącze sieci wirtualnej skojarzone ze strefą prywatną i grupą zasobów.

Składnia

Set-AzPrivateDnsVirtualNetworkLink
   -ResourceGroupName <String>
   -ZoneName <String>
   -Name <String>
   [-IsRegistrationEnabled <Boolean>]
   [-ResolutionPolicy <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsVirtualNetworkLink
   -InputObject <PSPrivateDnsVirtualNetworkLink>
   [-IsRegistrationEnabled <Boolean>]
   [-ResolutionPolicy <String>]
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsVirtualNetworkLink
   -ResourceId <String>
   [-IsRegistrationEnabled <Boolean>]
   [-ResolutionPolicy <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzPrivateDnsVirtualNetworkLink aktualizuje łącze skojarzone ze strefą z określonej grupy zasobów. Można przekazać obiekt PSPrivateDnsVirtualNetworkLink przy użyciu parametru linku lub za pomocą operatora potoku lub użyć operatora potoku, a także określić parametry Nazwa strefyNazwa strefy 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 PSPrivateDnsVirtualNetworkLink obiektu (przekazywanego za pośrednictwem potoku lub parametru Link), link nie jest aktualizowany, jeśli został zmieniony w usłudze Azure DNS od czasu pobrania obiektu lokalnego PSPrivateDnsVirtualNetworkLink. Zapewnia to ochronę współbieżnych zmian linków. Można to pominąć przy użyciu parametru Overwrite, który aktualizuje link niezależnie od współbieżnych zmian.

Przykłady

Przykład 1. Ustawianie łącza

Set-AzPrivateDnsVirtualNetworkLink -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Name "mylink" -Tag @{} -IsRegistrationEnabled $true

Name                    : mylink
ResourceId              : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.N
                          etwork/privateDnsZones/myzone.com/virtualNetworkLinks/mylink
ResourceGroupName       : MyResourceGroup
ZoneName                : myzone.com
VirtualNetworkId        : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.N
                          etwork/virtualNetworks/myvirtualnetwork
Location                :
Etag                    : "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Tags                    : {}
RegistrationEnabled     : True
ResolutionPolicy        : Default
VirtualNetworkLinkState : Completed
ProvisioningState       : Succeeded

To polecenie ustawia wartość IsRegistrationEnabled na wartość True dla linku o nazwie mylink połączonego ze strefą o nazwie myzone.com z grupy zasobów o nazwie MyResourceGroup.

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

-InputObject

Obiekt łącza sieci wirtualnej do ustawienia.

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

-IsRegistrationEnabled

Wartość logiczna określająca, czy rejestracja jest włączona w linku sieci wirtualnej.

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

-Name

Określa nazwę łącza, który usuwa to polecenie cmdlet. Należy również określić parametr ResourceGroupName i ZoneName. Alternatywnie można określić prywatny link DNS przy użyciu linku parametru.

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

-Overwrite

Podczas określania linku przy użyciu obiektu PSPrivateDnsVirtualNetworkLink (przekazywanego za pośrednictwem potoku lub linku parametru), link nie zostanie usunięty, jeśli został zmieniony w usłudze Azure DNS, ponieważ pobrano lokalny obiekt PSPrivateDnsVirtualNetworkLink. Zapewnia to ochronę współbieżnych zmian linków. Można to pominąć przy użyciu parametru Zastąp, który usuwa łącze 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

-ResolutionPolicy

Speficies zasady rozwiązywania linku sieci wirtualnej

Typ:PrivateDnsResolutionPolicy
Dopuszczalne wartości:Default, NxDomainRedirect
Position:Named
Domyślna wartość:Default
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów, która zawiera link do usunięcia. Należy również określić parametr ZoneName i Nazwa. Alternatywnie można określić łącze sieci wirtualnej przy użyciu obiektu PSPrivateDnsVirtualNetworkLink przekazywanego za pośrednictwem potoku lub parametru Link.

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

-ResourceId

Identyfikator zasobu prywatnej strefy DNS.

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

-Tag

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

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

-WhatIf

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

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

-ZoneName

Określa nazwę strefy DNS, którą usuwa to polecenie cmdlet. Należy również określić nazwa i parametr ResourceGroupName. Alternatywnie można określić prywatny link DNS przy użyciu linku parametru.

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

Dane wejściowe

Dane wyjściowe