Get-SCOMTask

Referencia

Módulo:: OperationsManager

Obtiene una lista de tareas.

Syntax

Get-SCOMTask
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMTask
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMTask
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMTask
   [-Instance] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMTask
   [-ManagementPack] <ManagementPack[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMTask
   [-Name <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCOMTask
   [-Target <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

El cmdlet Get-SCOMTask obtiene una lista de tareas. Use este cmdlet para obtener tareas que tengan un nombre o identificador específicos, así como tareas asociadas a roles de usuario, instancias de clase, módulos de administración o clases de destino especificadas.

Ejemplos

Ejemplo 1: Obtener tareas especificando un nombre parcial

PS C:\>Get-SCOMTask -Name "*health*"

Este comando obtiene todas las tareas que tienen el estado en sus nombres.

Ejemplo 2: Obtener una tarea mediante un nombre para mostrar parcial

PS C:\>Get-SCOMTask -DisplayName "Stop*"

Este comando obtiene todas las tareas que tienen nombres para mostrar que comienzan por Stop.

Ejemplo 3: Obtener una tarea especificando un nombre para mostrar parcial y una acción de error

PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core*" | Get-SCOMTask -ErrorAction SilentlyContinue

Este comando obtiene todas las tareas de los módulos de administración que tienen System Center Core en sus nombres para mostrar. El comando usa el cmdlet Get-SCOMManagementPack para obtener módulos de administración basados en nombres para mostrar y los pasa al cmdlet Get-SCOMTask . Dado que el comando especifica SilentlyContinue para el parámetro ErrorAction , si el cmdlet encuentra un módulo de administración sin tareas asociadas, continúa ejecutándose y no muestra mensajes de error.

Ejemplo 4: Obtener tareas mediante un nombre de clase parcial

PS C:\>Get-SCOMClass -Name "*health*" | Get-SCOMTask

Este comando obtiene todas las tareas de las clases que tienen el estado en sus nombres.

Ejemplo 5: Obtener tareas especificando un nombre de instancia de clase parcial

PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMTask

Este comando obtiene todas las tareas de las instancias de clase que tienen .Contoso.com en sus nombres.

Ejemplo 6: Obtener una tarea especificando un identificador

PS C:\>Get-SCOMTask -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Este comando obtiene la tarea que tiene un identificador de 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres NetBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El equipo debe ejecutar el servicio de acceso a datos de System Center.

Si no especifica este parámetro, el valor predeterminado es el equipo para la conexión del grupo de administración actual.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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.

Si no especifica este parámetro, el valor predeterminado es la cuenta del usuario actual.

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

-DisplayName

Especifica una matriz de nombres para mostrar para objetos de tarea. Este parámetro toma una o varias cadenas y el cmdlet busca coincidencias entre los nombres para mostrar de los objetos de tarea con los que funciona el cmdlet. Los valores de este parámetro varían en función de los módulos de administración localizados que se importen en el grupo de administración y la configuración regional del usuario que ejecuta Windows PowerShell.

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

-Id

Especifica una matriz de identificadores de tarea. El cmdlet obtiene las tareas que tienen estos identificadores. Para obtener una tarea, use el cmdlet Get-SCOMTask . El identificador es la propiedad ID de un objeto de tarea.

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

-Instance

Especifica una matriz de objetos EnterpriseManagementObject que representan instancias de clase. El cmdlet recupera las tareas de las instancias de clase que almacena la matriz. Especifique una variable que represente las instancias de clase o use un cmdlet como 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:	True
Accept wildcard characters:	False

-ManagementPack

Especifica una matriz de objetos del módulo de administración. El cmdlet obtiene tareas para los objetos del módulo de administración de la matriz. Especifique una variable que contenga objetos de módulo de administración o use un cmdlet como Get-SCOMManagementPack que obtiene objetos del módulo de administración.

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

-Name

Especifica una matriz de nombres de tareas.

El cmdlet toma cada cadena de la matriz y la coincide con las propiedades Name de los objetos de tarea con los que funciona este cmdlet.

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

-SCSession

Especifica una matriz de objetos Connection . Para obtener objetos Connection , especifique el cmdlet Get-SCOMManagementGroupConnection .

Si este parámetro no aparece, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential . Para obtener más información, escriba "Get-Help about_OpsMgr_Connections".

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Target

Especifica una matriz de objetos de clase de módulo de administración que representan clases de destino. Especifique una variable que contenga los objetos de clase de destino o use un cmdlet como Get-SCOMClass que obtiene los objetos de clase de destino.

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