Set-CMTSStepRunPowerShellScript

PowerShell スクリプトの実行タスク シーケンス ステップ のインスタンス を構成します。

構文

Set-CMTSStepRunPowerShellScript
   [-ExecutionPolicy <ExecutionPolicyType>]
   [-OutputVariableName <String>]
   [-PackageId <String>]
   [-Parameter <String>]
   [-ScriptName <String>]
   [-SourceScript <String>]
   [-SuccessCode <Int32[]>]
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-AddCondition <IResultObject[]>]
   [-ClearCondition]
   [-Description <String>]
   -InputObject <IResultObject>
   [-IsContinueOnError <Boolean>]
   [-IsEnabled <Boolean>]
   [-MoveToIndex <Int32>]
   [-NewStepName <String>]
   [-RemoveConditionFile]
   [-RemoveConditionFolder]
   [-RemoveConditionIfStatement]
   [-RemoveConditionOperatingSystem]
   [-RemoveConditionQueryWmi]
   [-RemoveConditionRegistry]
   [-RemoveConditionSoftware]
   [-RemoveConditionVariable]
   [-StepName <String>]
   [-StepOrder <ReorderType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-ExecutionPolicy <ExecutionPolicyType>]
   [-OutputVariableName <String>]
   [-PackageId <String>]
   [-Parameter <String>]
   [-ScriptName <String>]
   [-SourceScript <String>]
   [-SuccessCode <Int32[]>]
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-AddCondition <IResultObject[]>]
   [-ClearCondition]
   [-Description <String>]
   [-IsContinueOnError <Boolean>]
   [-IsEnabled <Boolean>]
   [-MoveToIndex <Int32>]
   [-NewStepName <String>]
   [-RemoveConditionFile]
   [-RemoveConditionFolder]
   [-RemoveConditionIfStatement]
   [-RemoveConditionOperatingSystem]
   [-RemoveConditionQueryWmi]
   [-RemoveConditionRegistry]
   [-RemoveConditionSoftware]
   [-RemoveConditionVariable]
   [-StepName <String>]
   [-StepOrder <ReorderType>]
   -TaskSequenceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-ExecutionPolicy <ExecutionPolicyType>]
   [-OutputVariableName <String>]
   [-PackageId <String>]
   [-Parameter <String>]
   [-ScriptName <String>]
   [-SourceScript <String>]
   [-SuccessCode <Int32[]>]
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-AddCondition <IResultObject[]>]
   [-ClearCondition]
   [-Description <String>]
   [-IsContinueOnError <Boolean>]
   [-IsEnabled <Boolean>]
   [-MoveToIndex <Int32>]
   [-NewStepName <String>]
   [-RemoveConditionFile]
   [-RemoveConditionFolder]
   [-RemoveConditionIfStatement]
   [-RemoveConditionOperatingSystem]
   [-RemoveConditionQueryWmi]
   [-RemoveConditionRegistry]
   [-RemoveConditionSoftware]
   [-RemoveConditionVariable]
   [-StepName <String>]
   [-StepOrder <ReorderType>]
   -TaskSequenceName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Condition <IResultObject[]>]
   [-SetConditionIfStatement]
   [-StatementType <ConditionStatementType>]
   [-StepName <String>]
   -TaskSequenceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Condition <IResultObject[]>]
   [-SetConditionIfStatement]
   [-StatementType <ConditionStatementType>]
   [-StepName <String>]
   -TaskSequenceName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Condition <IResultObject[]>]
   -InputObject <IResultObject>
   [-SetConditionIfStatement]
   [-StatementType <ConditionStatementType>]
   [-StepName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-ConditionVariableName <String>]
   [-ConditionVariableValue <String>]
   [-OperatorType <VariableOperatorType>]
   [-SetConditionVariable]
   [-StepName <String>]
   -TaskSequenceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-ConditionVariableName <String>]
   [-ConditionVariableValue <String>]
   [-OperatorType <VariableOperatorType>]
   [-SetConditionVariable]
   [-StepName <String>]
   -TaskSequenceName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-ConditionVariableName <String>]
   [-ConditionVariableValue <String>]
   -InputObject <IResultObject>
   [-OperatorType <VariableOperatorType>]
   [-SetConditionVariable]
   [-StepName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-FileDateTimeOperator <VariableOperatorType>]
   [-FilePath <String>]
   [-FileTimestamp <DateTime>]
   [-FileVersion <String>]
   [-SetConditionFile]
   [-StepName <String>]
   -TaskSequenceId <String>
   [-VersionOperator <VariableOperatorType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-FileDateTimeOperator <VariableOperatorType>]
   [-FilePath <String>]
   [-FileTimestamp <DateTime>]
   [-FileVersion <String>]
   [-SetConditionFile]
   [-StepName <String>]
   -TaskSequenceName <String>
   [-VersionOperator <VariableOperatorType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-FileDateTimeOperator <VariableOperatorType>]
   [-FilePath <String>]
   [-FileTimestamp <DateTime>]
   [-FileVersion <String>]
   -InputObject <IResultObject>
   [-SetConditionFile]
   [-StepName <String>]
   [-VersionOperator <VariableOperatorType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-FolderDateTimeOperator <VariableOperatorType>]
   [-FolderPath <String>]
   [-FolderTimestamp <DateTime>]
   [-SetConditionFolder]
   [-StepName <String>]
   -TaskSequenceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-FolderDateTimeOperator <VariableOperatorType>]
   [-FolderPath <String>]
   [-FolderTimestamp <DateTime>]
   [-SetConditionFolder]
   [-StepName <String>]
   -TaskSequenceName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-FolderDateTimeOperator <VariableOperatorType>]
   [-FolderPath <String>]
   [-FolderTimestamp <DateTime>]
   -InputObject <IResultObject>
   [-SetConditionFolder]
   [-StepName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   -InputObject <IResultObject>
   [-Namespace <String[]>]
   [-Query <String>]
   [-SetConditionQueryWmi]
   [-StepName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   -InputObject <IResultObject>
   [-SetConditionOperatingSystem]
   [-StepName <String>]
   [-SupportedPlatform <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   -InputObject <IResultObject>
   [-RegistryKey <String>]
   [-RegistryOperator <VariableOperatorType>]
   [-RegistryValueData <String>]
   [-RegistryValueName <String>]
   [-RootKey <RegistryRootKeyType>]
   [-SetConditionRegistry]
   [-StepName <String>]
   [-ValueType <RegistryValueType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   -InputObject <IResultObject>
   [-IsAnyVersion <Boolean>]
   [-MsiFilePath <String>]
   [-SetConditionSoftware]
   [-StepName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-IsAnyVersion <Boolean>]
   [-MsiFilePath <String>]
   [-SetConditionSoftware]
   [-StepName <String>]
   -TaskSequenceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-IsAnyVersion <Boolean>]
   [-MsiFilePath <String>]
   [-SetConditionSoftware]
   [-StepName <String>]
   -TaskSequenceName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Namespace <String[]>]
   [-Query <String>]
   [-SetConditionQueryWmi]
   [-StepName <String>]
   -TaskSequenceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-Namespace <String[]>]
   [-Query <String>]
   [-SetConditionQueryWmi]
   [-StepName <String>]
   -TaskSequenceName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-RegistryKey <String>]
   [-RegistryOperator <VariableOperatorType>]
   [-RegistryValueData <String>]
   [-RegistryValueName <String>]
   [-RootKey <RegistryRootKeyType>]
   [-SetConditionRegistry]
   [-StepName <String>]
   -TaskSequenceId <String>
   [-ValueType <RegistryValueType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-RegistryKey <String>]
   [-RegistryOperator <VariableOperatorType>]
   [-RegistryValueData <String>]
   [-RegistryValueName <String>]
   [-RootKey <RegistryRootKeyType>]
   [-SetConditionRegistry]
   [-StepName <String>]
   -TaskSequenceName <String>
   [-ValueType <RegistryValueType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-SetConditionOperatingSystem]
   [-StepName <String>]
   [-SupportedPlatform <IResultObject[]>]
   -TaskSequenceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTSStepRunPowerShellScript
   [-TimeoutMins <Int32>]
   [-UserName <String>]
   [-UserPassword <SecureString>]
   [-WorkingDirectory <String>]
   [-SetConditionOperatingSystem]
   [-StepName <String>]
   [-SupportedPlatform <IResultObject[]>]
   -TaskSequenceName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して 、PowerShell スクリプト の実行タスク シーケンス ステップのインスタンスを構成します。

