Compartir a través de

Start-SCOMTask

  • Referencia
Módulo:
OperationsManager

Inicia una tarea para un objeto especificado.

Syntax

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

Description

El cmdlet Start-SCOMTask inicia una tarea para un objeto especificado. Este cmdlet toma un objeto de tarea y un objeto de instancia de clase como entrada. El cmdlet solo acepta una tarea, pero puede aceptar varias instancias de clase e invalidaciones.

Ejemplos

Ejemplo 1: Iniciar una tarea con un nombre para mostrar

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

En este ejemplo se inicia una tarea con un nombre para mostrar.

El primer comando obtiene todas las instancias de clase del dominio Contoso.com y las almacena en la variable $Instances.

El segundo comando obtiene la tarea que tiene el nombre para mostrar Get Monitor State e inicia la tarea para cada instancia de clase que se almacena en la variable $Instances.

Ejemplo 2: Iniciar una tarea con un nombre para mostrar y una especificación de tiempo de espera

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

En este ejemplo se muestra cómo iniciar una tarea mediante un nombre para mostrar y una tabla hash que especifica un valor de tiempo de espera.

El primer comando crea una tabla hash que tiene un valor para la clave Timeout y la almacena en la variable $Overrides.

El segundo comando obtiene todas las instancias de clase que tienen el nombre Servicio Contoso y las almacena en la variable $Instances.

El tercer comando obtiene la tarea que tiene el nombre para mostrar Iniciar el servicio NT e inicia la tarea para cada instancia de clase que se almacena en la variable $Instances.

El cuarto comando inicia la tarea para cada instancia de clase que se almacena en la variable $Instances. El comando especifica un valor de clave de tiempo de espera de 60.

Ejemplo 3: Iniciar una tarea con credenciales

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

En este ejemplo se inicia una tarea mediante credenciales.

El primer comando solicita al usuario un nombre de usuario y una contraseña, crea un objeto de credencial a partir de la entrada y almacena el objeto de credencial en la variable $Credential.

El segundo comando obtiene una instancia de clase denominada Server01.Contoso.com y la almacena en la variable $Instance.

El tercer comando obtiene una tarea que tiene el nombre para mostrar Restablecer estado e inicia la tarea de la instancia de clase almacenada en $Instance. El comando ejecuta la tarea en las credenciales almacenadas en $Credential.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Instance

Especifica una matriz de objetos EnterpriseManagementObject que representan objetos de instancia de clase para los que se va a iniciar una tarea. Especifique una variable que almacene las instancias de clase o use un cmdlet como el cmdlet Get-SCOMClassInstance que obtiene las instancias de clase. Este parámetro también acepta objetos de grupo. Para obtener un objeto de grupo, use el cmdlet Get-SCOMGroup .

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

-Override

Especifica una tabla hash que define nuevos valores para uno o varios parámetros de tarea, si esos parámetros permiten invalidaciones. Para obtener más información sobre las tablas hash, escriba "Get-Help about_Hash_Tables".

Para determinar qué parámetros para una tarea permiten invalidaciones, use el método GetOverrideableParameters para el objeto de tarea.

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

-Task

Especifica un objeto de tarea que se va a iniciar. Especifique una variable que represente una tarea o use un cmdlet como el cmdlet Get-SCOMTask que obtiene una tarea. Este parámetro solo acepta un objeto de tarea.

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

-TaskCredentials

Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración. Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , para este parámetro. Para obtener más información sobre los objetos de credenciales, escriba "Get-Help Get-Credential".

Esta cuenta debe tener acceso al servidor especificado en el parámetro ComputerName si aparece ese parámetro.

Es un parámetro obligatorio. Si especifica un valor null, Operations Manager usa los TaskCredentials predeterminados de la cuenta para el usuario actual.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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