Share via

Join-SCVirtualMachine

  • Riferimento
Modulo:
VirtualMachineManager

Associa nuovamente una macchina virtuale orfana al ruolo del servizio o della macchina virtuale.

Sintassi

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

Descrizione

Il cmdlet Join-SCVirtualMachine associa nuovamente una macchina virtuale orfana al ruolo del servizio o della macchina virtuale.

Quando un host o un cluster viene rimosso da Virtual Machine Manager (VMM), tutte le macchine virtuali appartenenti a un servizio o a un ruolo macchina virtuale distribuite nell'host rimangono funzionali. Tuttavia, quando si aggiunge di nuovo l'host o il cluster a VMM, le macchine virtuali diventano orfane nel senso che non hanno più alcuna associazione con il ruolo del servizio o della macchina virtuale.

È possibile usare questo cmdlet per ripristinare l'associazione tra una macchina virtuale e il relativo ruolo di servizio o macchina virtuale. Il cmdlet Join-SCVirtualMachine esegue un'attività di ri-associazione in VMM che esegue un set di convalide che consentono di confermare la compatibilità della macchina virtuale con il modello di servizio.

Quando il cmdlet convalida la compatibilità della macchina virtuale con il modello di livello computer, vengono eseguite operazioni solo database e non vengono apportate modifiche alla macchina virtuale. Si presuppone che la macchina virtuale sia in esecuzione e che tutte le applicazioni e i servizi guest in esecuzione siano intatti.

Il livello computer a cui si vuole aggiungere la macchina virtuale deve essere in esecuzione al di sotto del numero massimo di istanze. Il dominio di aggiornamento per l'operazione di aggiunta è simile a un aumento del numero di istanze.

Per ottenere risultati ottimali, usare questo cmdlet con una macchina virtuale che in origine faceva parte di una distribuzione del ruolo del servizio o della macchina virtuale e non è stata modificata.

Esempio

Esempio 1: Aggiungere una macchina virtuale orfana a un livello di servizio

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

Il primo comando ottiene la macchina virtuale denominata PS-Web-001 e quindi la archivia nella variabile $VM.

Il secondo comando ottiene il livello computer denominato MyService-WebTier e lo archivia nella variabile $CT.

L'ultimo comando aggiunge la macchina virtuale in $VM al livello computer in $CT.

Esempio 2: Aggiungere una macchina virtuale orfana a un ruolo macchina virtuale

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

Il primo comando ottiene la macchina virtuale denominata PS-Web-001 e quindi la archivia nella variabile $VM.

Il secondo comando ottiene la risorsa cloud denominata ContosoShop e quindi la archivia nella variabile $VmRole.

L'ultimo comando aggiunge la macchina virtuale in $VM al ruolo in $VMRole.

Parametri

-ComputerTier

Specifica un oggetto ComputerTier .

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

-JobVariable

Specifica una variabile in cui viene monitorato e archiviato lo stato del processo.

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

-OnBehalfOfUser

Specifica un nome utente. Questo cmdlet opera per conto dell'utente specificato da questo parametro.

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

-OnBehalfOfUserRole

Specifica un ruolo utente. Per ottenere un ruolo utente, usare il cmdlet Get-SCUserRole . Questo cmdlet opera per conto del ruolo utente specificato da questo parametro.

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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

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

-VM

Specifica un oggetto VM .

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

-VMRole

Specifica un oggetto CloudVMRole .

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