Set-CMTaskSequenceDeploymentType

Konfigurieren sie einen Tasksequenz-Bereitstellungstyp für eine Anwendung.

Syntax

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -Application <IResultObject>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Gilt für Version 2006 und höher. Verwenden Sie dieses Cmdlet, um einen Tasksequenz-Bereitstellungstyp für eine Anwendung zu konfigurieren. Weitere Informationen finden Sie unter Bereitstellungstyp der Tasksequenz.

Dieses Cmdlet hat eine ähnliche Syntax wie das MSI-Bereitstellungstyp-Cmdlet "Set-CMMsiDeploymentType". Die wichtigsten Unterschiede sind die folgenden Parameter:

  • -InstallTaskSequenceId <string> (erforderlich): Die ID der Tasksequenz zum Installieren der App

  • -UninstallTaskSequenceId <string> (optional): Die ID der Tasksequenz zum Deinstallieren der App

Diese beiden Parameter beziehen sich auf die Tasksequenzoptionen für den Bereitstellungstyp. Sie ersetzen die -InstallCommand Parameter und parameter für das -UninstallCommand MSI-Cmdlet.

Beispiele

Beispiel 1: Ändern eines Bereitstellungstyps für eine Tasksequenz

Mit diesem Befehl wird der Name des Bereitstellungstyps von "Komplexe Installation" in "Erweiterte Installation" geändert. Es werden Englisch (USA) ( en-US ) und Chinesisch (vereinfacht) ( zh-CN ) als unterstützte Sprachen hinzugefügt. Es gibt an, dass die Installation ca. 14 Minuten dauert und nur ausgeführt wird, wenn keine Benutzer bei Windows angemeldet sind.

Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn

Weitere Beispiele mit Anforderungsregeln und Erkennungsmethoden finden Sie unter "Set-CMScriptDeploymentType" und "Add-CMMsiDeploymentType".

Parameter

-AddDetectionClause

Geben Sie ein Array von Erkennungsmethodenklauseln für diesen Bereitstellungstyp an. Verwenden Sie eines der folgenden Cmdlets, um eine Erkennungsklausel zu erstellen:

Speichern Sie die Ausgabe dieser Cmdlets in einer Variablen. Geben Sie dann diese Variablen als Array für diesen Parameter an. Beispiel: -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

Sie können auch Get-CMDeploymentTypeDetectionClause verwenden, um eine vorhandene Erkennungsklausel aus einer anderen Anwendung abzurufen.

Type:DetectionClause[]
Aliases:AddDetectionClauses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddLanguage

Geben Sie ein Array von Sprachtags an, die vom Bereitstellungstyp unterstützt werden. Wenn Sie z. B. Russisch (Russland) hinzufügen möchten, geben Sie das Tag ru-RU an.

Weitere Informationen und eine Liste der Sprachtags finden Sie unter Windows Lcid-Referenz (Language Code Identifier).

Type:String[]
Aliases:AddLanguages, Languages, Language
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddRequirement

-Application

Geben Sie ein Anwendungsobjekt für diesen Bereitstellungstyp an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMApplication".

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationId

Geben Sie die ID der Anwendung für diesen Bereitstellungstyp an.

Type:Int32
Aliases:CI_ID, CIId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Geben Sie den Namen der Anwendung für diesen Bereitstellungstyp an.

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

-Comment

Geben Sie eine optionale Beschreibung für den Bereitstellungstyp an.

Type:String
Aliases:AdministratorComment
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentTypeName

Geben Sie den Namen des zu konfigurierenden Bereitstellungstyps an.

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

-DetectionClauseConnector

Wenn Sie den Parameter GroupDetectionClauses zum Gruppieren von Erkennungsklauseln verwenden, verwenden Sie diesen Parameter, um den Connector anzugeben.

Im folgenden Beispiel wird der OR-Connector definiert: @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

Type:Hashtable[]
Aliases:DetectionClauseConnectors
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EstimatedRuntimeMins

