Freigeben über

Start-SCOMTask

  • Referenz
Modul:
OperationsManager

Startet eine Aufgabe für ein angegebenes Objekt.

Syntax

Start-SCOMTask
     [-Instance] <EnterpriseManagementObject[]>
     [-Task] <ManagementPackTask>
     -TaskCredentials <PSCredential>
     [[-Override] <Hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Start-SCOMTask Cmdlet startet eine Aufgabe für ein angegebenes Objekt. Dieses Cmdlet verwendet ein Aufgabenobjekt und ein Klasseninstanzobjekt als Eingabe. Das Cmdlet akzeptiert nur eine Aufgabe, kann jedoch mehrere Klasseninstanzen und Außerkraftsetzungen akzeptieren.

Beispiele

Beispiel 1: Starten einer Aufgabe mithilfe eines Anzeigenamens

PS C:\>$Instances = Get-SCOMClassInstance -Name "*.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Get Monitor State" | Start-SCOMTask -Instance $Instances

In diesem Beispiel wird eine Aufgabe mithilfe eines Anzeigenamens gestartet.

Der erste Befehl ruft alle Klasseninstanzen in der Contoso.com Domäne ab und speichert sie in der variablen $Instances.

Der zweite Befehl ruft die Aufgabe mit dem Anzeigenamen Get Monitor State ab und startet die Aufgabe für jede Klasseninstanz, die in der variablen $Instances gespeichert ist.

Beispiel 2: Starten einer Aufgabe mithilfe eines Anzeigenamens und einer Timeoutspezifikation

PS C:\>$Overrides = @{Timeout=60}
PS C:\> $Instances = Get-SCOMClassInstance -DisplayName "Contoso Service"
PS C:\> $Task = Get-SCOMTask -DisplayName "Start NT Service"
PS C:\> Start-SCOMTask -Task $Task -Instance $Instances -Override $Overrides

In diesem Beispiel wird gezeigt, wie Sie eine Aufgabe mithilfe eines Anzeigenamens und einer Hashtabelle starten, die einen Timeoutwert angibt.

Der erste Befehl erstellt eine Hashtabelle mit einem Wert für den Timeout-Schlüssel und speichert sie in der variablen $Overrides.

Der zweite Befehl ruft alle Klasseninstanzen mit dem Namen Contoso Service ab und speichert sie in der variablen $Instances.

Der dritte Befehl ruft die Aufgabe ab, die den Anzeigenamen Start NT Service hat, und startet die Aufgabe für jede Klasseninstanz, die in der variablen $Instances gespeichert ist.

Der vierte Befehl startet die Aufgabe für jede Klasseninstanz, die in der variablen $Instances gespeichert ist. Der Befehl gibt einen Timeout-Schlüsselwert von 60 an.

Beispiel 3: Starten einer Aufgabe mithilfe von Anmeldeinformationen

PS C:\>$Credential = Get-Credential
PS C:\> $Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Reset State" | Start-SCOMTask -Instance $Instance -TaskCredentials $Credential

In diesem Beispiel wird eine Aufgabe mithilfe von Anmeldeinformationen gestartet.

Der erste Befehl fordert den Benutzer auf, einen Benutzernamen und ein Kennwort einzugeben, erstellt ein Anmeldeinformationsobjekt aus der Eingabe und speichert das Anmeldeinformationsobjekt in der $Credential Variablen.

Der zweite Befehl ruft eine Klasseninstanz mit dem Namen Server01.Contoso.com ab und speichert sie in der variablen $Instance.

Der dritte Befehl ruft eine Aufgabe mit dem Anzeigenamen "Status zurücksetzen" ab und startet die Aufgabe für die Klasseninstanz, die in $Instance gespeichert ist. Der Befehl führt die Aufgabe unter den Anmeldeinformationen aus, die in $Credential gespeichert sind.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Instance

Gibt ein Array von EnterpriseManagementObject- -Objekten an, die Klasseninstanzobjekte darstellen, für die eine Aufgabe gestartet werden soll. Geben Sie eine Variable an, die die Klasseninstanzen speichert oder ein Cmdlet verwendet, z. B. die Get-SCOMClassInstance Cmdlet, das die Klasseninstanzen abruft. 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:False
Platzhalterzeichen akzeptieren:False

-Override

Gibt eine Hashtabelle an, die neue Werte für einen oder mehrere Vorgangsparameter definiert, wenn diese Parameter Außerkraftsetzungen zulassen. Wenn Sie weitere Informationen zu Hashtabellen wünschen, geben Sie "Get-Help about_Hash_Tables" ein.

Um zu bestimmen, welche Parameter für einen Vorgang Außerkraftsetzungen zulassen, verwenden Sie die GetOverrideableParameters- Methode für das Taskobjekt.

Typ:Hashtable
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Task

Gibt ein aufgabenobjekt an, das gestartet werden soll. Geben Sie eine Variable an, die eine Aufgabe darstellt, oder verwenden Sie ein Cmdlet wie die Get-SCOMTask Cmdlet, das eine Aufgabe abruft. Dieser Parameter akzeptiert nur ein Aufgabenobjekt.

Typ:ManagementPackTask
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TaskCredentials

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.

Dies ist ein obligatorischer Parameter. Wenn Sie einen NULL-Wert angeben, verwendet Operations Manager die standardmäßigen TaskCredentials des Kontos für den aktuellen Benutzer.

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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False