Partager via

Join-SCVirtualMachine

  • Référence
Module:
VirtualMachineManager

Associe à nouveau une machine virtuelle orpheline à son rôle de service ou de machine virtuelle.

Syntax

Join-SCVirtualMachine
    [-VM] <VM>
    -ComputerTier <ComputerTier>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Join-SCVirtualMachine
    [-VM] <VM>
    -VMRole <CloudVmRole>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

L’applet de commande Join-SCVirtualMachine associe à nouveau une machine virtuelle orpheline à son rôle de service ou de machine virtuelle.

Lorsqu’un hôte ou un cluster est supprimé de Virtual Machine Manager (VMM), toutes les machines virtuelles appartenant à un service ou un rôle de machine virtuelle déployée sur l’hôte restent fonctionnelles. Toutefois, lors de l’ajout de l’hôte ou du cluster à VMM, les machines virtuelles deviennent orphelines dans le sens où elles n’ont plus d’association avec leur rôle de service ou de machine virtuelle.

Vous pouvez utiliser cette applet de commande pour restaurer l’association entre une machine virtuelle et son rôle de service ou de machine virtuelle. L’applet de commande Join-SCVirtualMachine exécute une nouvelle tâche associée sur VMM qui effectue un ensemble de validations qui permettent de confirmer la compatibilité de la machine virtuelle avec le modèle de service.

Lorsque l’applet de commande valide la compatibilité de la machine virtuelle avec le modèle de couche ordinateur, les opérations de base de données uniquement sont effectuées et aucun ajustement n’est apporté à la machine virtuelle. Il est supposé que la machine virtuelle est en cours d’exécution et que toutes les applications et services invités en cours d’exécution sont intacts.

Le niveau ordinateur auquel vous souhaitez joindre la machine virtuelle doit être exécuté sous son nombre maximal d’instances. Le domaine de mise à niveau de l’opération de jointure est similaire à un scale-out.

Pour obtenir de meilleurs résultats, utilisez cette applet de commande avec une machine virtuelle qui faisait partie initialement d’un déploiement de rôle de service ou de machine virtuelle et n’a pas été modifiée.

Exemples

Exemple 1 : Joindre une machine virtuelle orpheline à un niveau de service

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $CT = Get-SCComputerTier -Name "MyService-WebTier" 
PS C:\> Join-SCVirtualMachine -VM $VM -ComputerTier $CT

La première commande obtient la machine virtuelle nommée PS-Web-001, puis la stocke dans la variable $VM.

La deuxième commande obtient le niveau ordinateur nommé MyService-WebTier, puis le stocke dans la variable $CT.

La dernière commande joint la machine virtuelle dans $VM au niveau de l’ordinateur dans $CT.

Exemple 2 : Joindre une machine virtuelle orpheline à un rôle de machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "PS-Web-001" 
PS C:\> $VmRole = Get-CloudResource -Name "ContosoShop" 
PS C:\> Join-SCVirtualMachine -VM $VM -VMRole $VmRole

La première commande obtient la machine virtuelle nommée PS-Web-001, puis la stocke dans la variable $VM.

La deuxième commande obtient la ressource cloud nommée ContosoShop, puis la stocke dans la variable $VmRole.

La dernière commande joint la machine virtuelle dans $VM au rôle dans $VMRole.

Paramètres

-ComputerTier

Spécifie un objet ComputerTier .

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

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VM

Spécifie un objet de machine virtuelle .

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMRole

Spécifie un objet CloudVMRole .

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