Geben Sie die geschätzte Installationszeit dieses Bereitstellungstyps für die Anwendung in Minuten an. Software Center zeigt diese Schätzung dem Benutzer an, bevor die Anwendung installiert wird.

Type:Int32
Aliases:EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Erzwingt die Ausführung des Befehls, ohne die Bestätigung des Benutzers anzufordern.

Type:SwitchParameter
Aliases:ForceForUnknownPublisher
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceScriptDetection32Bit

Wenn Sie ein benutzerdefiniertes Skript verwenden, um das Vorhandensein dieses Bereitstellungstyps zu erkennen, legen Sie diesen Parameter so fest, dass $true das Skript als 32-Bit-Prozess auf 64-Bit-Clients ausgeführt wird.

Type:Boolean
Aliases:Force32BitDetectionScript
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-GroupDetectionClauses

Wenn Sie Regeln konfigurieren, um das Vorhandensein dieses Bereitstellungstyps zu erkennen, verwenden Sie diesen Parameter, um Klauseln zu gruppieren. Verwenden Sie eines der folgenden Cmdlets, um eine Erkennungsklausel zu erstellen:

Speichern Sie die Ausgabe dieser Cmdlets in einer Variablen. Verwenden Sie dann das folgende Format, um Klauseln zu gruppieren: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Tipp

Wenn Sie in der Configuration Manager-Konsole die Gruppenaktion auswählen, werden in den Klauseln vor und nach den gruppierten Klauseln Klammern angezeigt.

Type:String[]
Aliases:GroupDetectionClausesByLogicalName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Geben Sie ein zu konfigurierende Bereitstellungstypobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMDeploymentType".

Type:IResultObject
Aliases:DeploymentType
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InstallationBehaviorType

Geben Sie das Installationsverhalten für diesen Bereitstellungstyp an:

  • InstallForUser: Der Client installiert nur die Anwendung für den Benutzer, für den Sie die Anwendung bereitstellen.
  • InstallForSystem: Der Client installiert die Anwendung nur einmal. Es ist für alle Benutzer verfügbar.
  • InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: Wenn Sie die Anwendung auf einem Gerät bereitstellen, installiert der Client sie für alle Benutzer. Wenn Sie die Anwendung für einen Benutzer bereitstellen, installiert der Client sie nur für diesen Benutzer.
Type:InstallationBehaviorType
Accepted values:InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InstallTaskSequenceId

Die ID der Tasksequenz, in der die App installiert werden soll.

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

-LogonRequirementType

Geben Sie die Anforderung für einen angemeldeten Benutzer an:

  • OnlyWhenNoUserLoggedOn: Nur, wenn kein Benutzer bei Windows angemeldet ist.

  • OnlyWhenUserLoggedOn: Nur, wenn ein Benutzer angemeldet ist. Dies ist die Standardeinstellung.

  • WhetherOrNotUserLoggedOn: Gibt an, ob ein Benutzer angemeldet ist.

    Hinweis

    Der Wert WhereOrNotUserLoggedOn ist veraltet. Er wird durch WhetherOrNotUserLoggedOn .

Wenn Sie InstallationBehaviorType auf InstallBehaviorType InstallForUser festlegen, können Sie diesen Parameter nicht festlegen.

Type:LogonRequirementType
Accepted values:OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumRuntimeMins

Geben Sie die maximal zulässige Laufzeit des Bereitstellungsprogramms für diese Anwendung an. Legen Sie einen ganzzahligen Wert in Minuten fest.

Type:Int32
Aliases:MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Geben Sie einen neuen Namen an, um diesen Bereitstellungstyp umzubenennen.

Type:String
Aliases:NewDeploymentTypeName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProductCode

Wenn die Anwendung Windows Installer-Technologie verwendet, geben Sie einen MSI-Produktcode an, der als Erkennungsmethode festgelegt werden soll. Wenn Sie diesen Parameter verwenden, werden alle vorhandenen Erkennungsmethoden überschrieben.

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

