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.