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

Die Join-SCVirtualMachine Cmdlet ordnet einen verwaisten virtuellen Computer dem Dienst oder der Rolle des virtuellen Computers neu zu.

Wenn ein Host oder Cluster aus dem Virtual Machine Manager (VMM) entfernt wird, bleiben alle virtuellen Computer, die zu einem Dienst oder einer rolle eines virtuellen Computers gehören, die auf dem Host bereitgestellt werden, 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.

Mit diesem Cmdlet können Sie die Zuordnung zwischen einem virtuellen Computer und seinem Dienst oder der Rolle des virtuellen Computers wiederherstellen. Das Cmdlet Join-SCVirtualMachine Cmdlet führt eine neu zugeordnete Aufgabe auf VMM aus, die eine Reihe von Überprüfungen durchführt, mit denen die Kompatibilität des virtuellen Computers mit der Dienstvorlage bestätigt wird.

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 Anzahl der Instanzen ausgeführt werden. Die Upgradedomäne für den Verknüpfungsvorgang ähnelt einer Skalierung.

Um optimale Ergebnisse zu erzielen, verwenden Sie dieses Cmdlet mit einem virtuellen Computer, der ursprünglich Teil einer Bereitstellung eines Diensts oder einer virtuellen Maschine war und nicht geändert wurde.

Beispiele

Beispiel 1: Verbinden 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 variablen $VM.

Der zweite Befehl ruft die Computerebene mit dem Namen 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: Verbinden 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 variablen $VM.

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.

Typ:ComputerTier
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt ein VM--Objekt an.

Typ:VM
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMRole

Gibt ein CloudVMRole -Objekt an.

Typ:CloudVmRole
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False