次の方法で共有

Get-CMTSStepRestoreUserState

  • リファレンス
モジュール:
ConfigurationManager

特定のタスク シーケンスから [ユーザー状態の復元] ステップを取得します。

構文

Get-CMTSStepRestoreUserState
   [-InputObject] <IResultObject>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-CMTSStepRestoreUserState
   [-TaskSequenceId] <String>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-CMTSStepRestoreUserState
   [-TaskSequenceName] <String>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、 ユーザー状態の復元 ステップの 1 つ以上のインスタンスのタスク シーケンス ステップ オブジェクトを取得します。 このオブジェクトを使用すると、次のことができます。

この手順の詳細については、「 タスク シーケンスの手順について: ユーザーの状態を復元する」を参照してください。

注:

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

例

例 1

この例では、最初に 、$tsOsd 変数内のタスク シーケンス オブジェクトを取得します。 次に、その変数を入力オブジェクトとして渡して、[ ユーザー状態の復元 ] ステップを取得します。

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsStepNameRestoreState = "Restore User State"
$tsStepRestoreState = Get-CMTSStepRestoreUserState -InputObject $tsOsd -StepName $tsStepNameRestoreState

パラメーター

-Confirm

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

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

-InputObject

[ユーザー状態の復元] ステップを取得するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを使用します。

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

-StepName

タスク シーケンスから取得する [ユーザー状態の復元] ステップの名前を指定します。

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

-TaskSequenceId

[ユーザー状態の復元] ステップを取得するタスク シーケンスのパッケージ ID を指定します。 この値は、 XYZ00858などの標準パッケージ ID です。

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

-TaskSequenceName

[ユーザー状態の復元] ステップを取得するタスク シーケンスの名前を指定します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object