Konfigurieren und Verwenden von Service Manager-Cmdlets für Windows PowerShell
Dieser Artikel bietet eine Einführung in die Service Manager-Cmdlets für die Windows PowerShell-Befehlszeilenschnittstelle.
Bevor Sie einen Befehl in der Windows PowerShell-Befehlszeilenschnittstelle in Service Manager ausführen können, müssen Sie die Ausführungsrichtlinie auf „RemoteSigned“ setzen. Bevor Sie Data Warehouse-Cmdlets ausführen können, müssen Sie das Data Warehouse-Cmdlets-Modul manuell importieren.
Die Cmdlets für den Service Manager sind in den folgenden beiden Modulen implementiert:
System.Center.Service.Manager. Dieses Modul wird automatisch importiert, wenn eine Service Manager-Windows PowerShell-Sitzung geöffnet wird.
Microsoft.EnterpriseManagement.Warehouse.Cmdlets. Dieses Modul muss manuell importiert werden.
Erste Schritte mit Service Manager-Cmdlets
Windows PowerShell ist eine Windows-Befehlszeilen-Shell, die eine interaktive Eingabeaufforderung und eine Skripting-Umgebung enthält. Windows PowerShell verwendet Cmdlets zum Bearbeiten der Windows PowerShell-Objekte. Service Manager enthält viele Cmdlets, mit denen Sie verschiedene Service Manager-bezogene Aufgaben ausführen können, ohne die Service Manager-Konsole zu verwenden. Sie können zum Beispiel das Cmdlet Import-SCSMManagementPack verwenden, um ein Management Pack zu importieren.
Die Service Manager-Cmdlets werden in zwei Modulen bereitgestellt, die im Folgenden aufgeführt sind. In Service Manager werden diese Cmdlet-Module nicht in dem typischen Pfad installiert, der in der Variablen $env:PSModulePath aufgeführt ist. Wenn Sie das Cmdlet Get-Module -List ausführen, werden die Service Manager-Module daher nicht aufgelistet.
Administrator-Cmdlets: Das Modul System.Center.Service.Manager, das die Cmdlets enthält, die für allgemeine Verwaltungsaufgaben benötigt werden.
Data Warehouse-Cmdlets: Das Modul Microsoft.EnterpriseManagement.Warehouse.Cmdlets, das die Cmdlets enthält, die für die Arbeit mit dem Service Manager Data Warehouse erforderlich sind.
Die Data Warehouse-Cmdlets arbeiten auf der Data Warehouse-Datenbank und können sowohl auf dem Service Manager-Verwaltungsserver als auch auf dem Data Warehouse-Verwaltungsserver ausgeführt werden.
Daten, die vom Windows PowerShell-Befehl zurückgegeben werden, enthalten möglicherweise mehr Informationen, als in einem Windows PowerShell-Standardbefehlsfenster angezeigt werden können. Wir empfehlen, die Breite des Befehlsfensters zu vergrößern: Klicken Sie mit der rechten Maustaste auf die Titelleiste, wählen Sie Eigenschaften aus, und setzen Sie auf der Registerkarte Layout die Bildschirmpuffergröße auf 120.
Die folgenden Verfahren helfen Ihnen bei den ersten Schritten mit Service Manager-Cmdlets.
Öffnen einer Dienst-Manager-Windows PowerShell-Sitzung über die Dienst-Manager-Konsole
Wählen Sie in der Service Manager-Konsole Verwaltung.
Wählen Sie im Bereich Aufgaben die Option PowerShell-Sitzung starten.
Das Administrator-Cmdlet-Modul wird in dieser Sitzung automatisch vorimportiert.
Öffnen einer Dienst-Manager-Windows PowerShell-Sitzung über Windows
Wählen Sie auf dem Computer, auf dem sich der Service Manager-Verwaltungsserver befindet, in der Taskleiste Start, zeigen Sie auf Alle Programme, und wählen Sie Microsoft System Center.
Wählen Sie Service Manager <Version>, und wählen Sie Service Manager Shell.
Das Administrator-Cmdlet-Modul wird in dieser Sitzung automatisch vorimportiert.
Alle Dienst-Manager-Cmdlets auflisten
Öffnen Sie eine Service Manager Windows PowerShell-Sitzung.
Um die Cmdlets aufzulisten, die im Administratormodul enthalten sind, geben Sie in der Service Manager-Windows PowerShell-Sitzung Folgendes ein, und drücken Sie dann die EINGABETASTE:
Get-Command -module System.Center.Service.ManagerUm die Cmdlets aufzulisten, die im Data Warehouse-Modul enthalten sind, geben Sie in der Service Manager Windows PowerShell-Sitzung Folgendes ein, und drücken Sie dann die EINGABETASTE:
Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
Hilfe zu einem Cmdlet abrufen
Öffnen Sie eine Service Manager Windows PowerShell-Sitzung.
Sie können nun auf die integrierte Hilfe zugreifen, oder Sie können den Parameter
-onlineverwenden, um die aktuellste Onlinehilfe aufzurufen:On-the-Box-Hilfe: 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
-online-Parameter, um auf die neueste Onlinehilfe für ein Cmdlet zuzugreifen. Es öffnet einen Webbrowser und zeigt die Onlinehilfe an, die für cmdlet-name 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 Modul System.Center.Service.Manager
| Cmdlet | Beschreibung |
|---|---|
| Add-SCSMAllowListClass | Fügt die angegebenen Klassen zur Liste zugelassener 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 importieren können. |
| Get-SCSMAllowList | Ruft die Liste zugelassener Klassen ab, die während der Synchronisierung vom Service Manager Operations Manager CI Connector verwendet werden. |
| Get-SCSMAnnouncement | Ruft Ankündigungen ab, die in Service Manager definiert sind. |
| Get-SCSMChannel | Ruft die E-Mail-Benachrichtigungskanäle ab, die im Dienst-Manager definiert sind. |
| Get-SCSMClass | Ruft eine Klasse ab. |
| Get-SCSMClassInstance | Ruft Klasseninstanzobjekte ab. |
| Get-SCSMCommand | |
| Get-SCSMConnector | Ruft Connectors ab, die im Service Manager definiert sind. |
| Get-SCSMDCMWorkflow | Ruft die Liste der gewünschten Konfigurationsverwaltungsworkflows ab, die in Service Manager definiert sind. |
| Get-SCSMDeletedItem | Ruft Elemente ab, die für den Löschvorgang im Service Manager markiert wurden. |
| Get-SCSMDiscovery | Ruft Ermittlungsinformationen aus Operations Manager und von Service Manager ab. |
| Get-SCSMEmailTemplate | Ruft E-Mail-Vorlagen ab, die im Service Manager definiert sind. |
| Get-SCSMEmailTemplateContent | Ruft den Inhalt der E-Mail-Vorlagen von Service Manager ab. |
| Get-SCSMGroup | Ruft Gruppen aus Operations Manager und vom Service Manager ab. |
| Get-SCSMManagementGroupConnection | Ruft alle Verwaltungsgruppenverbindungen ab, einschließlich des IsActive-Status dieser Verbindungen. Nur für eine Verbindung wird der Status „IsActive“ auf „True“ festgelegt, da immer nur eine Verbindung aktiv sein kann. |
| Get-SCSMManagementPack | Ruft Objekte ab, die Management Packs darstellen, die importiert wurden. |
| Get-SCSMObjectTemplate | Ruft eine Objektvorlage ab. |
| Get-SCSMQueue | Ruft Warteschlangen ab, die in Service Manager definiert sind. |
| Get-SCSMRelationship | Ruft Informationen zu Beziehungsobjekten aus Operations Manager und von Service Manager ab. |
| Get-SCSMRelationshipInstance | Ruft die Instanzen von Beziehungen aus Operations Manager und von Service Manager ab. |
| Get-SCSMRunAsAccount | Ruft ausführende Konten ab. |
| Get-SCSMSetting | Ruft Konfigurationseinstellungen von System Center Service Manager ab. |
| Get-SCSMSubscription | Ruft Abonnements ab, die in Service Manager konfiguriert sind. |
| Get-SCSMTask | Ruft Aufgaben ab, die in Service Manager definiert sind. |
| Get-SCSMUser | Ruft Benutzende ab, die in Service Manager definiert sind. |
| Get-SCSMUserRole | Ruft Benutzerrollen ab, die in Service Manager definiert sind. |
| Get-SCSMView | Ruft Ansichten ab, die in Service Manager definiert sind. |
| Get-SCSMWorkflow | Ruft Konfigurationsinformationen für Service Manager-Workflows ab. |
| Get-SCSMWorkflowStatus | Ruft den Status von Workflows in Service Manager ab. |
| Import-SCSMInstance | Importiert Objekte und Beziehungen aus einer durch Trennzeichen 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, die mit einem Operations Manager-Warnungsconnector in Service Manager verwendet werden soll. |
| New-SCSMAnnouncement | Erstellt eine neue Ankündigung in Service Manager. |
| New-SCSMClassInstance | Fügt der Datenbank eine Klasseninstanz hinzu. |
| New-SCSMCMConnector | Erstellt einen neuen Configuration Manager-Connector in Service Manager. |
| New-SCSMDCMWorkflow | Erstellt einen neuen gewünschten Konfigurationsverwaltungsworkflow 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 neueste erstellte Verbindung mit einer Verwaltungsgruppe ist die aktive Verbindung, die Get-Cmdlets standardmäßig verwenden, und bei der Sie weder ComputerName- und Anmeldeinformations- noch die SCSession-Parameter angegeben haben. |
| New-SCSMManagementPack | Erstellt ein neues Management Pack. |
| New-SCSMManagementPackBundle | Bündelt einzelne Management Packs und deren Ressourcen, wodurch ein neues Management Pack-Bundle erstellt wird. |
| 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, ausführendes 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 und verhindert, dass es geändert wird. |
| Remove-SCSMAllowListClass | Entfernt die angegebenen Klassen aus der Liste zugelassener Klassen, die vom Operations Manager CI Connector während der Synchronisierung in Service Manager verwendet werden. |
| Remove-SCSMAnnouncement | Entfernt eine Ankündigung von Service Manager. |
| Remove-SCSMClassInstance | Entfernt eine Instanz eines Konfigurationselementobjekts. |
| Remove-SCSMConnector | Entfernt einen Connector von 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 ausführendes 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 zugelassener Klassen, die von Operations Manager CI Connector in Service Manager verwendet wird, auf die Standard-Zulassungsliste zurück. |
| Restore-SCSMDeletedItem | Stellt Elemente wieder her, die zuvor in Service Manager gelöscht wurden. |
| Set-SCSMChannel | Legt die Eigenschaften des E-Mail-Benachrichtigungskanals in Service Manager fest. |
| 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 jeweils 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 Konfigurationselement-Klasseninstanz. |
| Update-SCSMConnector | Aktualisiert die Eigenschaften eines Service Manager-Connectors. |
| Update-SCSMDCMWorkflow | Aktualisiert die Eigenschaften eines gewünschten Konfigurationsmanagement-Workflows. |
| Update-SCSMEmailTemplate | Aktualisiert die Eigenschaften einer E-Mail-Vorlage. |
| Update-SCSMRunAsAccount | Aktualisiert die Anmeldeinformationen, die einem Run As-Konto zugeordnet sind. |
| Update-SCSMSetting | Aktualisiert die Konfigurationseinstellungen für Service Manager. |
| Update-SCSMSubscription | Aktualisiert die Abonnementeigenschaften im Service Manager. |
| Update-SCSMUserRole | Legt die UserRole-Eigenschaft für einen Service Manager-Benutzenden fest. |
| Update-SCSMWorkflow | Aktualisiert Workfloweigenschaften. |
Data Warehouse-Cmdlets im Modul Microsoft.EnterpriseManagement.Warehouse.Cmdlets
| Cmdlet | Beschreibung |
|---|---|
| Disable-SCDWJob | Deaktiviert einen Data Warehouse-Auftrag, um die Ausführung zu verhindern. |
| Disable-SCDWJobSchedule | Das Cmdlet Disable-SCDWJobSchedule deaktiviert eine Data Warehouse-Feinterminierung, wodurch die Feinterminierung keine Aufträge mehr initiiert. Wenn die Feinterminierung zuvor aktiviert war, bleiben die Einstellungen der Feinterminierung bei der Deaktivierung der Feinterminierung erhalten. Um die Einstellungen für die Feinterminierung zu ändern, führen Sie das Cmdlet Set-SCDWJobSchedule aus. |
| Disable-SCDWSource | Aktiviert alle Aufträge, die mit der angegebenen Datenquelle verbunden sind. |
| Enable-SCDWJob | Aktiviert einen Data Warehouse-Auftrag, damit er gemäß seinem Zeitplan ausgeführt werden kann. |
| Enable-SCDWJobSchedule | Das Enable-SCDWJobSchedule-Cmdlet ermöglicht es Administrierenden von Data Warehouses, Feinterminierungen zu aktivieren, damit Aufträge gemäß dem festgelegten Zeitplan ausgeführt werden. Um die Feinterminierung zu deaktivieren, verwenden Sie das Cmdlet Disable-SCDWJobSchedule. |
| Enable-SCDWSource | Aktiviert alle Aufträge, die mit der angegebenen Datenquelle verbunden 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 Extraktions-, Transformations- und Ladeaufträge (ETL). |
| Get-SCDWJobModule | Liefert detaillierte Informationen über den angegebenen Auftrag. Diese Informationen umfassen Auftragsmodule, die als Teil des Auftrags ausgeführt werden. |
| Get-SCDWJobSchedule | Das Cmdlet Get-SCDWJobSchedule zeigt Planungsinformationen für Data Warehouse-Aufträge an. Mit dem Parameter JobName können Sie einen Auftrag angeben, für den die Planungsinformationen angezeigt werden sollen. Andernfalls zeigt das Cmdlet Get-SCDWJobSchedule Planungsinformationen für alle Data Warehouse-Aufträge an. |
| Get-SCDWModule | |
| Get-SCDWRetentionPeriod | Das Data Warehouse sortiert Zeilen nach einer vordefinierten Aufbewahrungsfrist aus. Dieses Cmdlet gibt den Aufbewahrungszeitraum für eine bestimmte Entität in Minuten an. Wenn keine Entität angegeben wird, wird der Standardaufbewahrungszeitraum für alle Entitäten zurückgegeben. |
| Get-SCDWSource | Aktiviert alle Aufträge, die mit der angegebenen Datenquelle verbunden sind. |
| Get-SCDWSourceType | Ruft die Arten von Datenquellen ab, die im 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 Datentyp zuerst beim Data Warehouse registriert werden. Dieses Cmdlet hilft beim Registrieren eines neuen Datenquellentyps, indem das geeignete Management Pack importiert und die entsprechenden Konfigurationsänderungen vorgenommen werden. |
| Register-SCDWSource | Registriert Instanzen von Datenquellentypen, wie z. B. Service Manager, Operations Manager und Konfigurationsmanager, im Data Warehouse. |
| Set-SCDWJobSchedule | Legt den Zeitplan für einen Data Warehouse-Auftrag fest. |
| Set-SCDWRetentionPeriod | Legt die Datenaufbewahrungsfrist in Minuten für eine bestimmte Faktentabelle innerhalb einer bestimmten Data-Warehouse-Datenbank fest oder legt den Standard 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 | Registrierung einer Datenquelle aus dem Data Warehouse aufheben. |
Nächste Schritte
- Um Wartungsaufgaben für Data Warehouse-Aufträge durchzuführen, siehe Data Warehouse verwalten.