Partager via

Set-AzureVMAccessExtension

  • Référence
Module:
Azure

Définit l’extension VMAccess pour une machine virtuelle.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Set-AzureVMAccessExtension
   [[-UserName] <String>]
   [[-Password] <String>]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMAccessExtension
   [-Disable]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMAccessExtension
   [-Uninstall]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureVMAccessExtension ajoute l’extension VMAccess de machine virtuelle à une machine virtuelle. L’extension VMAccess peut être utilisée pour définir un mot de passe temporaire et elle doit être immédiatement modifiée après la connexion à l’ordinateur.

Exemples

Exemple 1 : Définir l’extension VMAccess appliquée à une machine virtuelle spécifiée

PS C:\> Set-AzureVMAccessExtension -VM $VM -UserName $User -Password $PWD;

Cette commande définit l’extension VMAccess appliquée à la machine virtuelle spécifiée comme stockée dans la variable $VM.

Paramètres

-Disable

Indique que cette applet de commande définit l’état d’extension à désactiver.

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

-ForceUpdate

Indique que cette applet de commande réapplique une configuration à une extension lorsque la configuration n’a pas été mise à jour.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-Password

Spécifie le mot de passe pour réinitialiser les informations d’identification de la machine virtuelle.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ReferenceName

Spécifie le nom de référence de l’extension d’accès.

Il s’agit d’une chaîne définie par l’utilisateur utilisée pour faire référence à une extension. Elle est spécifiée lorsque l’extension est ajoutée à la machine virtuelle pour la première fois. Pour les mises à jour suivantes, vous devez spécifier le nom de référence précédemment utilisé lors de la mise à jour de l’extension. Le ReferenceName affecté à une extension est retourné à l’aide de l’applet de commande Get-AzureVM .

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

-Uninstall

Indique si cette applet de commande désinstalle l’extension d’accès.

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

-UserName

Spécifie le nom d’utilisateur que cette applet de commande utilise pour réinitialiser les informations d’identification de la machine virtuelle.

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

-Version

Spécifie la version de l’extension.

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

-VM

Spécifie l’objet de machine virtuelle persistante.

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