Start-SCOMTask
啟動指定物件的工作。
Syntax
Start-SCOMTask
[-Instance] <EnterpriseManagementObject[]>
[-Task] <ManagementPackTask>
-TaskCredentials <PSCredential>
[[-Override] <Hashtable>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Start-SCOMTask Cmdlet 會啟動指定物件的工作。 此 Cmdlet 會接受工作物件和類別實例物件做為輸入。 Cmdlet 只接受一項工作,但可以接受多個類別實例和覆寫。
範例
範例 1:使用顯示名稱啟動工作
PS C:\>$Instances = Get-SCOMClassInstance -Name "*.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Get Monitor State" | Start-SCOMTask -Instance $Instances
此範例會使用顯示名稱啟動工作。
第一個命令會取得 Contoso.com 網域中的所有類別實例,並將其儲存在$Instances變數中。
第二個命令會取得顯示名稱為 Get Monitor State 的工作,並針對儲存在 $Instances 變數中的每個類別實例啟動工作。
範例 2:使用顯示名稱和逾時規格啟動工作
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
此範例示範如何使用顯示名稱和指定逾時值的雜湊表來啟動工作。
第一個命令會建立雜湊表,其具有 Timeout 索引鍵的值,並將它儲存在$Overrides變數中。
第二個命令會取得名稱為 Contoso Service 的所有類別實例,並將其儲存在$Instances變數中。
第三個命令會取得顯示名稱為 Start NT Service 的工作,並針對儲存在 $Instances 變數中的每個類別實例啟動工作。
第四個命令會針對儲存在 $Instances 變數中的每個類別實例啟動工作。 此命令會指定 60 的 Timeout 索引鍵值。
範例 3:使用認證啟動工作
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
此範例會使用認證啟動工作。
第一個命令會提示使用者輸入使用者名稱和密碼、從輸入建立認證物件,並將認證物件儲存在$Credential變數中。
第二個命令會取得名為 Server01.Contoso.com 的類別實例,並將它儲存在 $Instance 變數中。
第三個命令會取得具有顯示名稱重設狀態的工作,並啟動儲存在 $Instance 中的類別實例工作。 命令會在儲存在 $Credential 的認證下執行工作。
參數
-Confirm
在執行 Cmdlet 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Instance
指定要啟動工作的類別實例物件的 EnterpriseManagementObject 物件的陣列。 指定儲存類別實例或使用 Cmdlet 的變數,例如取得類別實例的 Get-SCOMClassInstance Cmdlet。 此參數也會接受群組物件。 若要取得群組物件,請使用 Get-SCOMGroup Cmdlet。
Type: | EnterpriseManagementObject[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Override
指定雜湊表,如果這些參數允許覆寫,則會定義一或多個工作參數的新值。
如需雜湊表的詳細資訊,請輸入 「 Get-Help about_Hash_Tables
」。
若要判斷工作允許覆寫的參數,請使用 工作物件的 GetOverrideableParameters 方法。
Type: | Hashtable |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Task
指定要啟動的工作物件。 指定代表工作的變數,或使用 取得工作的 Get-SCOMTask Cmdlet 之類的 Cmdlet。 此參數只接受一個工作物件。
Type: | ManagementPackTask |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TaskCredentials
指定管理群組連接執行所在的使用者帳戶。
針對此參數指定 PSCredential 物件,例如 Get-Credential Cmdlet 傳回的物件。
如需認證物件的詳細資訊,請輸入 「 Get-Help Get-Credential
」。
如果出現該參數,此帳戶必須能夠存取 ComputerName 參數中指定的伺服器。
這是必要參數。 如果您指定 Null 值,Operations Manager 會使用目前使用者帳戶的預設 TaskCredentials。
Type: | PSCredential |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |