Set-AzureVMAccessExtension

Référence

Module:: Azure

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

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Renseignez-vous
SilentlyContinue
Arrêter
Suspendre

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Spécifie une variable d’informations.

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

-Password

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

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

-Uninstall

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

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

-Version

Spécifie la version de l’extension.

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

-VM

Spécifie l’objet de machine virtuelle persistante.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False