Freigeben über


Join-SCVirtualMachine

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

Syntax

ServiceComputerTierParameterSet

Join-SCVirtualMachine
    [-VM] <VM>
    -ComputerTier <ComputerTier>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VMRoleParameterSet

Join-SCVirtualMachine
    [-VM] <VM>
    -VMRole <CloudVmRole>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Join-SCVirtualMachine wird ein verwaister virtueller Computer erneut seiner Dienst- oder VM-Rolle zugeordnet.

Wenn ein Host oder Cluster aus Virtual Machine Manager (VMM) entfernt wird, bleiben alle virtuellen Computer, die zu einem Dienst oder einer VM-Rolle gehören, die auf dem Host bereitgestellt werden, funktionsfähig. Wenn Sie den Host oder Cluster jedoch wieder zu VMM hinzufügen, werden die virtuellen Maschinen verwaist, da sie keine Zuordnung mehr zu ihrem Dienst oder ihrer Rolle als virtueller Computer haben.

Mit diesem Cmdlet können Sie die Zuordnung zwischen einem virtuellen Computer und seinem Dienst oder seiner Rolle als virtueller Computer wiederherstellen. Das Cmdlet Join-SCVirtualMachine führt eine Aufgabe zum erneuten Zuordnen auf VMM aus, die eine Reihe von Überprüfungen ausführt, mit denen die Kompatibilität des virtuellen Computers mit der Dienstvorlage bestätigt werden kann.

Wenn das Cmdlet die Kompatibilität des virtuellen Computers mit der Vorlage für die Computerebene überprüft, werden reine 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 auf ihm ausgeführt werden, intakt sind.

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

Die besten Ergebnisse erzielen Sie, wenn Sie dieses Cmdlet mit einem virtuellen Computer verwenden, der ursprünglich Teil einer Dienst- oder VM-Rollenbereitstellung war und nicht geändert wurde.

Beispiele

Beispiel 1: Verbinden eines verwaisten virtuellen Computers mit 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 sie dann in der Variablen $CT.

Mit dem letzten Befehl wird der virtuelle Computer in $VM mit der Computerebene in $CT verknüpft.

Beispiel 2: Verknüpfen eines verwaisten virtuellen Computers mit einer VM-Rolle

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 mit dem Namen ContosoShop ab und speichert sie dann in der Variablen $VmRole.

Mit dem letzten Befehl wird der virtuelle Computer in $VM mit der Rolle in $VMRole verknüpft.

Parameter

-ComputerTier

Gibt ein ComputerTier-Objekt an.

Parametereigenschaften

Typ:ComputerTier
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ServiceComputerTierParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VM

Gibt ein VM-Objekt an.

Parametereigenschaften

Typ:VM
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMRole

Gibt ein CloudVMRole-Objekt an.

Parametereigenschaften

Typ:CloudVmRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VMRoleParameterSet
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.