New-SCSMWorkflow

Vytvoří nový pracovní postup na portále Service Manager.

Syntax

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

Rutina New-SCSMWorkflow vytvoří pracovní postup v Service Manager.

Příklady

Příklad 1: Vytvoření pracovního postupu pro ruční vytváření aktivit

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

První příkaz získá šablonu s názvem DefaultManualActivityTemplate pomocí rutiny Get-SCSMObjectTemplate. Příkaz uloží šablonu do proměnné $Template.

Druhý příkaz vytvoří pole oznámení jako tabulky hash a uloží je do proměnné $Notification.

Poslední příkaz vytvoří pracovní postup, který lze použít při vytvoření ruční aktivity. Vzhledem k tomu, že skript neurčuje žádná kritéria, použije se tento pracovní postup pro jakékoli vytvoření ruční aktivity.

Příklad 2: Vytvoření pracovního postupu pro ruční vytvoření aktivity pro uživatele

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

První příkaz vytvoří řetězec kritérií definovaný pro ruční aktivitu, který vybere pouze ty ruční aktivity, které byly vytvořeny uživatelem Evan Narvaez. Příkaz uloží tato kritéria do proměnné $CriteriaString.

Druhý příkaz získá sadu Management Pack s názvem Workflows pomocí rutiny Get-SCSMManagementPack a pak ji uloží do proměnné $ManagementPack. Následující příkaz použije tuto hodnotu k určení, kam se má pracovní postup uložit. Nesmí se jednat o zapečetěnou sadu Management Pack.

Třetí příkaz získá šablonu s názvem DefaultManualActivityTemplate pomocí rutiny Get-SCSMObjectTemplate. Příkaz uloží šablonu do proměnné $Template.

Čtvrtý příkaz vytvoří pole oznámení jako tabulky hash a uloží je do proměnné $Notification.

Poslední příkaz vytvoří pracovní postup, který lze použít při vytvoření ruční aktivity.

Parametry

-Class

Určuje název třídy, která spustí pracovní postup při jeho změně. Platné hodnoty jsou:

  • Konfigurace
  • Změnit
  • Incident (Incident)
  • ManualActivity
  • Revizní aktivita
  • DeploymentActivity
Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Určuje název počítače, na kterém běží služba System Center Data Access. Uživatelský účet zadaný v parametru Credential musí mít přístupová práva k zadanému počítači.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

Určuje přihlašovací údaje, které tato rutina používá pro připojení k serveru, na kterém běží služba System Center Data Access. Zadaný uživatelský účet musí mít přístupová práva k danému serveru.

Type:System.Management.Automation.PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Criteria

Určuje objekt, který představuje kritéria pro omezení sady výsledků.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Určuje popis pracovního postupu.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Určuje název pracovního postupu, který chcete vytvořit.

Type:System.String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Enable

Označuje, jestli tato rutina povolí nebo zakáže pracovní postup.

Type:System.Boolean
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNotification

Označuje, jestli tato rutina povolí nebo zakáže oznámení z pracovního postupu.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Event

Určuje podmínku, za které se pracovní postup spustí. Platné hodnoty jsou:

  • Vytvořit
  • Aktualizace
Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Accepted values:Create, Update
Position:Named
Default value:Created
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementPack

Určuje sadu Management Pack, do které se má pracovní postup uložit. Nezadávejte zapečetěnou sadu Management Pack.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Position:Named
Default value:The default management pack
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Notification

Určuje tabulku hodnot hash uživatelů a šablon, které se mají použít pro oznámení z pracovního postupu.

Type:System.Collections.Hashtable[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Označuje, že tato rutina vrátí pracovní postup, který tato rutina vytvoří. Tento objekt můžete předat jiným rutinám.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Určuje objekt, který představuje relaci k serveru pro správu Service Manager.

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

-Template

Určuje šablonu, která se má použít na objekty, na které má pracovní postup vliv.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

None.

Vstup do této rutiny nelze připojit.

Výstupy

None.

Tato rutina negeneruje žádný výstup.