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 변수에 저장합니다.

두 번째 명령은 모니터 상태 가져오기라는 표시 이름이 있는 작업을 가져오고 $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 변수에 저장된 각 클래스 인스턴스에 대한 작업을 시작합니다. 이 명령은 Timeout 키 값 60을 지정합니다.

예제 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 개체의 배열을 지정합니다. 클래스 인스턴스를 저장하는 변수를 지정하거나 클래스 인스턴스를 가져오는 Get-SCOMClassInstance cmdlet과 같은 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

관리 그룹 연결이 실행되는 사용자 계정을 지정합니다. 이 매개 변수에 대해 Get-Credential cmdlet이 반환하는 것과 같은 PSCredential 개체를 지정합니다. 자격 증명 개체에 대한 자세한 내용은 "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