-RebootBehavior

Geben Sie das Verhalten nach der Installation an:

  • BasedOnExitCode: Bestimmen des Verhaltens basierend auf Rückgabecodes.

  • NoAction: Keine spezifische Aktion.

  • ProgramReboot: Das Softwareinstallationsprogramm erzrückt möglicherweise einen Geräteneustart.

  • ForceReboot: Der Configuration Manager-Client erzrückt einen obligatorischen Geräteneustart.

Weitere Informationen zu diesen Verhaltensweisen finden Sie unter Erstellen von Anwendungen in Configuration Manager.

Type:PostExecutionBehavior
Accepted values:BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveDetectionClause

Geben Sie ein Array von Erkennungsmethodenklauseln an, die entfernt werden sollen.

Type:String[]
Aliases:RemoveDetectionClauses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveLanguage

Geben Sie ein Array unterstützter Sprachen an, die aus diesem Bereitstellungstyp entfernt werden sollen.

Type:String[]
Aliases:RemoveLanguages
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveRequirement

Geben Sie ein Array von Anforderungsregeln an, die aus diesem Bereitstellungstyp entfernt werden sollen.

Type:Rule[]
Aliases:RemoveRequirements
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RequireUserInteraction

Legen Sie diesen Parameter so $true fest, dass Benutzer die Installation des Bereitstellungstyps anzeigen und damit interagieren können.

Type:Boolean
Aliases:RequiresUserInteraction
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptFile

Geben Sie die Skriptdatei an, die zum Erkennen dieses Bereitstellungstyps verwendet werden soll. Verwenden Sie auch den Parameter ScriptLanguage.

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

-ScriptLanguage

Wenn Sie die Parameter ScriptFile oder ScriptText verwenden, verwenden Sie diesen Parameter, um die Skriptsprache anzugeben.

Type:ScriptLanguage
Aliases:ScriptType
Accepted values:PowerShell, VBScript, JavaScript
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptText

Geben Sie den Text eines Skripts an, um diesen Bereitstellungstyp zu erkennen. Verwenden Sie auch den Parameter ScriptLanguage.

Weitere Informationen finden Sie unter "Informationen zu benutzerdefinierten Skripterkennungsmethoden".

Type:String
Aliases:ScriptContent, Script
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SlowNetworkDeploymentMode

Wenn ein Client einen Verteilungspunkt aus einer benachbarten Begrenzungsgruppe oder der Standardmäßigen Standortgrenzgruppe verwendet, geben Sie die Bereitstellungsoption an:

  • DoNothing: Inhalte nicht herunterladen
  • Download: Herunterladen von Inhalten vom Verteilungspunkt und lokales Ausführen
Type:ContentHandlingMode
Accepted values:DoNothing, Download
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UninstallTaskSequenceId

Die ID der Tasksequenz zum Deinstallieren der App.

Type:String
Aliases:ContentLocation, UninstallId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserInteractionMode

Geben Sie die Sichtbarkeit des Installationsprogramms an:

  • Normal: Der Bereitstellungstyp wird im normalen Modus basierend auf den System- und Programmstandardeinstellungen ausgeführt. Dieser Modus ist die Standardeinstellung.
  • Minimized: Der Bereitstellungstyp wird auf Clientgeräten minimiert ausgeführt. Benutzer sehen die Installationsaktivität möglicherweise im Benachrichtigungsbereich oder in der Taskleiste.
  • Maximized: Der Bereitstellungstyp wird maximiert auf Clientgeräten ausgeführt. Benutzern werden alle Installationsaktivitäten angezeigt.
  • Hidden: Der Bereitstellungstyp wird auf Clientgeräten ausgeblendet ausgeführt. Benutzern wird keine Installationsaktivität angezeigt.
Type:UserInteractionMode
Aliases:InstallationProgramVisibility
Accepted values:Normal, Minimized, Maximized, Hidden
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object