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

  1. Klicken Sie in der Service Manager-Konsole auf Verwaltung.

  2. 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

  1. 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.

  2. 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

  1. Öffnen Sie eine Service Manager Windows PowerShell Sitzung.

  2. 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.Manager
    
  3. Geben 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

  1. Öffnen Sie eine Service Manager Windows PowerShell Sitzung.

  2. Sie können jetzt auf die vorgeschachtelte Hilfe zugreifen, oder Sie können den Parameter verwenden, um auf die aktuelle -online Onlinehilfe 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> -detailed
      
    • Online, aktuelle Hilfe: Geben Sie den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:

      Get-help <cmdlet-name> -online
      

      Dieser Befehl verwendet den Parameter -online fü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