Sdílet prostřednictvím

Start-SCOMTask

  • Reference
Modul:
OperationsManager

Spustí úlohu pro zadaný objekt.

Syntax

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

Description

Rutina Start-SCOMTask spustí úlohu pro zadaný objekt. Tato rutina přebírá objekt úkolu a objekt instance třídy jako vstup. Rutina přijímá pouze jednu úlohu, ale může přijmout více instancí třídy a přepsání.

Příklady

Příklad 1: Spuštění úkolu pomocí zobrazovaného názvu

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

Tento příklad spustí úkol pomocí zobrazovaného názvu.

První příkaz získá všechny instance třídy v doméně Contoso.com a uloží je do proměnné $Instances.

Druhý příkaz získá úkol, který má zobrazovaný název Get Monitor State a spustí úlohu pro každou instanci třídy uloženou v proměnné $Instances.

Příklad 2: Spuštění úkolu pomocí zobrazovaného názvu a specifikace časového limitu

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

Tento příklad ukazuje, jak spustit úlohu pomocí zobrazovaného názvu a tabulky hash, která určuje hodnotu časového limitu.

První příkaz vytvoří tabulku hash, která má hodnotu pro klíč časového limitu a uloží ji do proměnné $Overrides.

Druhý příkaz získá všechny instance třídy, které mají název Contoso Service a uloží je do proměnné $Instances.

Třetí příkaz získá úlohu, která má zobrazovaný název Spustit službu NT a spustí úlohu pro každou instanci třídy uloženou v proměnné $Instances.

Čtvrtý příkaz spustí úlohu pro každou instanci třídy uloženou v proměnné $Instances. Příkaz určuje hodnotu klíče časového limitu 60.

Příklad 3: Spuštění úkolu pomocí přihlašovacích údajů

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

Tento příklad spustí úlohu pomocí přihlašovacích údajů.

První příkaz vyzve uživatele k zadání uživatelského jména a hesla, vytvoří z vstupu objekt přihlašovacích údajů a uloží objekt přihlašovacích údajů do proměnné $Credential.

Druhý příkaz získá instanci třídy s názvem Server01.Contoso.com a uloží ji do proměnné $Instance.

Třetí příkaz získá úlohu, která má zobrazovaný název Reset State a spustí úlohu pro instanci třídy, která je uložena v $Instance. Příkaz spustí úlohu pod přihlašovacími údaji uloženými v $Credential.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Instance

Určuje pole objektů EnterpriseManagementObject , které představují objekty instance třídy, pro které se má spustit úkol. Zadejte proměnnou, která ukládá instance tříd nebo používá rutinu, jako je Rutina Get-SCOMClassInstance , která získá instance třídy. Tento parametr také přijímá objekty skupiny. K získání objektu skupiny použijte rutinu Get-SCOMGroup .

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

-Override

Určuje tabulku hash, která definuje nové hodnoty pro jeden nebo více parametrů úkolu, pokud tyto parametry umožňují přepsání. Další informace o tabulkách hash najdete v tématu "Get-Help about_Hash_Tables".

Chcete-li zjistit, které parametry úkolu umožňují přepsání, použijte metodu GetOverrideableParameters pro objekt úkolu.

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Task

Určuje objekt úkolu, který se má spustit. Zadejte proměnnou, která představuje úlohu, nebo použijte rutinu, jako je rutina Get-SCOMTask , která získá úlohu. Tento parametr přijímá pouze jeden objekt úkolu.

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

-TaskCredentials

Určuje uživatelský účet, pod kterým se spouští připojení skupiny pro správu. Zadejte objekt PSCredential , například objekt, který rutina Get-Credential vrátí pro tento parametr. Další informace o objektech přihlašovacích údajů najdete v tématu "Get-Help Get-Credential".

Tento účet musí mít přístup k serveru, který je zadán v parametru ComputerName , pokud se tento parametr zobrazí.

Tento parametr je povinný. Pokud zadáte hodnotu null, Operations Manager použije výchozí taskCredentials účtu pro aktuálního uživatele.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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