Compartir a través de

Start-SCOMTask

  • Referencia
Módulo:
OperationsManager

Inicia una tarea para un objeto especificado.

Sintaxis

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 mediante 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 Contoso Service 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 mediante 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 para la instancia de clase almacenada en $Instance. El comando ejecuta la tarea en las credenciales almacenadas en $Credential.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Instance

Especifica una matriz de EnterpriseManagementObject objetos que representan objetos de instancia de clase para los que 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.

Tipo:EnterpriseManagementObject[]
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Hashtable
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:ManagementPackTask
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TaskCredentials

Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración. Especifique un objeto de PSCredential, como el que devuelve el cmdlet get-credential de , 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 que se especifica en el parámetro ComputerName de si aparece ese parámetro.

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

Tipo:PSCredential
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False