{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/ja-jp/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"}],"update_at":"2026/06/25","updated_at_date_time":"2026-06-25T23:35:21.9248594Z"},"_path":"module/configurationmanager/new-cmtsstepcaptureuserstate.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/New-CMTSStepCaptureUserState.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","document_id":"f32fc1ce-9695-ce8a-e15e-205a1e7dff3b","document_version_independent_id":"6a9bd9b4-85c1-cb03-7749-f657a25f053c","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"62e555aa39764a14ca841753bfe1cb32f721e6b3","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/62e555aa39764a14ca841753bfe1cb32f721e6b3/sccm-ps/ConfigurationManager/New-CMTSStepCaptureUserState.md","github_contributors":["aczechowski"],"locale":"ja-jp","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"08/12/2021","ms.service":"configuration-manager","ms.subservice":"other","ms.topic":"reference","online version":"","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/New-CMTSStepCaptureUserState.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/New-CMTSStepCaptureUserState.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-06-25 11:35 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepCaptureUserState","schemaType":"PowershellCmdlet","summary":"<p>タスク シーケンスに追加できる <strong>[ユーザー状態のキャプチャ</strong> ] ステップを作成します。</p>\n","uid":"ConfigurationManager.New-CMTSStepCaptureUserState"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMTSStepCaptureUserState":{"href":"new-cmtsstepcaptureuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepCaptureUserState","schemaType":"PowershellCmdlet","summary":"<p>タスク シーケンスに追加できる <strong>[ユーザー状態のキャプチャ</strong> ] ステップを作成します。</p>\n","uid":"ConfigurationManager.New-CMTSStepCaptureUserState"}},"description":"<p>このコマンドレットは、新しい <strong>[ユーザー状態のキャプチャ]</strong> ステップ オブジェクトを作成します。 次に、 <a href=\"add-cmtasksequencestep\">Add-CMTaskSequenceStep</a> コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 <a href=\"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_CaptureUserState\">タスク シーケンスの手順について: ユーザーの状態をキャプチャする</a>」を参照してください。</p>\n<div class=\"NOTE\">\n<p>注:</p>\n<p>\n              <code>PS XYZ:\\&gt;</code>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の <a href=\"/powershell/sccm/overview\">開始</a>」を参照してください。</p>\n</div>\n","examples":[{"code":"$pkgUsmt = Get-CMPackage -Name \"User State Migration Tool for Windows\" -Fast\n\n$step = New-CMTSStepCaptureUserState -Name \"Capture User State\" -Package $pkgUsmt -ModeOption Standard -VerboseLogging $true -FileAccessOption Normal -ContinueOnLockedFile $true -UseHardLinks $true\n\n$tsNameOsd = \"Default OS deployment\"\n$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast\n\n$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11","description":"","summary":"<p>この例では、まずユーザー状態移行ツール (USMT) のパッケージ オブジェクトを取得します。\n次の行では、その USMT パッケージを使用していくつかのステップ設定を構成する、 <strong>ユーザー状態のキャプチャ</strong> ステップのオブジェクトを作成します。\n次に、タスク シーケンス オブジェクトを取得し、インデックス 11 のタスク シーケンスにこの新しいステップを追加します。</p>\n","title":"例 1"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">None</span>\n"}],"links":[{"href":"get-cmtsstepcaptureuserstate","text":"Get-CMTSStepCaptureUserState"},{"href":"remove-cmtsstepcaptureuserstate","text":"Remove-CMTSStepCaptureUserState"},{"href":"set-cmtsstepcaptureuserstate","text":"Set-CMTSStepCaptureUserState"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_CaptureUserState","text":"タスク シーケンスの手順について: ユーザーの状態をキャプチャする"}],"module":"ConfigurationManager","name":"New-CMTSStepCaptureUserState","notes":"<p>この戻りオブジェクトとそのプロパティの詳細については、「 <a href=\"/mem/configmgr/develop/reference/osd/sms_tasksequence_captureuserstateaction-server-wmi-class\">サーバー WMI クラスSMS_TaskSequence_CaptureUserStateAction</a>」を参照してください。</p>\n","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"aliases":"Conditions","defaultValue":"None","description":"<p>この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば、 <a href=\"get-cmtsstepconditionvariable\">Get-CMTSStepConditionVariable です</a>。</p>\n","name":"Condition","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">IResultObject</span><span>[</span><span>]</span></p>\n"},{"aliases":"ConfigFiles","defaultValue":"None","description":"<p>ユーザー プロファイルのキャプチャ方法をカスタマイズする <code>-ModeOption Customize</code> を指定する場合は、このパラメーターを使用して、カスタム XML 構成ファイルのファイル名を指定します。 これらのファイルは USMT パッケージに含まれている必要があります。</p>\n","name":"ConfigFile","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"cf","defaultValue":"None","description":"<p>コマンドレットを実行する前に確認メッセージを表示します。</p>\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>このパラメーターを追加して、ステップ オプション [ <strong>エラー時に続行] を</strong>有効にします。 このオプションを有効にすると、ステップが失敗した場合、タスク シーケンスは続行されます。</p>\n","name":"ContinueOnError","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>\n              <code>-FileAccessOption Normal</code>を指定するときは、このパラメーターを <code>$true</code> に設定して、一部のファイルをキャプチャできない場合に USMT を続行できるようにします。</p>\n","name":"ContinueOnLockedFile","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>このタスク シーケンス ステップの説明 (省略可能) を指定します。</p>\n","name":"Description","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"DisableThisStep","defaultValue":"None","description":"<p>このタスク シーケンス ステップを無効にするには、このパラメーターを追加します。</p>\n","name":"Disable","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 \n              <strong>ForceWildcardHandling</strong> と組み合わせることはできません。</p>\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>USMT がファイル システムにアクセスする方法には、次の 2 つのオプションがあります。</p>\n<ul>\n<li><p>\n              <code>Normal</code>: USMT では、標準のファイル システム アクセスが使用されます。 このオプションを指定すると、 <strong>ContinueOnLockedFile</strong>、 <strong>OfflineUserState</strong>、および <strong>-</strong>を有効にすることもできます。</p>\n</li>\n<li><p>\n              <code>VolumeCopyShadowService</code>: USMT では、ボリューム コピー シャドウ サービス (VSS) を使用します。</p>\n</li>\n</ul>\n","name":"FileAccessOption","parameterValueGroup":"Normal, VolumeCopyShadowService","position":"Named","type":"<span class=\"no-loc xref\">FileAccessType</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 \n              <strong>DisableWildcardHandling</strong> と組み合わせることはできません。</p>\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>USMT が動作できるモードは 2 つあります。</p>\n<ul>\n<li><p>\n              <code>Standard</code>: 標準オプションを使用して、すべてのユーザー プロファイルをキャプチャします。 このオプションが既定値です。</p>\n</li>\n<li><p>\n              <code>Customize</code>: ユーザー プロファイルのキャプチャ方法をカスタマイズします。 このオプションを指定する場合は、 <strong>ConfigFile</strong> パラメーターを使用してカスタム XML 構成ファイルを指定します。</p>\n</li>\n</ul>\n","name":"ModeOption","parameterValueGroup":"Standard, Customize","position":"Named","type":"<span class=\"no-loc xref\">ModeType</span>\n"},{"aliases":"StepName","defaultValue":"None","description":"<p>この手順の名前を指定して、タスク シーケンスで識別します。</p>\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>\n              <code>-FileAccessOption Normal</code>を指定する場合は、このパラメーターを <code>$true</code> に設定して、Windows PE のオフライン モードでキャプチャします。</p>\n","name":"OfflineUserState","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"UserStateMigrationToolPackage","defaultValue":"None","description":"<p>USMT パッケージのオブジェクトを指定します。 このオブジェクトを取得するには、 <a href=\"get-cmpackage\">Get-CMPackage</a> コマンドレットを使用します。</p>\n","isRequired":true,"name":"Package","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">IResultObject</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>暗号化ファイル システム (EFS) を使用するファイルをスキップするには、このパラメーターを <code>$true</code> に設定します。</p>\n","name":"SkipEncryptedFile","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>\n              <code>-FileAccessOption Normal</code>を指定する場合は、NTFS ハード リンクを使用してローカルにキャプチャするには、このパラメーターを <code>$true</code> に設定します。</p>\n","name":"UseHardLinks","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>USMT 詳細ログを有効にするには、このパラメーターを <code>$true</code> に設定します。</p>\n","name":"VerboseLogging","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"wi","defaultValue":"None","description":"<p>コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。</p>\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>タスク シーケンスに追加できる <strong>[ユーザー状態のキャプチャ</strong> ] ステップを作成します。</p>\n","syntaxes":["New-CMTSStepCaptureUserState [-ConfigFile <String[]>] [-ContinueOnLockedFile <Boolean>]\n [-FileAccessOption <FileAccessType>] [-ModeOption <ModeType>] [-OfflineUserState <Boolean>]\n -Package <IResultObject> [-SkipEncryptedFile <Boolean>] [-UseHardLinks <Boolean>] [-VerboseLogging <Boolean>]\n [-Condition <IResultObject[]>] [-ContinueOnError] [-Description <String>] [-Disable] -Name <String>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]"],"uid":"ConfigurationManager.New-CMTSStepCaptureUserState","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"ja-jp","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMTSStepCaptureUserState.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepCaptureUserState","schemaType":"PowershellCmdlet","summary":"<p>タスク シーケンスに追加できる <strong>[ユーザー状態のキャプチャ</strong> ] ステップを作成します。</p>\n","uid":"ConfigurationManager.New-CMTSStepCaptureUserState"}],"canonical_url":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ja-jp/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>このコマンドレットは、新しい <strong>[ユーザー状態のキャプチャ]</strong> ステップ オブジェクトを作成します。 次に、 <a href=&quot;add-cmtasksequencestep&quot;>Add-CMTaskSequenceStep</a> コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 <a href=&quot;/mem/configmgr/osd/understand/task-sequence-steps#BKMK_CaptureUserState&quot;>タスク シーケンスの手順について: ユーザーの状態をキャプチャする</a>」を参照してください。</p>\n<div class=&quot;NOTE&quot;>\n<p>注:</p>\n<p>\n              <code>PS XYZ:\\&amp;gt;</code>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の <a href=&quot;/powershell/sccm/overview&quot;>開始</a>」を参照してください。</p>\n</div>\n\" />\r\n<meta name=\"hideEdit\" content=\"true\" />\r\n<meta name=\"loc_file_id\" content=\"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMTSStepCaptureUserState.md\" />\r\n<meta name=\"loc_source_id\" content=\"Github-72476255#live\" />\r\n<meta name=\"loc_version\" content=\"2024-08-21T21:18:36.7205003Z\" />\r\n<meta name=\"module\" content=\"ConfigurationManager\" />\r\n<meta name=\"ms.contentlocale\" content=\"ja-jp\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"New-CMTSStepCaptureUserState\" />\r\n<meta name=\"notes\" content=\"<p>この戻りオブジェクトとそのプロパティの詳細については、「 <a href=&quot;/mem/configmgr/develop/reference/osd/sms_tasksequence_captureuserstateaction-server-wmi-class&quot;>サーバー WMI クラスSMS_TaskSequence_CaptureUserStateAction</a>」を参照してください。</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>タスク シーケンスに追加できる <strong>[ユーザー状態のキャプチャ</strong> ] ステップを作成します。</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSStepCaptureUserState [-ConfigFile <String[]>] [-ContinueOnLockedFile <Boolean>]\n [-FileAccessOption <FileAccessType>] [-ModeOption <ModeType>] [-OfflineUserState <Boolean>]\n -Package <IResultObject> [-SkipEncryptedFile <Boolean>] [-UseHardLinks <Boolean>] [-VerboseLogging <Boolean>]\n [-Condition <IResultObject[]>] [-ContinueOnError] [-Description <String>] [-Disable] -Name <String>\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.New-CMTSStepCaptureUserState\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}