Partager via

Set-AzPrivateDnsVirtualNetworkLink

  • Référence
Module:
Az.PrivateDns

Mises à jour/Définit une liaison de réseau virtuel associée à une zone privée et à un groupe de ressources.

Syntaxe

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

Description

L’applet de commande Set-AzPrivateDnsVirtualNetworkLink met à jour un lien associé à une zone à partir d’un groupe de ressources spécifié. Vous pouvez passer un objet PSPrivateDnsVirtualNetworkLink à l’aide du paramètre Link ou à l’aide de l’opérateur de pipeline, ou vous pouvez également spécifier les paramètres Name ZoneName et ResourceGroupName. Vous pouvez utiliser le paramètre Confirm et $ConfirmPreference variable Windows PowerShell pour contrôler si l’applet de commande vous invite à confirmer. Lorsque vous spécifiez la zone à l’aide d’un objet PSPrivateDnsVirtualNetworkLink (transmis via le pipeline ou le paramètre Link), le lien n’est pas mis à jour s’il a été modifié dans Azure DNS depuis la récupération de l’objet PSPrivateDnsVirtualNetworkLink local. Cela offre une protection pour les modifications simultanées des liens. Cela peut être supprimé à l’aide du paramètre Overwrite , qui met à jour le lien indépendamment des modifications simultanées.

Exemples

Exemple 1 : Définir un lien

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

Cette commande définit IsRegistrationEnabled sur True pour le lien nommé mylink, lié à la zone nommée myzone.com à partir du groupe de ressources nommé MyResourceGroup.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Objet de liaison de réseau virtuel à définir.

Type:PSPrivateDnsVirtualNetworkLink
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IsRegistrationEnabled

Boolean qui représente si l’inscription est activée sur la liaison de réseau virtuel.

Type:Nullable<T>[Boolean]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom du lien supprimé par cette applet de commande. Vous devez également spécifier le paramètre ResourceGroupName et ZoneName . Vous pouvez également spécifier la liaison DNS privée à l’aide du paramètre de lien .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Overwrite

Lorsque vous spécifiez le lien à l’aide d’un objet PSPrivateDnsVirtualNetworkLink (transmis via le pipeline ou le paramètre Link), le lien n’est pas supprimé s’il a été modifié dans Azure DNS depuis la récupération de l’objet PSPrivateDnsVirtualNetworkLink local. Cela offre une protection pour les modifications simultanées des liens. Cela peut être supprimé à l’aide du paramètre Overwrite , qui supprime le lien indépendamment des modifications simultanées.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom du groupe de ressources qui contient le lien à supprimer. Vous devez également spécifier le paramètre ZoneName et Name . Vous pouvez également spécifier le lien de réseau virtuel à l’aide d’un objet PSPrivateDnsVirtualNetworkLink , transmis via le pipeline ou le paramètre Link .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceId

DNS privé ResourceID de zone.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Tag

Table de hachage qui représente les balises de ressource.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ZoneName

Spécifie le nom de la zone DNS supprimée par cette applet de commande. Vous devez également spécifier le paramètre Name et ResourceGroupName . Vous pouvez également spécifier la liaison DNS privée à l’aide du paramètre de lien .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSPrivateDnsVirtualNetworkLink

String

Sorties

PSPrivateDnsVirtualNetworkLink