この手順の詳細については、「タスク シーケンスの手順 について: PowerShell スクリプトの実行」を参照してください

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください

例 1

この例では、既定の OS展開タスク シーケンスの [PowerShellスクリプトの実行] ステップを変更して、既存のスクリプト ファイルの内容を使用します。

$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"

$scriptFile = "C:\Users\janed\scripts\Add-ContosoBrand.ps1"
$content = [IO.File]::ReadAllText( $scriptFile )

Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -SourceScript $content

パラメーター

-AddCondition

この手順に追加する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば 、Get-CMTSStepConditionVariable です

Type:IResultObject[]
Aliases:AddConditions
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ClearCondition

この手順から条件を削除します。 削除する 条件を指定するには、-Condition パラメーターを使用します。

Type:SwitchParameter
Aliases:ClearConditions
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Condition

この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば 、Get-CMTSStepConditionVariable です

Type:IResultObject[]
Aliases:SubCondition, SubConditions
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ConditionVariableName

条件として使用するタスク シーケンス変数の名前を指定します。

Type:String
Aliases:Variable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ConditionVariableValue

条件で使用するタスク シーケンス変数の値を指定します。

Type:String
Aliases:Value
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

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

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

このタスク シーケンス ステップのオプションの説明を指定します。

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

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

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

