Set-CMTaskSequenceDeploymentType

リファレンス

モジュール:: ConfigurationManager

アプリケーションでタスクシーケンスの展開の種類を構成します。

構文

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

説明

バージョン 2006 以降に適用されます。このコマンドレットを使用して、アプリケーションでタスクシーケンスの展開の種類を構成します。詳細については、「タスクシーケンスの展開の種類」を参照してください。

このコマンドレットの構文は、MSI 展開の種類のコマンドレット Set-CMMsiDeploymentType と似ています。主な違いは、次のパラメーターです。

-InstallTaskSequenceId <string> (必須): アプリをインストールするタスクシーケンスの ID
-UninstallTaskSequenceId <string> (省略可能): アプリをアンインストールするタスクシーケンスの ID

これら 2 つのパラメーターは、展開の種類のタスクシーケンスオプションに関連します。 MSI コマンドレットの -InstallCommand パラメーターと -UninstallCommand パラメーターを置き換えます。

例

例 1: タスクシーケンスの展開の種類を変更する

このコマンドは、デプロイの種類の名前を Complex install から Advanced install に変更します。サポートされている言語として 英語 (米国) (en-US) と 中国語 (簡体字) (zh-CN) が追加されます。インストールが完了するまでに約 14 分かかることを指定し、ユーザーが Windows にサインインしていない場合にのみ実行されます。

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

要件ルールと検出方法を使用したその他の例については、「 Set-CMScriptDeploymentType 」および「 Add-CMMsiDeploymentType」を参照してください。

パラメーター

-AddDetectionClause

このデプロイの種類の検出方法句の配列を指定します。検出句を作成するには、次のいずれかのコマンドレットを使用します。

これらのコマンドレットの出力を変数に保存します。次に、これらの変数をこのパラメーターの配列として指定します。たとえば、「 -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3 」のように入力します。

Get-CMDeploymentTypeDetectionClause を使用して、別のアプリケーションから既存の検出句を取得することもできます。

型:	DetectionClause[]
Aliases:	AddDetectionClauses
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddLanguage

デプロイの種類でサポートされる言語タグの配列を指定します。たとえば、 ロシア語 (ロシア) を追加するには、タグ ru-RUを指定します。

言語タグの詳細と一覧については、「 Windows 言語コード識別子 (LCID) リファレンス」を参照してください。

型:	String[]
Aliases:	AddLanguages, Languages, Language
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddRequirement

デプロイの種類の要件オブジェクトの配列を指定します。要件ルールオブジェクトを作成するには、次のいずれかのコマンドレットを使用します。

バージョン 2111 以降では、 Get-CMDeploymentTypeRequirement コマンドレットを使用して、別のデプロイの種類から規則をコピーできます。

