New-SCSMWorkflow
Vytvoří nový pracovní postup v Service Manageru.
Syntaxe
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 Manageru.
Příklady
Příklad 1: Vytvoření pracovního postupu pro ruční vytvoření aktivity
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 $Notification proměnné.
Konečný příkaz vytvoří pracovní postup, který lze použít při vytvoření ruční aktivity. Vzhledem k tomu, že skript neurčí žádná kritéria, tento pracovní postup se vztahuje na 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, aby vybral pouze ty ruční aktivity vytvořené 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 Pracovní postupy pomocí rutiny Get-SCSMManagementPack a uloží ji 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 $Notification proměnné.
Konečný 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 změně. Platné hodnoty jsou:
- Konfigurace
- Vyměnit
- Událost
- ManualActivity
- ReviewActivity
- DeploymentActivity
Typ: | System.String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | System.String[] |
Position: | Named |
Default value: | Localhost |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | System.Management.Automation.SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Criteria
Určuje objekt, který představuje kritéria pro omezení sady výsledků.
Typ: | System.String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Description
Určuje popis pracovního postupu.
Typ: | System.String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisplayName
Určuje název pracovního postupu, který se má vytvořit.
Typ: | System.String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Enable
Určuje, jestli tato rutina povolí nebo zakáže pracovní postup.
Typ: | System.Boolean |
Position: | Named |
Default value: | True |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-EnableNotification
Určuje, jestli tato rutina povolí nebo zakáže oznámení z pracovního postupu.
Typ: | System.Boolean |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Event
Určuje podmínku, pod kterou pracovní postup začíná. Platné hodnoty jsou:
- Vytvářet
- Aktualizace
Typ: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent |
Přípustné hodnoty: | Create, Update |
Position: | Named |
Default value: | Created |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ManagementPack
Určuje sadu Management Pack, do které se má pracovní postup uložit. Nezadávejte zapečetěnou sadu Management Pack.
Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPack |
Position: | Named |
Default value: | The default management pack |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Notification
Určuje tabulku hash uživatelů a šablon, které se mají použít pro oznámení z pracovního postupu.
Typ: | System.Collections.Hashtable[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-SCSession
Určuje objekt, který představuje relaci se serverem pro správu Service Manageru.
Typ: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Template
Určuje šablonu, která se má použít na objekty, které pracovní postup ovlivňuje.
Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | System.Management.Automation.SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
None.
Vstup do této rutiny nelze převést.
Výstupy
None.
Tato rutina negeneruje žádný výstup.