Delen via

Join-SCVirtualMachine

  • Referentie
Module:
VirtualMachineManager

Koppelt een zwevende virtuele machine opnieuw aan de service- of virtuele-machinerol.

Syntaxis

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

De Join-SCVirtualMachine cmdlet koppelt een zwevende virtuele machine opnieuw aan de service- of virtuele-machinerol.

Wanneer een host of cluster wordt verwijderd uit Virtual Machine Manager (VMM), blijven alle virtuele machines die behoren tot een service of een virtuele-machinerol die op de host is geïmplementeerd, functioneel. Als u de host of het cluster echter weer toevoegt aan VMM, worden de virtuele machines zwevend in de zin dat ze geen koppeling meer hebben met hun service- of virtuele-machinerol.

U kunt deze cmdlet gebruiken om de koppeling tussen een virtuele machine en de bijbehorende service- of virtuele-machinerol te herstellen. De cmdlet Join-SCVirtualMachine voert een taak opnieuw aan VMM uit die een set validaties uitvoert waarmee de compatibiliteit van de virtuele machine met de servicesjabloon kan worden bevestigd.

Wanneer de cmdlet de compatibiliteit van de virtuele machine met de sjabloon voor de computerlaag valideert, worden alleen databasebewerkingen uitgevoerd en worden er geen aanpassingen aangebracht aan de virtuele machine. Er wordt van uitgegaan dat de virtuele machine wordt uitgevoerd en dat alle gasttoepassingen en -services die erop worden uitgevoerd, intact zijn.

De computerlaag waaraan u de virtuele machine wilt koppelen, moet onder het maximum aantal exemplaren worden uitgevoerd. Het upgradedomein voor de joinbewerking is vergelijkbaar met een uitschaalbewerking.

Gebruik deze cmdlet voor de beste resultaten met een virtuele machine die oorspronkelijk deel uitmaakte van een implementatie van een service- of virtuele-machinerol en die niet is gewijzigd.

Voorbeelden

Voorbeeld 1: Een zwevende virtuele machine toevoegen aan een servicelaag

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

Met de eerste opdracht wordt de virtuele machine met de naam PS-Web-001 opgeslagen en vervolgens opgeslagen in de $VM variabele.

Met de tweede opdracht wordt de computerlaag MyService-WebTier opgeslagen en vervolgens opgeslagen in de $CT variabele.

Met de laatste opdracht wordt de virtuele machine in $VM toegevoegd aan de computerlaag in $CT.

Voorbeeld 2: Een zwevende virtuele machine toevoegen aan een virtuele-machinerol

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

Met de eerste opdracht wordt de virtuele machine met de naam PS-Web-001 opgeslagen en vervolgens opgeslagen in de $VM variabele.

Met de tweede opdracht wordt de cloudresource ContosoShop opgeslagen en vervolgens opgeslagen in de variabele $VmRole.

Met de laatste opdracht wordt de virtuele machine in $VM toegevoegd aan de rol in $VMRole.

Parameters

-ComputerTier

Hiermee geeft u een ComputerTier object.

Type:ComputerTier
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u een variabele op waarin de voortgang van de taak wordt bijgehouden en opgeslagen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VM

Hiermee geeft u een VM--object.

Type:VM
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMRole

Hiermee geeft u een CloudVMRole-object.

Type:CloudVmRole
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False