Auf Englisch lesen

Freigeben über

Get-SCOMTask

  • Referenz
Modul:
OperationsManager

Ruft eine Liste von Aufgaben ab.

Syntax

PowerShell 
Get-SCOMTask
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
Get-SCOMTask
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
Get-SCOMTask
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
Get-SCOMTask
   [-Instance] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
Get-SCOMTask
   [-ManagementPack] <ManagementPack[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
Get-SCOMTask
   [-Name <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
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

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

Dieser Befehl ruft alle Aufgaben ab, die die Integrität in ihren Namen aufweisen.

Beispiel 2: Abrufen einer Aufgabe mithilfe eines teilweisen Anzeigenamens

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

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

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

PowerShell 
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 Get-SCOMTask-Cmdlet zu übergeben. Da der Befehl SilentlyContinue für den ErrorAction-Parameter angibt, wenn das Cmdlet ein Management Pack ohne zugeordnete Aufgaben findet, wird er weiterhin ausgeführt und zeigt keine Fehlermeldungen an.

Beispiel 4: Abrufen von Aufgaben mithilfe eines Teilklassennamens

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

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

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

PowerShell 
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

PowerShell 
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 stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie 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 Standardwert der Computer für die aktuelle Verwaltungsgruppenverbindung.

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 Cmdlet Get-Credential zurückgibt, für diesen Parameter. Wenn Sie weitere Informationen zu Anmeldeinformationenobjekten erhalten möchten, geben Sie "Get-Help Get-Credential" ein.

Dieses Konto muss Zugriff auf den Server haben, der im Parameter ComputerName 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 arbeitet. Die Werte für diesen Parameter variieren je nachdem, welche lokalisierten Verwaltungspakete in die Verwaltungsgruppe importiert werden, und das Gebietsschema des Benutzers, der Windows PowerShell ausführt.

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

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 mit Aufgabennamen an.

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

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 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 mithilfe der Parameter "ComputerName " und "Anmeldeinformationen " erstellen. Geben Sie "Get-Help about_OpsMgr_Connections" ein, um weitere Informationen anzuzeigen.

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