Freigeben über

Join-SCVirtualMachine

  • Referenz
Modul:
VirtualMachineManager

Ordnet einen verwaisten virtuellen Computer erneut seiner Dienst- oder virtuellen Computerrolle zu.

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

Beschreibung

Das Cmdlet Join-SCVirtualMachine verknüpft einen verwaisten virtuellen Computer erneut mit seiner Dienst- oder virtuellen Computerrolle.

Wenn ein Host oder Cluster aus dem Virtual Machine Manager (VMM) entfernt wird, bleiben alle virtuellen Computer, die zu einem Dienst oder einer virtuellen Computerrolle gehören, die auf dem Host bereitgestellt wird, funktionsfähig. Beim Hinzufügen des Hosts oder Clusters zu VMM werden die virtuellen Computer jedoch verwaist, sodass sie keine Zuordnung mehr mit ihrer Dienst- oder virtuellen Computerrolle haben.

Sie können dieses Cmdlet verwenden, um die Zuordnung zwischen einem virtuellen Computer und seiner Dienst- oder virtuellen Computerrolle wiederherzustellen. Das Cmdlet Join-SCVirtualMachine führt eine neu zugeordnete Aufgabe auf VMM aus, die eine Reihe von Überprüfungen ausführt, die die Kompatibilität des virtuellen Computers mit der Dienstvorlage bestätigen.

Wenn das Cmdlet die Kompatibilität des virtuellen Computers mit der Computerebenenvorlage überprüft, werden nur Datenbankvorgänge ausgeführt, und es werden keine Anpassungen an dem virtuellen Computer vorgenommen. Es wird davon ausgegangen, dass der virtuelle Computer ausgeführt wird und dass alle Gastanwendungen und Dienste, die darauf ausgeführt werden, intakt sind.

Die Computerebene, mit der Sie dem virtuellen Computer beitreten möchten, muss unter der maximalen Instanzanzahl ausgeführt werden. Die Upgradedomäne für den Verknüpfungsvorgang ähnelt einer Skalierung.

Verwenden Sie dieses Cmdlet für optimale Ergebnisse mit einem virtuellen Computer, der ursprünglich Teil einer Bereitstellung eines Diensts oder einer virtuellen Computerrolle war und nicht geändert wurde.

Beispiele

Beispiel 1: Verknüpfen eines verwaisten virtuellen Computers zu einer Dienstebene

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

Der erste Befehl ruft den virtuellen Computer mit dem Namen PS-Web-001 ab und speichert ihn dann in der $VM Variablen.

Der zweite Befehl ruft die Computerebene "MyService-WebTier" ab und speichert ihn dann in der $CT Variablen.

Der letzte Befehl verknüpft den virtuellen Computer in $VM mit der Computerebene in $CT.

Beispiel 2: Verknüpfen eines verwaisten virtuellen Computers zu einer Rolle eines virtuellen Computers

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

Der erste Befehl ruft den virtuellen Computer mit dem Namen PS-Web-001 ab und speichert ihn dann in der $VM Variablen.

Der zweite Befehl ruft die Cloudressource "ContosoShop" ab und speichert sie dann in der variablen $VmRole.

Der letzte Befehl verknüpft den virtuellen Computer in $VM mit der Rolle in $VMRole.

Parameter

-ComputerTier

Gibt ein ComputerTier-Objekt an.

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

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-VM

Gibt ein VM-Objekt an.

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

-VMRole

Gibt ein CloudVMRole-Objekt an.

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