Condividi tramite

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 distribuito 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 proprio ruolo di servizio o 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 riassociato in VMM che esegue un set di convalide che consentono di verificare 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 guest e i servizi 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 originariamente faceva parte di un servizio o una distribuzione del ruolo 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 quindi 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 .

Tipo:ComputerTier
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OnBehalfOfUser

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:UserRole
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VM

Specifica un oggetto macchina virtuale di .

Tipo:VM
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VMRole

Specifica un oggetto cloudVMRole .

Tipo:CloudVmRole
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False