コンピューターで実行を許可するスクリプトの PowerShell 実行ポリシーを指定します。 次のいずれかのポリシーを選択します。

  • AllSigned: 信頼できる発行元によって署名されたスクリプトのみを実行します。

  • Undefined: 実行ポリシーを定義しません。

  • Bypass: すべての構成ファイルを読み込み、すべてのスクリプトを実行します。 署名されていないスクリプトをインターネットからダウンロードした場合、PowerShell はスクリプトを実行する前にアクセス許可を求めされません。

Type:ExecutionPolicyType
Aliases:PowerShellExecutionPolicy
Accepted values:AllSigned, Undefined, Bypass
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FileDateTimeOperator

ファイルの日付/時刻条件の変数演算子の種類を指定します。

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FilePath

ファイル条件のパスを指定します。

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

ファイル条件に使用する日付/時刻の値を指定します。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FileVersion

ファイル条件のバージョン文字列を指定します。

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

フォルダーの日付/時刻条件の変数演算子を指定します。

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FolderPath

フォルダー条件のパスを指定します。

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

フォルダー条件に使用する日付/時刻の値を指定します。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない

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

PowerShell スクリプトの実行手順を取得するタスク シーケンス オブジェクトを指定 します。 このオブジェクトを取得するには 、Get-CMTaskSequence コマンドレットを使用 します。

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

このパラメーターを SetConditionSoftware パラメーターと一緒に使用して、製品の任意のバージョンに一致します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IsContinueOnError

このパラメーターを使用して、エラー時にステップ オプション [続行] を有効にします。 このオプションを有効にすると、手順が失敗した場合、タスク シーケンスは続行されます。

Type:Boolean
Aliases:IsThisStepContinueOnError
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IsEnabled

このタスク シーケンス 手順を有効にするには、このパラメーターを使用します。

Type:Boolean
Aliases:IsThisStepEnabled
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MoveToIndex

この手順をタスク シーケンス内の指定したインデックス位置に移動します。

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MsiFilePath

ソフトウェア条件に合Windowsインストーラー ファイルへのパスを指定します。

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

WMI クエリ条件の名前空間を指定します。

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

このパラメーターを使用して、このタスク シーケンス ステップの名前を変更します。

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

タスク シーケンス変数の条件で使用する演算子を指定します。

Type:VariableOperatorType
Accepted values:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OutputVariableName

カスタム タスク シーケンス変数の名前を指定します。 このパラメーターを使用すると、コマンド出力の最後の 1000 文字が変数に保存されます。

Type:String
Aliases:Output, OutputVariable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PackageId

PowerShell スクリプトを持 つパッケージのパッケージ ID を指定します。 パッケージにはプログラムは必要ない。 1 つのパッケージに複数のスクリプトを含めできます。

この値は、たとえば、標準パッケージ ID です XYZ00821

次に 、ScriptName パラメーターを使用してスクリプトの名前を指定します。

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

PowerShell スクリプトに渡されるパラメーターを指定します。 これらのパラメーターは、コマンド ラインの PowerShell スクリプト パラメーターと同じです。 PowerShell コマンド ラインではなく、スクリプトで使用されるパラメーターを指定します。

次の例には、有効な パラメーターが含 まれています。

-MyParameter1 MyValue1 -MyParameter2 MyValue2

次の例には、無効な パラメーターが含 まれています。 最初の 2 つの項目は、PowerShell コマンド ライン パラメーター (NoLogo および ExecutionPolicy) です。 スクリプトは、これらのパラメーターを使用しない。

-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2

