Compartir a través de

New-SCSMWorkflow

  • Referencia
Módulo:
System.Center.Service.Manager

Crea un nuevo flujo de trabajo en Service Manager.

Sintaxis

New-SCSMWorkflow
   -Class <String>
   [-DisplayName] <String>
   [-Description <String>]
   [-Enable <Boolean>]
   [-Event <WorkflowEvent>]
   [-ManagementPack <ManagementPack>]
   [-Criteria <String>]
   [-Template <ManagementPackObjectTemplate>]
   [-EnableNotification <Boolean>]
   [-Notification <Hashtable[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-SCSMWorkflow crea un flujo de trabajo en Service Manager.

Ejemplos

Ejemplo 1: Creación de un flujo de trabajo para la creación de actividades manuales

PS C:\>$Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name "AssignedToUserNotificationTemplate" },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 07" -Class "ManualActivity" -Description "Contoso workflow 07." -Enable $True -Event Create -Notification $Notification -Template $Template

El primer comando obtiene una plantilla denominada DefaultManualActivityTemplate mediante el cmdlet Get-SCSMObjectTemplate. El comando almacena la plantilla en la variable $Template.

El segundo comando crea una matriz de notificaciones como tablas hash y las almacena en la variable $Notification.

El comando final crea un flujo de trabajo que se puede usar cuando se crea una actividad manual. Dado que el script no especifica ningún criterio, este flujo de trabajo se aplica a cualquier creación de una actividad manual.

Ejemplo 2: Creación de un flujo de trabajo para la creación de actividades manuales para un usuario

PS C:\>$CriteriaString = @'
>>  <Criteria>
>>   <Expression>
>>    <SimpleExpression>
>>     <ValueExpression>
>>      <Property State="Post">
>>  $Context/$Path[Relationship='System.WorkItem.Library!System.WorkItemCreatedByUser' TypeConstraint='System!System.Domain.User']/Property[Type='System!System.Domain.User']/UserName$
>>      </Property>
>>     </ValueExpression>
>>     <Operator>Equal</Operator>
>>     <ValueExpression>
>>      <Value>Evan Narvaez</Value>
>>     </ValueExpression>
>>    </SimpleExpression>
>>   </Expression>
>>  </Criteria>
>>  '@
PS C:\> $ManagementPack = Get-SCSMManagementPack -Name "Workflows"
PS C:\> $Template = Get-SCSMObjectTemplate -Name "DefaultManualActivityTemplate"
PS C:\> $Notification = @{ User = "Reviewers"; Template = Get-SCSMObjectTemplate -Name AssignedToUserNotificationTemplate },@{ User = "Affected User"; Template = Get-SCSMObjectTemplate -Name DefaultReviewActivityTemplate }
PS C:\> New-SCSMWorkflow -DisplayName "Manual activity workflow 09" -Class "ManualActivity" -Criteria $CriteriaString -Description "Contoso workflow 09." -Enable $False -Event Create -ManagementPack $ManagementPack -Template $Template

El primer comando crea una cadena de criterios definida para la actividad manual para seleccionar solo las actividades manuales creadas por el usuario Evan Narvaez. El comando almacena esos criterios en la variable $CriteriaString.

El segundo comando obtiene el módulo de administración denominado Flujos de trabajo mediante el cmdlet Get-SCSMManagementPack y, a continuación, lo almacena en la variable $ManagementPack. Un comando posterior usa este valor para especificar dónde guardar el flujo de trabajo. No debe ser un módulo de administración sellado.

El tercer comando obtiene una plantilla denominada DefaultManualActivityTemplate mediante el cmdlet Get-SCSMObjectTemplate. El comando almacena la plantilla en la variable $Template.

El cuarto comando crea una matriz de notificaciones como tablas hash y las almacena en la variable $Notification.

El comando final crea un flujo de trabajo que se puede usar cuando se crea una actividad manual.

Parámetros

-Class

Especifica el nombre de la clase que inicia el flujo de trabajo cuando cambia. Los valores válidos son:

  • Configuración
  • Cambio
  • Incidente
  • ManualActivity
  • ReviewActivity
  • DeploymentActivity
Tipo:System.String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ComputerName

Especifica el nombre del equipo en el que se ejecuta el servicio de acceso a datos de System Center. La cuenta de usuario especificada en el parámetro credential debe tener derechos de acceso al equipo especificado.

Tipo:System.String[]
Posición:Named
Valor predeterminado:Localhost
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

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

-Credential

Especifica las credenciales que usa este cmdlet para conectarse al servidor en el que se ejecuta el servicio de acceso a datos de System Center. La cuenta de usuario especificada debe tener derechos de acceso a ese servidor.

Tipo:System.Management.Automation.PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Criteria

Especifica un objeto que representa criterios para restringir el conjunto de resultados.

Tipo:System.String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción para el flujo de trabajo.

Tipo:System.String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

Especifica el nombre del flujo de trabajo que se va a crear.

Tipo:System.String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Enable

Indica si este cmdlet habilita o deshabilita el flujo de trabajo.

Tipo:System.Boolean
Posición:Named
Valor predeterminado:True
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableNotification

Indica si este cmdlet habilita o deshabilita las notificaciones del flujo de trabajo.

Tipo:System.Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Event

Especifica la condición en la que se inicia el flujo de trabajo. Los valores válidos son:

  • Crear
  • Actualizar
Tipo:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Valores aceptados:Create, Update
Posición:Named
Valor predeterminado:Created
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ManagementPack

Especifica el módulo de administración en el que se va a almacenar el flujo de trabajo. No especifique un módulo de administración sellado.

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Posición:Named
Valor predeterminado:The default management pack
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Notification

Especifica una tabla hash de usuarios y plantillas que se van a usar para las notificaciones del flujo de trabajo.

Tipo:System.Collections.Hashtable[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Indica que este cmdlet devuelve el flujo de trabajo que crea este cmdlet. Puede pasar este objeto a otros cmdlets.

Tipo:System.Management.Automation.SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SCSession

Especifica un objeto que representa una sesión en un servidor de administración de Service Manager.

Tipo:Microsoft.SystemCenter.Core.Connection.Connection[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Template

Especifica la plantilla que se va a aplicar a los objetos a los que afecta el flujo de trabajo.

Tipo:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
Posición:Named
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:System.Management.Automation.SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None.

No se puede canalizar la entrada a este cmdlet.

Salidas

None.

Este cmdlet no genera ninguna salida.