Konfigurieren und Verwenden Service Manager Cmdlets für Windows PowerShell
Wichtig
Diese Version von Service Manager das Ende des Support erreicht hat. Es wird empfohlen, dass Sie ein Upgrade auf Service Manager 2019 durchführen.
Dieser Artikel bietet eine Einführung in die Service Manager-Cmdlets für die Windows PowerShell-Befehlszeilenschnittstelle.
Bevor Sie einen befehlsbasierten Befehl in Windows PowerShell Befehlszeilenschnittstelle in Service Manager ausführen können, müssen Sie die Ausführungsrichtlinie auf RemoteSigned festlegen. Bevor Sie Data Warehouse-Cmdlets ausführen können, müssen Sie das Data Warehouse-Cmdlets-Modul manuell importieren.
Die Service Manager Cmdlets werden in den folgenden beiden Modulen implementiert:
System.Center.Service.Manager. Dieses Modul wird automatisch importiert, wenn eine Service Manager Windows PowerShell geöffnet wird.
Microsoft.EnterpriseManagement.Warehouse.Cmdlets. Dieses Modul muss manuell importiert werden.
Erste Schritte mit Service Manager Cmdlets
Bei Windows PowerShell handelt es sich um eine Windows-Befehlszeilenshell mit einer interaktiven Eingabeaufforderung und einer Skriptumgebung. Windows PowerShell verwendet Cmdlets, um die Windows PowerShell bearbeiten. Service Manager enthält viele Cmdlets, mit denen Sie verschiedene aufgabenbezogene Service Manager ausführen können, ohne die Service Manager verwenden. Beispielsweise können Sie das Cmdlet Import-SCSMManagementPack verwenden, um ein Management Pack zu importieren.
Die Service Manager Cmdlets werden in zwei Modulen bereitgestellt, die unten aufgeführt sind. In Service Manager werden diese Cmdlet-Module nicht im typischen Pfad installiert, der in der Variablen $env:PSModulePath aufgeführt ist. Wenn Sie das Cmdlet ausführen, werden Get-Module -List die Service Manager daher nicht aufgeführt.
Administrator-Cmdlets: Das System.Center.Service.Manager-Modul, das die Cmdlets enthält, die für allgemeine Verwaltungsaufgaben erforderlich sind.
Data Warehouse-Cmdlets: Das Microsoft.EnterpriseManagement.Warehouse.Cmdlets-Modul, das die Cmdlets enthält, die für den Betrieb im Service Manager Data Warehouse erforderlich sind.
Die Data Warehouse-Cmdlets arbeiten mit der Data Warehouse-Datenbank, und Sie können sie sowohl auf dem Service Manager-Verwaltungsserver als auch auf dem Data Warehouse-Verwaltungsserver ausführen.
Die von einem Windows PowerShell-Befehl zurückgelieferten Daten enthalten u. U. weitere Informationen, die in einem Standardbefehlsfenster der Windows PowerShell angezeigt werden können. Es wird empfohlen, die Breite des Befehlsfensters zu erhöhen: Klicken Sie mit der rechten Maustaste auf die Titelleiste, klicken Sie auf Eigenschaften,und legen Sie auf der Registerkarte Layout die Bildschirmpuffergröße auf 120 fest.
Die folgenden Verfahren helfen Ihnen beim Einstieg in Service Manager Cmdlets.
So öffnen Sie eine Service Manager Windows PowerShell über die Service Manager-Konsole
Klicken Sie in der Service Manager-Konsole auf Verwaltung.
Klicken Sie im Bereich Aufgaben auf PowerShell-Sitzung starten.
Das Administrator-Cmdlet-Modul wird in dieser Sitzung automatisch vorab importiert.
So öffnen Sie Service Manager Windows PowerShell Sitzung über Windows
Klicken Sie auf dem Computer, der den Service Manager-Verwaltungsserver hostet, auf der Taskleiste auf Start, zeigen Sie auf Alle Programme ,und klicken Sie dann auf Microsoft System Center.
Klicken Service Manager auf , und klicken Sie dann auf Service Manager Shell.
Das Administrator-Cmdlet-Modul wird in dieser Sitzung automatisch vorab importiert.
So listen Sie Service Manager Cmdlets auf
Öffnen Sie eine Service Manager Windows PowerShell Sitzung.
Geben Sie zum Auflisten der cmdlets, die im Administratormodul enthalten sind, in der Service Manager Windows PowerShell-Sitzung Folgendes ein, und drücken Sie dann die EINGABETASTE:
Get-Command -module System.Center.Service.ManagerGeben Sie zum Auflisten der im Data Warehouse-Modul enthaltenen Cmdlets in der Service Manager Windows PowerShell-Sitzung Folgendes ein, und drücken Sie dann die EINGABETASTE:
Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
So erhalten Sie Hilfe zu einem Cmdlet
Öffnen Sie eine Service Manager Windows PowerShell Sitzung.
Sie können jetzt auf die vorgeschachtelte Hilfe zugreifen, oder Sie können den Parameter verwenden, um auf die aktuelle
-onlineOnlinehilfe zu zugreifen:On-the-box Help (Hilfe im Feld): Geben Sie den folgenden Befehl ein. Ersetzen Sie cmdlet-name durch den Namen des Cmdlets, für das Sie Hilfe erhalten möchten, z. B. Import-SCSMManagementPack:
Get-help <cmdlet-name> -detailedOnline, aktuelle Hilfe: Geben Sie den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
Get-help <cmdlet-name> -onlineDieser Befehl verwendet den Parameter
-onlinefür den Zugriff auf die neueste Onlinehilfe für ein Cmdlet. Es öffnet einen Webbrowser und zeigt die Onlinehilfe an, die für den Cmdlet-Namen verfügbar ist.
Liste der Service Manager Cmdlets
Service Manager unterstützt die folgenden Windows PowerShell-Cmdlets, die in zwei Modulen implementiert sind: das Administratormodul und das Data Warehouse-Modul.
Administrator-Cmdlets im System.Center.Service.Manager-Modul
| Cmdlet | BESCHREIBUNG |
|---|---|
| Add-SCSMAllowListClass | Fügt der Liste Zulassen die angegebenen Klassen hinzu, die während der Synchronisierung vom Service Manager Operations Manager CI-Connector verwendet werden. |
| Export-SCSMManagementPack | Exportiert ein Management Pack als gültige XML-formatierte Datei, die Sie später in Service Manager oder Operations Manager. |
| Get-SCSMAllowList | Ruft die Liste Zulassen der Klassen ab, die während der Synchronisierung vom Service Manager Operations Manager CI-Connector verwendet werden. |
| Get-SCSMAnnouncement | Ruft Ankündigungen ab, die in der Service Manager. |
| Get-SCSMChannel | Ruft die E-Mail-Benachrichtigungskanäle ab, die in der Service Manager. |
| Get-SCSMClass | Ruft eine Klasse ab. |
| Get-SCSMClassInstance | Ruft Klasseninstanzobjekte ab. |
| Get-SCSMCommand | |
| Get-SCSMConnector | Ruft Connectors ab, die in der Service Manager. |
| Get-SCSMDCMWorkflow | Ruft die Liste der gewünschten Konfigurationsverwaltungsworkflows ab, die in der Service Manager. |
| Get-SCSMDeletedItem | Ruft Elemente ab, die zum Löschen in einem -Service Manager. |
| Get-SCSMDiscovery | Ruft Ermittlungsinformationen aus Operations Manager und aus Service Manager. |
| Get-SCSMEmailTemplate | Ruft E-Mail-Vorlagen ab, die in der Service Manager. |
| Get-SCSMEmailTemplateContent | Ruft den Inhalt der E-Mail Service Manager vorlagen ab. |
| Get-SCSMGroup | Ruft Gruppen aus Operations Manager und aus Service Manager. |
| Get-SCSMManagementGroupConnection | Ruft alle Verwaltungsgruppenverbindungen ab, einschließlich des IsActive-Status dieser Verbindungen. Nur für eine Verbindung ist der IsActive-Status auf True festgelegt, da immer nur eine Verbindung aktiv sein kann. |
| Get-SCSMManagementPack | Ruft Objekte ab, die importierte Management Packs darstellen. |
| Get-SCSMObjectTemplate | Ruft eine Objektvorlage ab. |
| Get-SCSMQueue | Ruft Warteschlangen ab, die in der Service Manager. |
| Get-SCSMRelationship | Ruft Informationen zu Beziehungsobjekten aus Operations Manager und aus Service Manager. |
| Get-SCSMRelationshipInstance | Ruft die Instanzen von Beziehungen aus Operations Manager und aus Service Manager. |
| Get-SCSMRunAsAccount | Ruft die ausgeführten Konten ab. |
| Get-SCSMSetting | Ruft die Konfigurationseinstellungen der System Center Service Manager. |
| Get-SCSMSubscription | Ruft Abonnements ab, die in der Service Manager. |
| Get-SCSMTask | Ruft Tasks ab, die in der Service Manager. |
| Get-SCSMUser | Ruft Benutzer ab, die in der Service Manager. |
| Get-SCSMUserRole | Ruft Benutzerrollen ab, die in der -Service Manager. |
| Get-SCSMView | Ruft Ansichten ab, die in der -Service Manager. |
| Get-SCSMWorkflow | Ruft Konfigurationsinformationen für Service Manager ab. |
| Get-SCSMWorkflowStatus | Ruft den Status von Workflows in Service Manager. |
| Import-SCSMInstance | Importiert Objekte und Beziehungen aus einer durch Komma getrennten Wertdatei (.csv) in Service Manager. |
| Import-SCSMManagementPack | Importiert Management Packs. |
| New-SCOrchestratorConnector | Erstellt einen neuen Service Manager Orchestrator-Connector. |
| New-SCRelationshipInstance | Erstellt eine Instanz einer Beziehung. |
| New-SCSMADConnector | Erstellt einen neuen Active Directory-Connector. |
| New-SCSMAlertRule | Erstellt eine Warnungsregel für die Verwendung mit einem Operations Manager Warnungsconnector in Service Manager. |
| New-SCSMAnnouncement | Erstellt eine neue Ankündigung in Service Manager. |
| New-SCSMClassInstance | Fügt der Datenbank eine Klasseninstanz hinzu. |
| New-SCSMCMConnector | Erstellt einen neuen Konfigurations-Manager-Connector in Service Manager. |
| New-SCSMDCMWorkflow | Erstellt einen neuen Workflow für die Gewünschte Konfigurationsverwaltung in Service Manager. |
| New-SCSMEmailTemplate | Erstellt eine neue E-Mail-Vorlage für Service Manager. |
| New-SCSMManagementGroupConnection | Erstellt eine neue Verbindung für die angegebene Verwaltungsgruppe. Die letzte erstellte Verwaltungsgruppenverbindung ist die aktive Verbindung, die von Get-Cmdlets standardmäßig verwendet wird. Dabei haben Sie weder computerName noch credentialnoch die SCSession-Parameter angegeben. |
| New-SCSMManagementPack | Erstellt ein neues Management Pack. |
| New-SCSMManagementPackBundle | Bündelt einzelne Management Packs und deren Ressourcen und erstellt ein neues Management Pack-Paket. |
| New-SCSMOMAlertConnector | Erstellt einen neuen Operations Manager Warnungsconnector in Service Manager. |
| New-SCSMOMConfigurationItemConnector | Erstellt einen neuen Operations Manager CI-Connector in Service Manager. |
| New-SCSMRunAsAccount | Erstellt ein neues run as-Konto. |
| New-SCSMSubscription | Erstellt ein neues Abonnement in Service Manager. |
| New-SCSMUserRole | Erstellt eine neue Benutzerrolle in Service Manager. |
| New-SCSMWorkflow | Erstellt einen neuen Workflow in Service Manager. |
| New-SCVMMConnector | Erstellt einen neuen Service Manager Virtual Machine Manager Connector. |
| Protect-SCSMManagementPack | Versiegelt ein Management Pack, um zu verhindern, dass es geändert wird. |
| Remove-SCSMAllowListClass | Entfernt die angegebenen Klassen aus der Liste Zulassen der Klassen, die vom Operations Manager CI-Connector während der Synchronisierung in Service Manager. |
| Remove-SCSMAnnouncement | Entfernt eine Ankündigung aus Service Manager. |
| Remove-SCSMClassInstance | Entfernt eine Instanz eines Konfigurationselementobjekts. |
| Remove-SCSMConnector | Entfernt einen Connector aus Service Manager. |
| Remove-SCSMDCMWorkflow | Entfernt einen gewünschten Konfigurationsverwaltungsworkflow aus Service Manager. |
| Remove-SCSMEmailTemplate | Entfernt eine E-Mail-Vorlage aus Service Manager. |
| Remove-SCSMManagementGroupConnection | Entfernt eine Verwaltungsgruppenverbindung. |
| Remove-SCSMManagementPack | Entfernt Management Packs. |
| Remove-SCSMRunAsAccount | Entfernt ein run as-Konto. |
| Remove-SCSMSubscription | Entfernt ein Abonnement aus Service Manager. |
| Remove-SCSMUserRole | Entfernt eine Benutzerrolle aus Service Manager. |
| Remove-SCSMWorkflow | Entfernt einen Workflow aus Service Manager. |
| Reset-SCSMAllowList | Setzt die Liste Zulassen von Klassen zurück, die vom Operations Manager CI-Connector in Service Manager standardmäßig auf die Liste Zulassen festgelegt wird. |
| Restore-SCSMDeletedItem | Stellt Elemente wieder wieder auf, die zuvor in einem Service Manager. |
| Set-SCSMChannel | Legt die Eigenschaften des E-Mail-Benachrichtigungskanals in Service Manager. |
| Set-SCSMManagementGroupConnection | Legt die angegebene Verbindung als aktive Verbindung fest. Die aktive Verbindung ist die Verbindung, die implizit verwendet wird, wenn Sie ein Get-Cmdlet ausführen, ohne die Parameter -ComputerName und -Credential oder -SCSession anzugeben. Es kann immer nur eine Verbindung aktiv sein, und standardmäßig ist die aktive Verbindung die letzte Verbindung, die mit dem Cmdlet New-SCManagementGroupConnection erstellt wurde. |
| Start-SCSMConnector | Startet einen Service Manager Connector. |
| Test-SCSMManagementPack | Testet die Gültigkeit eines Management Packs. |
| Update-SCSMAnnouncement | Aktualisiert die Eigenschaften einer Ankündigung für Service Manager. |
| Update-SCSMClassInstance | Aktualisiert Eigenschaftswerte einer Konfigurationselementklasseninstanz. |
| Update-SCSMConnector | Aktualisiert die Eigenschaften eines Service Manager Connectors. |
| Update-SCSMDCMWorkflow | Aktualisiert die Eigenschaften eines gewünschten Konfigurationsverwaltungsworkflows. |
| Update-SCSMEmailTemplate | Aktualisiert die Eigenschaften einer E-Mail-Vorlage. |
| Update-SCSMRunAsAccount | Aktualisiert die Anmeldeinformationen, die einem ausgeführten Konto zugeordnet sind. |
| Update-SCSMSetting | Aktualisiert die Konfigurationseinstellungen für Service Manager. |
| Update-SCSMSubscription | Aktualisiert Abonnementeigenschaften in Service Manager. |
| Update-SCSMUserRole | Legt die UserRole-Eigenschaft für einen Service Manager Benutzer fest. |
| Update-SCSMWorkflow | Aktualisiert Workfloweigenschaften. |
Data Warehouse Cmdlets im Modul Microsoft.EnterpriseManagement.Warehouse.Cmdlets
| Cmdlet | BESCHREIBUNG |
|---|---|
| Disable-SCDWJob | Deaktivieren eines Data Warehouse-Auftrags, um dessen Ausführung zu unterbinden. |
| Disable-SCDWJobSchedule | Das Cmdlet Disable-SCDWJobSchedule deaktiviert einen Data Warehouse Auftragszeitplan, wodurch der Auftragszeitplan das Initiieren von Aufträgen beendet. Wenn der Auftragszeitplan zuvor aktiviert war, bleiben dessen Einstellungen beim Deaktivieren erhalten. Um die Auftragszeitplaneinstellungen zu ändern, führen Sie das Cmdlet Set-SCDWJobSchedule aus. |
| Disable-SCDWSource | Aktiviert alle Aufträge, die der angegebenen Datenquelle zugeordnet sind. |
| Enable-SCDWJob | Aktiviert einen Data Warehouse-Auftrag, damit er seinem Zeitplan entsprechend ausgeführt werden kann. |
| Enable-SCDWJobSchedule | Mit dem Cmdlet Enable-SCDWJobSchedule können Data Warehouse Administratoren Auftragszeitpläne aktivieren, sodass Aufträge gemäß ihrem angegebenen Zeitplan ausgeführt werden. Verwenden Sie zum Deaktivieren des Auftragszeitplans das Cmdlet Disable-SCDWJobSchedule. |
| Enable-SCDWSource | Aktiviert alle Aufträge, die der angegebenen Datenquelle zugeordnet sind. |
| Get-SCDWEntity | Ruft die Liste der Faktentabellen, Dimensionen, Tabellen und Outrigger ab, die in einem Data Warehouse vorhanden sind. |
| Get-SCDWJob | Ruft den Auftragsstatus aller wiederkehrenden Aufträge ab, einschließlich ETL-Aufträge (Extrahieren, Transformieren und Laden). |
| Get-SCDWJobModule | Gibt detaillierte Informationen zum angegebenen Auftrag zurück. Dazu zählen Informationen zu Auftragsmodulen, die als Teil des Auftrags ausgeführt werden. |
| Get-SCDWJobSchedule | Das Cmdlet Get-SCDWJobSchedule zeigt Planungsinformationen für Data Warehouse Aufträge an. Sie können den JobName-Parameter verwenden, um einen Auftrag anzugeben, für den Planungsinformationen angezeigt werden sollen. Andernfalls zeigt das Cmdlet Get-SCDWJobSchedule Planungsinformationen für alle Data Warehouse Aufträge an. |
| Get-SCDWModule | |
| Get-SCDWRetentionPeriod | Der Data Warehouse wahrt Zeilen nach einer vordefinierten Beibehaltungsdauer auf. Dieses Cmdlet gibt den Aufbewahrungszeitraum für eine bestimmte Entität in Minuten an. Wenn keine Entität bereitgestellt wird, wird die Standardaufbewahrungsdauer für alle Entitäten zurückerhalten. |
| Get-SCDWSource | Aktiviert alle Aufträge, die der angegebenen Datenquelle zugeordnet sind. |
| Get-SCDWSourceType | Ruft die Datenquellentypen ab, die beim Data Warehouse registriert werden können. |
| Get-SCDWWatermark | Ruft das neueste Wasserzeichen für das angegebene Auftragsmodul ab. |
| New-SCDWSourceType | Um eine Quelle beim Data Warehouse zu registrieren, muss der Datenquellentyp zuerst beim Data Warehouse registriert werden. Mit diesem Cmdlet können Sie einen neuen Datenquellentyp registrieren, indem das geeignete Management Pack importiert und die entsprechenden Konfigurationsänderungen vorgenommen werden. |
| Register-SCDWSource | Registriert Instanzen von Datenquellentypen wie Service Manager, Operations Manager und Konfigurations-Manager im Data Warehouse. |
| Set-SCDWJobSchedule | Legt den Zeitplan für einen Data Warehouse-Auftrag fest. |
| Set-SCDWRetentionPeriod | Legt die Datenaufbewahrungsdauer in Minuten für eine bestimmte Faktentabelle innerhalb einer bestimmten Data Warehouse-Datenbank oder die Standardeinstellung für Faktentabellen innerhalb der Datenbank fest. |
| Set-SCDWSource | Aktualisiert die Definition von Klassen und Beziehungen, die für eine Instanz einer Datenquelle aufgefüllt werden können. |
| Set-SCDWWatermark | – Legt das Wasserzeichen fest, ab dem die nachfolgende Datenverarbeitung fortgesetzt werden soll. |
| Start-SCDWJob | Startet einen Data Warehouse-Auftrag. |
| Unregister-SCDWManagememtPack | |
| Unregister-SCDWSource | Aufheben der Registrierung einer Datenquelle beim Data Warehouse. |
Nächste Schritte
- Verwalten Sie das Data Warehouse, um Wartungstasks für Data Warehouse-Aufträge auszuführen.