Freigeben über

Get-SCOMTask

  • Referenz
Modul:
OperationsManager

Ruft eine Liste von 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 abzurufen, die über einen bestimmten Namen oder eine bestimmte ID verfügen sowie Aufgaben, die den angegebenen Benutzerrollen, Klasseninstanzen, Verwaltungspaketen 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 Vorgänge ab, die die Integrität in ihren Namen haben.

Beispiel 2: Abrufen einer Aufgabe mithilfe eines teilweisen Anzeigenamens

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

Dieser Befehl ruft alle Aufgaben ab, 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 Verwaltungspakete ab, die über System Center Core in ihren Anzeigenamen verfügen. Der Befehl verwendet das Cmdlet Get-SCOMManagementPack , um Verwaltungspakete basierend auf Anzeigenamen abzurufen und an das Cmdlet Get-SCOMTask zu übergeben. Da der Befehl "SilentlyContinue" für den ErrorAction-Parameter angibt, wenn das Cmdlet ein Verwaltungspaket ohne zugeordnete Aufgaben findet, wird es weiterhin ausgeführt und zeigt keine Fehlermeldungen an.

Beispiel 4: Abrufen von Aufgaben mithilfe eines Teilklassennamens

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

Dieser Befehl ruft alle Aufgaben für Klassen ab, die die Integrität in ihren Namen haben.

Beispiel 5: Abrufen von Vorgängen durch Angeben eines Teilklasseninstanznamens

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

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

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 über eine ID von 7413b06b-a95b-4ae3-98f2-dac9ff76dabdabd verfügt.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.

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

Wenn Sie diesen Parameter nicht angeben, ist der Computer für die aktuelle Verwaltungsgruppenverbindung standardmäßig.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Get-Credential-Cmdlet zurückgibt, für diesen Parameter. Weitere Informationen zu Anmeldeinformationenobjekten 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 der Standardwert das Konto für den aktuellen Benutzer.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 Vorgangsobjekts.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Instance

Gibt ein Array von EnterpriseManagementObject-Objekten an, die Klasseninstanzen darstellen. Das Cmdlet ruft Aufgaben für die Klasseninstanzen ab, die das Array speichert. Geben Sie eine Variable an, die die Klasseninstanzen darstellt oder ein Cmdlet wie Get-SCOMClassInstance verwendet, das die Klasseninstanzen abruft. Dieser Parameter akzeptiert auch Gruppenobjekte. Verwenden Sie zum Abrufen eines Gruppenobjekts das Cmdlet Get-SCOMGroup .

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:ManagementPack[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt ein Array von Aufgabennamen an.

Das Cmdlet verwendet jede Zeichenfolge im Array und stimmt mit den Nameneigenschaften der Aufgabenobjekte überein, mit denen dieses Cmdlet funktioniert.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-SCSession

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

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

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 , das die Zielklassenobjekte abruft.

Type:ManagementPackClass[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False