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.
Ähnliche Themen
- Get-SCVirtualMachine
- Move-SCVirtualMachine
- New-SCVirtualMachine
- Read-SCVirtualMachine
- Register-SCVirtualMachine
- Remove-SCVirtualMachine
- Repair-SCVirtualMachine
- Reset-SCVirtualMachine
- Resume-SCVirtualMachine
- Save-SCVirtualMachine
- Set-SCVirtualMachine
- Start-SCVirtualMachine
- Stop-SCVirtualMachine
- Suspend-SCVirtualMachine