Get-SCVMMServer
Stellt eine Verbindung mit einem VMM-Verwaltungsserver her, wenn noch keine Verbindung vorhanden ist, oder stellt eine Verbindung mit einem anderen VMM-Verwaltungsserver her.
Syntax
Default (Standardwert)
Get-SCVMMServer
[-ComputerName] <String>
[-TCPPort <Int32>]
[-ConnectAs <Profile>]
[-UserRoleName <String>]
[-Credential <PSCredential>]
[-RetainObjectCache]
[-RetainDeletedObjects]
[-AllowJobGC]
[-SetAsDefault]
[-ForOnBehalfOf]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-SCVMMServer stellt eine Verbindung mit einem Virtual Machine Manager (VMM)-Verwaltungsserver her, wenn noch keine Verbindung besteht, und ruft das Serverobjekt aus der VMM-Datenbank ab. Der Standardport, der zum Herstellen einer Verbindung mit einem VMM-Server verwendet wird, ist TCP-Port 8100.
Wenn Sie über die Benutzeroberfläche eine Verbindung mit einem VMM-Verwaltungsserver erstellt haben, stellt diese Befehlsshell beim Öffnen einer VMM-Befehlsshell automatisch eine Verbindung mit demselben VMM-Verwaltungsserver her. Wenn Sie zuvor keine Verbindung mit dem VMM-Verwaltungsserver über die Benutzeroberfläche hergestellt haben, müssen Sie Get-SCVMMServer verwenden, um eine Verbindung herzustellen. Beachten Sie, dass Sie, wenn Sie eine Verbindung mit einem VMM-Verwaltungsserver nur über die VMM-Befehlsshell herstellen, den Parameter SetAsDefault verwenden müssen, um die Verbindung von Sitzung zu Sitzung beizubehalten, oder die Verbindung mit dem VMM-Server jedes Mal wiederherstellen müssen, wenn Sie eine neue VMM-Befehlsshellsitzung öffnen.
Sie können auch Get-VMMServer verwenden, um eine Verbindung mit einem anderen VMM-Verwaltungsserver herzustellen.
Nachdem eine Verbindung mit dem VMM-Verwaltungsserver hergestellt wurde, verwenden alle zukünftigen Befehle, die in der Befehlszeile der VMM-Befehlsshell ausgeführt werden und das VMM-Serverobjekt erfordern, automatisch die vorhandene Verbindung, bis Sie das VMM-Befehlsshellfenster schließen.
Der VMM-Dienst, der auf dem VMM-Verwaltungsserver ausgeführt wird, unterstützt die VMM-Datenbank. Diese Datenbank wird in Microsoft SQL Server entweder auf dem VMM-Verwaltungsserver selbst oder auf einem separaten Server gespeichert, auf dem SQL Server ausgeführt wird.
Mit dem VMM-Dienst können Sie Ihre virtuelle Umgebung verwalten, einschließlich Hostservern (auf denen virtuelle Maschinen gehostet werden), Bibliothekservern (auf denen VMM-Bibliotheksressourcen gespeichert sind) und virtuellen Maschinen, die auf einem Host bereitgestellt oder in der Bibliothek gespeichert sind.
Weitere Informationen zum Herstellen einer Verbindung mit dem VMM-Verwaltungsserver erhalten Sie, indem Sie Get-Help about_VMM_2016_Connecting_to_the_VMM_Server.
Beispiele
Beispiel 1: Herstellen einer Verbindung mit einem VMM-Server
PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
Dieser Befehl stellt eine Verbindung mit dem VMM-Server mit dem Namen VMMServer01 her, der sich in der Domäne "Contoso" befindet, und ruft das Serverobjekt aus der VMM-Datenbank ab.
Beispiel 2: Herstellen einer Verbindung mit einem VMM-Server über einen bestimmten Port
PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com" -TCPPort 8100
Mit diesem Befehl wird über den TCP-Port 8100 eine Verbindung mit dem VMM-Server mit dem Namen VMMServer01 hergestellt, der sich in der Domäne "Contoso" befindet.
Beispiel 3: Herstellen einer Verbindung mit einem VMM-Server und Abrufen des .NET-Objekttyps, der Methoden und Eigenschaften
PS C:\> $VMMServer = Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VMMServer | Get-Member
PS C:\> $VMMServer | Get-Member | Format-List
Mit dem ersten Befehl wird das VMM-Serverobjekt mit dem Namen VMMServer01 abgerufen und in der Variablen $VMMServer gespeichert.
Der zweite Befehl übergibt das in $VMMServer gespeicherte VMM-Serverobjekt an das Cmdlet Get-Member , das Folgendes abruft und anzeigt:
TypeName: Der .NET-Typname des VMM-Serverobjekts: Microsoft.SystemCenter.VirtualMachineManager.Remoting.ServerConnection
MemberType: Eine Liste mit dem Namen und der Definition für jedes Ereignis, jede Methode und jede Eigenschaft, die diesem Objekttyp zugeordnet sind.
Mit dem dritten Befehl werden dieselben Informationen wie der zweite Befehl abgerufen und angezeigt, mit der Ausnahme, dass die Ausgabe an das Cmdlet Format-List weitergeleitet wird, um die vollständige Definition für jede Methode und jede Eigenschaft für das VMM-Serverobjekt anzuzeigen.
Beispiel 4: Herstellen einer Verbindung mit einem anderen VMM-Server mit einer anderen Benutzerrolle
PS C:\> Get-SCVMMServer -ComputerName "VMMServer02.Contoso.com" -ConnectAs "DelegatedAdmin"
Mit diesem Befehl wird mithilfe der Benutzerrolle "DelegatedAdmin" eine Verbindung mit dem VMM-Server mit dem Namen VMMServer02 hergestellt, der sich in der Domäne "Contoso" befindet.
Parameter
-AllowJobGC
Gibt an, dass die Garbage Collection für Aufträge zulässig ist.
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 |
-ComputerName
Gibt den Namen eines Computers an, den VMM in Ihrem Netzwerk eindeutig identifizieren kann. Die zulässigen Werte für diesen Parameter sind:
- FQDN (vollqualifizierter Domainname)
- IPv4- oder IPv6-Adresse
- NetBIOS-Name
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ConnectAs
Gibt die VMM-Benutzerrolle an, die verwendet werden soll, wenn der Benutzer Mitglied mehrerer Rollen ist, wenn er über die VMM-Befehlsshell eine Verbindung mit dem VMM-Verwaltungsserver herstellt. Die zulässigen Werte für diesen Parameter sind:
- Administrator
- Delegierter Administrator
- ReadOnlyAdmin
- SelfServiceBenutzer
VMM-Administratoren können alle VMM-Objekte verwalten. Delegierte Administratoren und Self-Service-Benutzer können nur auf die Objekte zugreifen und diese ändern, die sich im Bereich ihrer Benutzerrollen befinden. Read-Only-Administratoren können nur die Eigenschaften vorhandener Objekte anzeigen. Sie können keine neuen Objekte erstellen oder die Eigenschaften vorhandener Objekte ändern.
Parametereigenschaften
| Typ: | Profile |
| Standardwert: | None |
| Zulässige Werte: | Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| 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 |
-Credential
Gibt ein Objekt mit Anmeldeinformationen oder bei einigen Cmdlets ein ausführendes Kontoobjekt an, das den Benutzernamen und das Kennwort eines Kontos enthält, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Oder, im Fall von Restart-SCJob, verfügt über die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.
Geben Sie weitere Informationen zum PSCredential-Objekt ein Get-Help Get-Credential.
Weitere Informationen zu ausführenden Konten erhalten Sie, wenn Sie Get-Help New-SCRunAsAccounteingeben.
Parametereigenschaften
| Typ: | PSCredential |
| 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 |
-ForOnBehalfOf
Gibt an, dass ein Administrator OnBehalfOf-Parameter für VMM-Cmdlets verwenden kann, sofern verfügbar. Dieser Parameter wird in erster Linie für Service Provider Foundation-Verbindungen mit VMM verwendet.
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 |
-RetainDeletedObjects
Gibt an, dass Objekte im Cache, die zum Löschen markiert sind, beibehalten werden. Möglicherweise benötigen Sie diesen Parameter nur, wenn Sie eine Benutzeroberfläche auf der VMM-Befehlsshell erstellen.
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 |
-RetainObjectCache
Gibt an, dass die Objekte im Cache im Arbeitsspeicher verbleiben und nicht von der Garbage Collection freigegeben werden. Möglicherweise benötigen Sie diesen Parameter, wenn Sie eine Benutzeroberfläche auf der VMM-Befehlsshell erstellen.
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 |
-SetAsDefault
Gibt an, dass die VMM-Befehlsshell für diese Sitzung eine Verbindung mit dem angegebenen VMM-Verwaltungsserver herstellt und diese Verbindung für zukünftige Sitzungen beibehält, wenn sie auf $True festgelegt ist.
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 |
-TCPPort
Gibt einen numerischen Wert an, der einen TCP-Port darstellt.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Hafen |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserRoleName
Gibt den Namen einer Benutzerrolle an. Zu den benannten Arten von Benutzerrollen gehören:
- Delegierter Administrator
- Read-Only Administrator
- Self-Service Benutzer
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 |
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.