Delen via

Join-SCVirtualMachine

  • Referentie
Module:
VirtualMachineManager

Hiermee koppelt u een zwevende virtuele machine opnieuw aan de service- of virtuele-machinerol.

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

De cmdlet Join-SCVirtualMachine 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 deel uitmaken van een service of een virtuele-machinerol die op de host is geïmplementeerd, functioneel. Bij het toevoegen van de host of het cluster aan VMM worden de virtuele machines echter 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. Met de cmdlet Join-SCVirtualMachine wordt een taak voor opnieuw koppelen uitgevoerd op VMM 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 maximale aantal exemplaren worden uitgevoerd. Het upgradedomein voor de joinbewerking is vergelijkbaar met een uitschaling.

Voor de beste resultaten gebruikt u deze cmdlet 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

De eerste opdracht haalt de virtuele machine met de naam PS-Web-001 op en slaat deze vervolgens op 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

De eerste opdracht haalt de virtuele machine met de naam PS-Web-001 op en slaat deze vervolgens op 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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

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

-VM

Hiermee geeft u een VM-object .

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

-VMRole

Hiermee geeft u een CloudVMRole-object op.

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