Start-SCOMTask
Startet eine Aufgabe für ein angegebenes Objekt.
Syntax
Default (Standardwert)
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | EnterpriseManagementObject[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | Hashtable |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 4 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | ManagementPackTask |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 3 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.