パラメーター値に特殊文字またはスペースが含まれている場合は、値の周囲に単一引用符 ( ' ) を使用します。 二重引用符 ( ) を使用 " すると、タスク シーケンス ステップでパラメーターが正しく処理されない可能性があります。

例: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'

また、このパラメーターをタスク シーケンス変数に設定することもできます。 たとえば、タスク シーケンスでスクリプトを実行するときに、このカスタム変数の値を PowerShell コマンド ラインに %MyScriptVariable% 追加します。

Type:String
Aliases:Parameters
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Query

条件に使用する WMI クエリ文字列を指定します。

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

レジストリ条件で使用するキーを指定します。

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

レジストリ条件で使用する演算子を指定します。

Type:VariableOperatorType
Accepted values:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RegistryValueData

レジストリ条件で使用する値データを指定します。

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

レジストリ条件で使用する値の名前を指定します。

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

ファイル条件を削除するには、このパラメーターを使用します。

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

フォルダー条件を削除するには、このパラメーターを使用します。

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

ステートメント条件を削除するには、この if パラメーターを使用します。

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

OS 条件を削除するには、このパラメーターを使用します。

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

WMI クエリ条件を削除するには、このパラメーターを使用します。

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

レジストリ条件を削除するには、このパラメーターを使用します。

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

ソフトウェア条件を削除するには、このパラメーターを使用します。

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

タスク シーケンス変数の条件を削除するには、このパラメーターを使用します。

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

レジストリ条件で使用するルート キーを指定します。

Type:RegistryRootKeyType
Accepted values:HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScriptName

実行するスクリプトの名前を指定します。 このスクリプトは 、PackageId パラメーターで指定されたパッケージ内に含まれています。

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

新しいファイル条件を追加します。

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

新しいフォルダー条件を追加します。

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

新しいステートメント if 条件を追加します。

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

新しい OS 条件を追加します。

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

新しい WMI クエリ条件を追加します。

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

新しいレジストリ条件を追加します。

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

新しいソフトウェア条件を追加します。

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

新しいタスク シーケンス変数条件を追加します。

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

PackageIdパラメーターとScriptNameパラメーターを使用する代わりに、このパラメーターを使用してスクリプト コマンドを直接指定します。 この文字列値は、この手順を実行する PowerShell コマンドです。

既存のスクリプト ファイルの内容を文字列変数に読み取り、その変数をこのパラメーターに使用できます。 例:

$script = [IO.File]::ReadAllText( "C:\temp\script.ps1" )

Type:String
Aliases:SourceCode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StatementType

ステートメント条件の型 if を設定します。

Type:ConditionStatementType
Aliases:Operator
Accepted values:All, Any, None
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StepName

変更を選択する手順の名前を指定します。

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

このパラメーターを使用して、タスク シーケンスの手順を並べ替えます。

Type:ReorderType
Accepted values:MoveUp, MoveDown, MoveToIndex
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SuccessCode

ステップが成功と評価するスクリプトからの終了コードとして整数値の配列を指定します。

Type:Int32[]
Aliases:SuccessCodes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SupportedPlatform

OS 条件のプラットフォームを指定するには、このパラメーターを使用します。

Type:IResultObject[]
Aliases:SupportedPlatforms
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TaskSequenceId

PowerShell スクリプトの実行 手順を取得するタスク シーケンスのパッケージ ID を指定 します。 この値は、たとえば、標準パッケージ ID です XYZ00858

Type:String
Aliases:Id, TaskSequencePackageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TaskSequenceName

変更の対象となるタスク シーケンスの名前を指定します。

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

Configuration Manager でスクリプトを実行できる時間を表す整数値を指定します。 この値は、分 1 から分まで 999 指定できます。 既定値は分 15 です。

指定したスクリプトが正常に完了するのに十分な時間を許可しない値を入力すると、この手順は失敗します。 手順またはグループの条件によっては、タスク シーケンス全体が失敗する可能性があります。 タイムアウトが期限切れになると、Configuration Manager は PowerShell プロセスを終了します。

Type:Int32
Aliases:TimeoutInMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserName

このパラメーターを使用して、ローカル システム アカウントではなくWindowsユーザー アカウントとしてスクリプトを実行します。 ユーザー アカウントの名前をWindowsします。 アカウントのパスワードを指定するには 、UserPassword パラメーターを使用 します。

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

UserName で指定するアカウントのパスワードを指定するには、このパラメーター を使用します

Type:SecureString
Aliases:Password
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ValueType

レジストリ条件の値の種類を指定します。

Type:RegistryValueType
Accepted values:RegistrySZ, RegistryExpandSZ, RegistryDWord
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VersionOperator

ファイル条件で使用する演算子を指定します。

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

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

コマンドを開始するフォルダーを指定します。 このパスには最大 127 文字を指定できます。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object