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 Cmdlet "Start-SCOMTask " 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 $Instances Variablen.

Der zweite Befehl ruft die Aufgabe ab, die den Anzeigenamen Get Monitor State hat, und startet die Aufgabe für jede Klasseninstanz, die in der $Instances Variablen 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 Timeoutschlüssel und speichert sie in der variablen $Overrides.

Der zweite Befehl ruft alle Klasseninstanzen ab, die den Namen Contoso Service haben, und speichert sie in der $Instances Variablen.

Der dritte Befehl ruft die Aufgabe mit dem Anzeigenamen "Start NT Service" ab und startet die Aufgabe für jede Klasseninstanz, die in der $Instances Variablen gespeichert ist.

Der vierte Befehl startet die Aufgabe für jede Klasseninstanz, die in der variablen $Instances gespeichert ist. Der Befehl gibt einen Timeouttastenwert 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 für einen Benutzernamen und ein Kennwort auf, erstellt ein Anmeldeinformationsobjekt aus der Eingabe und speichert das Anmeldeinformationsobjekt in der $Credential Variablen.

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

Der dritte Befehl ruft eine Aufgabe ab, die den Anzeigenamen Zurücksetzungsstatus aufweist, 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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 wie das Cmdlet 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:False
Accept wildcard characters:False

-Override

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

Verwenden Sie die GetOverrideableParameters-Methode für das Aufgabenobjekt, um zu bestimmen, welche Parameter für einen Vorgang Außerkraftsetzungen zulässig sind.

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 das Cmdlet Get-SCOMTask , das eine Aufgabe abruft. Dieser Parameter akzeptiert nur ein Aufgabenobjekt.

Type:ManagementPackTask
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TaskCredentials

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.

Dies ist ein erforderlicher Parameter. Wenn Sie einen Nullwert angeben, verwendet Operations Manager die Standard-TaskCredentials des Kontos für den aktuellen Benutzer.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False