Freigeben über

Get-SCOMTask

  • Referenz
Modul:
OperationsManager

Ruft eine Liste der Aufgaben ab.

Syntax

Get-SCOMTask
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Instance] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-ManagementPack] <ManagementPack[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Name <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Target <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-SCOMTask ruft eine Liste der Aufgaben ab. Verwenden Sie dieses Cmdlet, um Aufgaben mit einem bestimmten Namen oder einer bestimmten ID sowie Aufgaben abzurufen, die bestimmten Benutzerrollen, Klasseninstanzen, Management Packs oder Zielklassen zugeordnet sind.

Beispiele

Beispiel 1: Abrufen von Vorgängen durch Angeben eines Teilnamens

PS C:\>Get-SCOMTask -Name "*health*"

Dieser Befehl ruft alle Aufgaben ab, die den Status in ihren Namen aufweisen.

Beispiel 2: Abrufen einer Aufgabe mithilfe eines teilweisen Anzeigenamens

PS C:\>Get-SCOMTask -DisplayName "Stop*"

Dieser Befehl ruft alle Aufgaben ab, die Anzeigenamen enthalten, die mit "Stop" beginnen.

Beispiel 3: Abrufen einer Aufgabe durch Angeben eines teilweisen Anzeigenamens und einer Fehleraktion

PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core*" | Get-SCOMTask -ErrorAction SilentlyContinue

Dieser Befehl ruft alle Aufgaben für die Management Packs ab, die System Center Core in ihren Anzeigenamen enthalten. Der Befehl verwendet das cmdlet Get-SCOMManagementPack, um Management Packs basierend auf Anzeigenamen abzurufen und an das Cmdlet Get-SCOMTask zu übergeben. Da der Befehl "SilentlyContinue" für den parameter ErrorAction angibt, wird es weiterhin ausgeführt und zeigt keine Fehlermeldungen an, wenn das Cmdlet ein Management Pack ohne zugeordnete Aufgaben findet.

Beispiel 4: Abrufen von Aufgaben mithilfe eines teilweisen Klassennamens

PS C:\>Get-SCOMClass -Name "*health*" | Get-SCOMTask

Dieser Befehl ruft alle Aufgaben für Klassen ab, die den Status in ihren Namen aufweisen.

Beispiel 5: Abrufen von Aufgaben durch Angeben eines Teilweisen Klasseninstanznamens

PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMTask

Dieser Befehl ruft alle Aufgaben für Klasseninstanzen ab, die in ihren Namen Contoso.com haben.

Beispiel 6: Abrufen einer Aufgabe durch Angeben einer ID

PS C:\>Get-SCOMTask -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Dieser Befehl ruft die Aufgabe ab, die eine ID von 7413b06b-a95b-4ae3-98f2-dac9ff76dabd hat.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.

Der Computer muss den System Center Data Access-Dienst ausführen.

Wenn Sie diesen Parameter nicht angeben, ist der Standardwert der Computer für die aktuelle Verwaltungsgruppenverbindung.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie für diesen Parameter ein PSCredential--Objekt an, z. B. ein Objekt, das vom Get-Credential--Cmdlet zurückgegeben wird. Wenn Sie weitere Informationen zu Anmeldeinformationsobjekten wünschen, geben Sie "Get-Help Get-Credential" ein.

Dieses Konto muss Zugriff auf den Server haben, der im ComputerName Parameter angegeben ist, wenn dieser Parameter angezeigt wird.

Wenn Sie diesen Parameter nicht angeben, ist die Standardeinstellung das Konto für den aktuellen Benutzer.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt ein Array von Anzeigenamen für Aufgabenobjekte an. Dieser Parameter akzeptiert eine oder mehrere Zeichenfolgen, und das Cmdlet sucht nach Übereinstimmungen zwischen den Anzeigenamen der Aufgabenobjekte, mit denen das Cmdlet arbeitet. Die Werte für diesen Parameter variieren je nachdem, welche lokalisierten Management Packs in die Verwaltungsgruppe und das Gebietsschema des Benutzers importiert werden, der Windows PowerShell ausführt.

Typ:String[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Id

Gibt ein Array von Aufgaben-IDs an. Das Cmdlet ruft die Aufgaben ab, die über diese IDs verfügen. Verwenden Sie zum Abrufen einer Aufgabe das cmdlet Get-SCOMTask. Die ID ist die -ID Eigenschaft eines Aufgabenobjekts.

Typ:Guid[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Instance

Gibt ein Array von EnterpriseManagementObject- -Objekten an, die Klasseninstanzen darstellen. Das Cmdlet ruft Aufgaben für die Klasseninstanzen ab, die vom Array gespeichert werden. Geben Sie eine Variable an, die die Klasseninstanzen darstellt, oder verwenden Sie ein Cmdlet wie Get-SCOMClassInstance, mit dem die Klasseninstanzen abgerufen werden. Dieser Parameter akzeptiert auch Gruppenobjekte. Verwenden Sie zum Abrufen eines Gruppenobjekts das cmdlet Get-SCOMGroup.

Typ:EnterpriseManagementObject[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ManagementPack

Gibt ein Array von Management Pack-Objekten an. Das Cmdlet ruft Aufgaben für die Management Pack-Objekte im Array ab. Geben Sie eine Variable an, die Management Pack-Objekte enthält, oder verwenden Sie ein Cmdlet wie Get-SCOMManagementPack, das Management Pack-Objekte abruft.

Typ:ManagementPack[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt ein Array von Vorgangsnamen an.

Das Cmdlet verwendet jede Zeichenfolge im Array und stimmt mit den eigenschaften Name eigenschaften der Aufgabenobjekte überein, mit denen dieses Cmdlet arbeitet.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-SCSession

Gibt ein Array von Connection -Objekten an. Um Connection-Objekte abzurufen, geben Sie das cmdlet Get-SCOMManagementGroupConnection an.

Wenn dieser Parameter nicht angezeigt wird, verwendet das Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession--Parameter, um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden. Geben Sie für weitere Informationen "Get-Help about_OpsMgr_Connections" ein.

Typ:Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Target

Gibt ein Array von Management Pack-Klassenobjekten an, die Zielklassen darstellen. Geben Sie eine Variable an, die die Zielklassenobjekte enthält, oder verwenden Sie ein Cmdlet wie Get-SCOMClass, mit dem die Zielklassenobjekte abgerufen werden.

Typ:ManagementPackClass[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False