Share via

Set-AzPrivateDnsVirtualNetworkLink

  • Referenz
Modul:
Az.PrivateDns

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 NameZoneName 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Das festzulegende Objekt für die virtuelle Netzwerkverbindung.

Type:PSPrivateDnsVirtualNetworkLink
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IsRegistrationEnabled

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

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Privates DNS Zone ResourceID.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Eine Hashtabelle, die Ressourcentags darstellt.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSPrivateDnsVirtualNetworkLink

String

Ausgaben

PSPrivateDnsVirtualNetworkLink