型:	Rule[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Application

このデプロイの種類のアプリケーションオブジェクトを指定します。このオブジェクトを取得するには、 Get-CMApplication コマンドレットを使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ApplicationId

このデプロイの種類のアプリケーションの ID を指定します。

型:	Int32
Aliases:	CI_ID, CIId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ApplicationName

このデプロイの種類のアプリケーションの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Comment

デプロイの種類の説明を省略可能に指定します。

型:	String
Aliases:	AdministratorComment
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentTypeName

構成するデプロイの種類の名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DetectionClauseConnector

GroupDetectionClauses パラメーターを使用して検出句をグループ化する場合は、このパラメーターを使用してコネクタを指定します。

次の例では、 OR コネクタを定義します。 @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

型:	Hashtable[]
Aliases:	DetectionClauseConnectors
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EstimatedRuntimeMins

アプリケーションのこの展開の種類の推定インストール時間を分単位で指定します。ソフトウェアセンターでは、アプリケーションがインストールされる前に、この見積もりがユーザーに表示されます。

型:	Int32
Aliases:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

型:	SwitchParameter
Aliases:	ForceForUnknownPublisher
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceScriptDetection32Bit

カスタムスクリプトを使用してこのデプロイの種類の存在を検出する場合は、このパラメーターを $true に設定して、スクリプトを 64 ビットクライアントで 32 ビットプロセスとして実行します。

型:	Boolean
Aliases:	Force32BitDetectionScript
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GroupDetectionClauses

このデプロイの種類の存在を検出するようにルールを構成する場合は、このパラメーターを使用して句をグループ化します。検出句を作成するには、次のいずれかのコマンドレットを使用します。

これらのコマンドレットの出力を変数に保存します。次に、句をグループ化するには、次の形式を使用します: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName。

ヒント

Configuration Manager コンソールで、[ グループ ] アクションを選択すると、句には、グループ化された句の前後にかっこが表示されます。

型:	String[]
Aliases:	GroupDetectionClausesByLogicalName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

構成するデプロイの種類のオブジェクトを指定します。このオブジェクトを取得するには、 Get-CMDeploymentType コマンドレットを使用します。

型:	IResultObject
Aliases:	DeploymentType
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-InstallationBehaviorType

この展開の種類のインストール動作を指定します。

InstallForUser: クライアントは、アプリケーションをデプロイするユーザーのアプリケーションのみをインストールします。
InstallForSystem: クライアントはアプリケーションを 1 回だけインストールします。すべてのユーザーが使用できます。
InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: アプリケーションをデバイスにデプロイすると、クライアントはすべてのユーザーに対してアプリケーションをインストールします。アプリケーションをユーザーにデプロイする場合、クライアントはそのユーザーに対してのみアプリケーションをインストールします。

型:	InstallationBehaviorType
指定可能な値:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InstallTaskSequenceId

アプリをインストールするタスクシーケンスの ID。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LogonRequirementType

サインインしているユーザーの要件を指定します。

OnlyWhenNoUserLoggedOn: ユーザーが Windows にサインインしていない場合のみ。
OnlyWhenUserLoggedOn: ユーザーがサインインしている場合のみ。このオプションが既定値です。
WhetherOrNotUserLoggedOn: ユーザーがサインインしているかどうか。

注:

WhereOrNotUserLoggedOn値は非推奨です。 WhetherOrNotUserLoggedOnに置き換えられます。

InstallationBehaviorType を InstallForUser に設定した場合、このパラメーターを設定することはできません。

型:	LogonRequirementType
指定可能な値:	OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MaximumRuntimeMins

このアプリケーションのデプロイメント・プログラムの最大許容実行時間を指定してください。整数値を分単位で設定します。

型:	Int32
Aliases:	MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NewName

このデプロイの種類の名前を変更するには、新しい名前を指定します。

型:	String
Aliases:	NewDeploymentTypeName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。既定では、このコマンドレットは出力を生成しない場合があります。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ProductCode

アプリケーションで Windows インストーラーテクノロジを使用する場合は、検出方法として設定する MSI 製品コードを指定します。このパラメーターを使用すると、既存の検出方法が上書きされます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RebootBehavior

インストール後の動作を指定します。

BasedOnExitCode: 戻りコードに基づいて動作を決定します。
NoAction: 特定のアクションはありません。
ProgramReboot: ソフトウェアインストールプログラムによってデバイスの再起動が強制される場合があります。
ForceReboot: Configuration Manager クライアントは、必須のデバイスの再起動を強制します。

これらの動作の詳細については、「 Configuration Manager でアプリケーションを作成する」を参照してください。

型:	PostExecutionBehavior
指定可能な値:	BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveDetectionClause

削除する検出方法句の配列を指定します。

型:	String[]
Aliases:	RemoveDetectionClauses
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveLanguage

このデプロイの種類から削除するサポートされている言語の配列を指定します。

型:	String[]
Aliases:	RemoveLanguages
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveRequirement

このデプロイの種類から削除する要件規則の配列を指定します。

型:	Rule[]
Aliases:	RemoveRequirements
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RequireUserInteraction

ユーザーが展開の種類のインストールを表示して操作できるようにするには、このパラメーターを $true に設定します。

型:	Boolean
Aliases:	RequiresUserInteraction
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScriptFile

このデプロイの種類を検出するために使用するスクリプトファイルを指定します。 ScriptLanguage パラメーターも使用します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScriptLanguage

ScriptFile パラメーターまたは ScriptText パラメーターを使用する場合は、このパラメーターを使用してスクリプト言語を指定します。

型:	ScriptLanguage
Aliases:	ScriptType
指定可能な値:	PowerShell, VBScript, JavaScript
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScriptText

このデプロイの種類を検出するスクリプトのテキストを指定します。 ScriptLanguage パラメーターも使用します。

詳細については、「カスタムスクリプト検出方法について」を参照してください。

型:	String
Aliases:	ScriptContent, Script
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SlowNetworkDeploymentMode

クライアントが近隣境界グループまたは既定のサイト境界グループの配布ポイントを使用する場合は、展開オプションを指定します。

DoNothing: コンテンツをダウンロードしない
Download: 配布ポイントからコンテンツをダウンロードし、ローカルで実行する

型:	ContentHandlingMode
指定可能な値:	DoNothing, Download
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UninstallTaskSequenceId

アプリをアンインストールするタスクシーケンスの ID。

型:	String
Aliases:	ContentLocation, UninstallId
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserInteractionMode

インストールプログラムの可視性を指定します。

Normal: 展開の種類は、システムとプログラムの既定値に基づいて通常モードで実行されます。このモードが既定です。
Minimized: 展開の種類は、クライアントデバイスで最小化されて実行されます。ユーザーは、通知領域またはタスクバーにインストールアクティビティが表示される場合があります。
Maximized: 展開の種類は、クライアントデバイスで最大化されて実行されます。ユーザーには、すべてのインストールアクティビティが表示されます。
Hidden: 展開の種類は、クライアントデバイスでは非表示で実行されます。ユーザーにはインストールアクティビティが表示されません。

型:	UserInteractionMode
Aliases:	InstallationProgramVisibility
指定可能な値:	Normal, Minimized, Maximized, Hidden
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

次の方法で共有