Freigeben über


New-SCSMWorkflow

Erstellt einen neuen Workflow in Service Manager.

Syntax

Default (Standardwert)

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>]

Beschreibung

Das Cmdlet New-SCSMWorkflow erstellt einen Workflow in Service Manager.

Beispiele

Beispiel 1: Erstellen eines Workflows für die erstellung manueller Aktivitäten

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

Der erste Befehl ruft eine Vorlage mit dem Namen DefaultManualActivityTemplate mithilfe des cmdlets Get-SCSMObjectTemplate ab. Der Befehl speichert die Vorlage in der variablen $Template.

Der zweite Befehl erstellt ein Array von Benachrichtigungen als Hashtabellen und speichert sie in der variablen $Notification.

Der letzte Befehl erstellt einen Workflow, der verwendet werden kann, wenn eine manuelle Aktivität erstellt wird. Da das Skript keine Kriterien angibt, gilt dieser Workflow für jede Erstellung einer manuellen Aktivität.

Beispiel 2: Erstellen eines Workflows für die manuelle Aktivitätserstellung für einen Benutzer

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

Der erste Befehl erstellt eine Kriterienzeichenfolge, die für die manuelle Aktivität definiert ist, um nur die manuellen Aktivitäten auszuwählen, die vom Benutzer Evan Narvaez erstellt wurden. Der Befehl speichert diese Kriterien in der variablen $CriteriaString.

Der zweite Befehl ruft das Management Pack namens Workflows mithilfe des Cmdlets Get-SCSMManagementPack ab und speichert es dann in der $ManagementPack Variablen. Ein nachfolgender Befehl verwendet diesen Wert, um anzugeben, wo der Workflow gespeichert werden soll. Dies darf kein versiegeltes Management Pack sein.

Der dritte Befehl ruft eine Vorlage mit dem Namen DefaultManualActivityTemplate mithilfe des cmdlets Get-SCSMObjectTemplate ab. Der Befehl speichert die Vorlage in der variablen $Template.

Der vierte Befehl erstellt ein Array von Benachrichtigungen als Hashtabellen und speichert sie in der variablen $Notification.

Der letzte Befehl erstellt einen Workflow, der verwendet werden kann, wenn eine manuelle Aktivität erstellt wird.

Parameter

-Class

Gibt den Namen der Klasse an, die den Workflow startet, wenn er geändert wird. Gültige Werte sind:

  • Konfiguration
  • Veränderung
  • Vorfall
  • ManuelleAktivität
  • ReviewActivity (Bewertung)
  • DeploymentActivity (Einsatzaktivität)

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ComputerName

Gibt den Namen des Computers an, auf dem der System Center Data Access-Dienst ausgeführt wird. Das benutzerkonto, das im parameter Credential angegeben ist, muss über Zugriffsrechte für den angegebenen Computer verfügen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:Localhost
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Credential

Gibt die Anmeldeinformationen an, die dieses Cmdlet zum Herstellen einer Verbindung mit dem Server verwendet, auf dem der System Center Data Access-Dienst ausgeführt wird. Das angegebene Benutzerkonto muss über Zugriffsrechte für diesen Server verfügen.

Parametereigenschaften

Typ:System.Management.Automation.PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Criteria

Gibt ein Objekt an, das Kriterien zum Einschränken des Resultsets darstellt.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für den Workflow an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisplayName

Gibt den Namen des zu erstellenden Workflows an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Enable

Gibt an, ob dieses Cmdlet den Workflow aktiviert oder deaktiviert.

Parametereigenschaften

Typ:System.Boolean
Standardwert:True
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EnableNotification

Gibt an, ob dieses Cmdlet Benachrichtigungen vom Workflow aktiviert oder deaktiviert.

Parametereigenschaften

Typ:System.Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Event

Gibt die Bedingung an, unter der der Workflow gestartet wird. Gültige Werte sind:

  • Schaffen
  • Aktualisieren

Parametereigenschaften

Typ:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Workflows.WorkflowEvent
Standardwert:Created
Zulässige Werte:Create, Update
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ManagementPack

Gibt das Management Pack an, in dem der Workflow gespeichert werden soll. Geben Sie kein versiegeltes Management Pack an.

Parametereigenschaften

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPack
Standardwert:The default management pack
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Notification

Gibt eine Hashtabelle von Benutzern und Vorlagen an, die für Benachrichtigungen aus dem Workflow verwendet werden sollen.

Parametereigenschaften

Typ:

System.Collections.Hashtable[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt an, dass dieses Cmdlet den Workflow zurückgibt, den dieses Cmdlet erstellt. Sie können dieses Objekt an andere Cmdlets übergeben.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SCSession

Gibt ein Objekt an, das eine Sitzung auf einem Dienst-Manager-Verwaltungsserver darstellt.

Parametereigenschaften

Typ:

Microsoft.SystemCenter.Core.Connection.Connection[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Template

Gibt die Vorlage an, die auf die Objekte angewendet werden soll, die sich auf den Workflow auswirken.

Parametereigenschaften

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackObjectTemplate
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None.

Sie können keine Eingabe an dieses Cmdlet weiterleiten.

Ausgaben

None.

Dieses Cmdlet generiert keine Ausgabe.