Freigeben über


Set-AzPrivateDnsVirtualNetworkLink

Aktualisiert/legt eine virtuelle Netzwerkverbindung fest, die einer privaten Zone und einer Ressourcengruppe zugeordnet ist.

Syntax

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

Beschreibung

Das Cmdlet Set-AzPrivateDnsVirtualNetworkLink aktualisiert einen Link, der einer Zone aus einer angegebenen Ressourcengruppe zugeordnet ist. Sie können ein PSPrivateDnsVirtualNetworkLink-Objekt mithilfe des Link-Parameters oder mithilfe des Pipelineoperators übergeben oder alternativ die Parameter Name ZoneName und ResourceGroupName angeben. Sie können den Parameter "Confirm" und $ConfirmPreference Windows PowerShell-Variable verwenden, um zu steuern, ob das Cmdlet Sie zur Bestätigung auffordert. Wenn Sie die Zone mithilfe eines PSPrivateDnsVirtualNetworkLink-Objekts angeben (übergeben über den Pipeline- oder Link-Parameter ), wird die Verknüpfung nicht aktualisiert, wenn sie seit dem Abrufen des lokalen PSPrivateDnsVirtualNetworkLink-Objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Verknüpfungsänderungen. Dies kann mithilfe des Overwrite-Parameters unterdrückt werden, der den Link unabhängig von gleichzeitigen Änderungen aktualisiert.

Beispiele

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
VirtualNetworkLinkState : Completed
ProvisioningState       : Succeeded

Mit diesem Befehl wird "IsRegistrationEnabled" für den Link mit dem Namen "mylink" auf "True" festgelegt, der mit der Zone namens myzone.com aus der Ressourcengruppe "MyResourceGroup" verknüpft ist.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Das festzulegende Objekt für die virtuelle Netzwerkverbindung.

Typ:PSPrivateDnsVirtualNetworkLink
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IsRegistrationEnabled

Boolean that represents if registration is enabled on the virtual network link.

Typ:Nullable<T>[Boolean]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Links an, den dieses Cmdlet entfernt. Sie müssen auch den Parameter ResourceGroupName und ZoneName angeben. Alternativ können Sie den privaten DNS-Link mithilfe des Linkparameters angeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Overwrite

Wenn Sie den Link mithilfe eines PSPrivateDnsVirtualNetworkLink-Objekts angeben (übergeben über die Pipeline oder den Link-Parameter ), wird der Link nicht gelöscht, wenn er seit dem Abrufen des lokalen PSPrivateDnsVirtualNetworkLink-Objekts in Azure DNS geändert wurde. Dies bietet Schutz für gleichzeitige Verknüpfungsänderungen. Dies kann mithilfe des Overwrite-Parameters unterdrückt werden, der den Link unabhängig von gleichzeitigen Änderungen löscht.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, die den zu entfernenden Link enthält. Sie müssen auch den Parameter ZoneName und Name angeben. Alternativ können Sie die virtuelle Netzwerkverbindung mithilfe eines PSPrivateDnsVirtualNetworkLink-Objekts angeben, das entweder über die Pipeline oder den Link-Parameter übergeben wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceId

Privates DNS Zone ResourceID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tag

Eine Hashtabelle, die Ressourcentags darstellt.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ZoneName

Gibt den Namen der DNS-Zone an, die dieses Cmdlet entfernt. Sie müssen auch den Parameter Name und ResourceGroupName angeben. Alternativ können Sie den privaten DNS-Link mithilfe des Linkparameters angeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSPrivateDnsVirtualNetworkLink

String

Ausgaben

PSPrivateDnsVirtualNetworkLink