Delen via

New-SCSMWorkflow

  • Referentie
Module:
System.Center.Service.Manager

Hiermee maakt u een nieuwe werkstroom in Service Manager.

Syntaxis

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

De New-SCSMWorkflow cmdlet maakt een werkstroom in Service Manager.

Voorbeelden

Voorbeeld 1: Een werkstroom maken voor het maken van handmatige activiteiten

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

Met de eerste opdracht krijgt u een sjabloon met de naam DefaultManualActivityTemplate met behulp van de cmdlet Get-SCSMObjectTemplate. Met de opdracht wordt de sjabloon opgeslagen in de $Template variabele.

Met de tweede opdracht maakt u een matrix met meldingen als hashtabellen en slaat u deze op in de $Notification variabele.

Met de laatste opdracht maakt u een werkstroom die kan worden gebruikt wanneer een handmatige activiteit wordt gemaakt. Omdat het script geen criteria opgeeft, is deze werkstroom van toepassing op het maken van een handmatige activiteit.

Voorbeeld 2: Een werkstroom maken voor het handmatig maken van activiteiten voor een gebruiker

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

Met de eerste opdracht maakt u een criteriareeks die is gedefinieerd voor de handmatige activiteit om alleen de handmatige activiteiten te selecteren die zijn gemaakt door de gebruiker Evan Narvaez. Met de opdracht worden deze criteria opgeslagen in de variabele $CriteriaString.

Met de tweede opdracht haalt u het management pack met de naam Werkstromen op met behulp van de cmdlet Get-SCSMManagementPack en slaat u het vervolgens op in de $ManagementPack variabele. In een volgende opdracht wordt deze waarde gebruikt om op te geven waar de werkstroom moet worden opgeslagen. Dit mag geen verzegeld management pack zijn.

Met de derde opdracht krijgt u een sjabloon met de naam DefaultManualActivityTemplate met behulp van de cmdlet Get-SCSMObjectTemplate. Met de opdracht wordt de sjabloon opgeslagen in de $Template variabele.

Met de vierde opdracht maakt u een matrix met meldingen als hashtabellen en slaat u deze op in de $Notification variabele.

Met de laatste opdracht maakt u een werkstroom die kan worden gebruikt wanneer een handmatige activiteit wordt gemaakt.

Parameters

-Class

Hiermee geeft u de naam op van de klasse die de werkstroom start wanneer deze wordt gewijzigd. Geldige waarden zijn:

  • Configuratie
  • Veranderen
  • Incident
  • ManualActivity
  • ReviewActivity
  • DeploymentActivity
Type:System.String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u de naam op van de computer waarop de System Center Data Access-service wordt uitgevoerd. Het gebruikersaccount dat is opgegeven in de parameter Credential moet toegangsrechten hebben voor de opgegeven computer.

Type:System.String[]
Position:Named
Default value:Localhost
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:System.Management.Automation.SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u de referenties op die door deze cmdlet worden gebruikt om verbinding te maken met de server waarop de System Center Data Access-service wordt uitgevoerd. Het opgegeven gebruikersaccount moet toegangsrechten hebben voor die server.

Type:System.Management.Automation.PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Criteria

Hiermee geeft u een object op dat criteria vertegenwoordigt om de resultatenset te beperken.

Type:System.String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor de werkstroom.

Type:System.String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de naam van de werkstroom die moet worden gemaakt.

Type:System.String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enable

Geeft aan of deze cmdlet de werkstroom inschakelt of uitschakelt.

Type:System.Boolean
Position:Named
Default value:True
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EnableNotification

Hiermee wordt aangegeven of met deze cmdlet meldingen van de werkstroom worden ingeschakeld of uitgeschakeld.

Type:System.Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Event

Hiermee geeft u de voorwaarde op waaronder de werkstroom wordt gestart. Geldige waarden zijn:

  • Scheppen
  • Update
Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Geaccepteerde waarden:Create, Update
Position:Named
Default value:Created
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ManagementPack

Hiermee geeft u het management pack waarin de werkstroom moet worden opgeslagen. Geef geen verzegeld management pack op.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Default value:The default management pack
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Notification

Hiermee geeft u een hash-tabel van gebruikers en sjablonen die moeten worden gebruikt voor meldingen van de werkstroom.

Type:System.Collections.Hashtable[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Geeft aan dat deze cmdlet de werkstroom retourneert die door deze cmdlet wordt gemaakt. U kunt dit object doorgeven aan andere cmdlets.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een object op dat een sessie aan een Service Manager-beheerserver vertegenwoordigt.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Template

Hiermee geeft u de sjabloon op die moet worden toegepast op de objecten waarop de werkstroom van invloed is.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:System.Management.Automation.SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None.

U kunt invoer voor deze cmdlet niet doorsluisen.

Uitvoerwaarden

None.

Met deze cmdlet wordt geen uitvoer gegenereerd.