{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/pt-br/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":"25/06/2026","updated_at_date_time":"2026-06-25T23:35:17.5979476Z"},"_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/pt-br/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":"pt-br","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>Crie um passo <strong>Capturar Estado do Utilizador</strong> , que pode adicionar a uma sequência de tarefas.</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>Crie um passo <strong>Capturar Estado do Utilizador</strong> , que pode adicionar a uma sequência de tarefas.</p>\n","uid":"ConfigurationManager.New-CMTSStepCaptureUserState"}},"description":"<p>Este cmdlet cria um novo objeto de passo <strong>Capturar Estado do Utilizador</strong> . Em seguida, utilize o cmdlet <a href=\"add-cmtasksequencestep\">Add-CMTaskSequenceStep</a> para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja <a href=\"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_CaptureUserState\">Acerca dos passos de sequência de tarefas: Capturar Estado do Utilizador</a>.</p>\n<div class=\"NOTE\">\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo <code>PS XYZ:\\&gt;</code>. Para obter mais informações, veja <a href=\"/powershell/sccm/overview\">Introdução</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>Este exemplo obtém primeiro um objeto de pacote para a Ferramenta de Migração de Estado do Utilizador (USMT).\nA linha seguinte cria um objeto para o passo <strong>Capturar Estado do Utilizador</strong> , que utiliza esse pacote USMT e configura várias definições de passo.\nEm seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à sequência de tarefas no índice 11.</p>\n","title":"Exemplo 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":"Acerca dos passos de sequência de tarefas: Capturar Estado do Utilizador"}],"module":"ConfigurationManager","name":"New-CMTSStepCaptureUserState","notes":"<p>Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja <a href=\"/mem/configmgr/develop/reference/osd/sms_tasksequence_captureuserstateaction-server-wmi-class\">SMS_TaskSequence_CaptureUserStateAction classe WMI de servidor</a>.</p>\n","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"aliases":"Conditions","defaultValue":"None","description":"<p>Especifique um objeto de condição a utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da condição de sequência de tarefas. Por exemplo, <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>Quando especificar <code>-ModeOption Customize</code> a forma como os perfis de utilizador são capturados, utilize este parâmetro para especificar os nomes de ficheiro dos ficheiros de configuração XML personalizados. Estes ficheiros têm de estar no pacote 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>Solicita a confirmação antes de executar o cmdlet.</p>\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Adicione este parâmetro para ativar a opção de passo <strong>Continuar com o erro</strong>. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.</p>\n","name":"ContinueOnError","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Quando especificar <code>-FileAccessOption Normal</code>, defina este parâmetro como para <code>$true</code> permitir que o USMT continue se não for possível capturar alguns ficheiros.</p>\n","name":"ContinueOnLockedFile","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique uma descrição opcional para este passo de sequência de tarefas.</p>\n","name":"Description","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"DisableThisStep","defaultValue":"None","description":"<p>Adicione este parâmetro para desativar este passo de sequência de tarefas.</p>\n","name":"Disable","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com <strong>ForceWildcardHandling</strong>.</p>\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Existem duas opções para a forma como a USMT acede ao sistema de ficheiros:</p>\n<ul>\n<li><p>\n              <code>Normal</code>: o USMT utiliza o acesso padrão ao sistema de ficheiros. Quando especificar esta opção, também pode ativar <strong>ContinueOnLockedFile</strong>, <strong>OfflineUserState</strong> e <strong>-</strong>.</p>\n</li>\n<li><p>\n              <code>VolumeCopyShadowService</code>: o USMT utiliza os Serviços Sombra de Cópia de Volume (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>Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com <strong>DisableWildcardHandling</strong>.</p>\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Existem dois modos nos quais o USMT pode operar:</p>\n<ul>\n<li><p>\n              <code>Standard</code>: capture todos os perfis de utilizador com as opções padrão. Esta é a opção padrão.</p>\n</li>\n<li><p>\n              <code>Customize</code>: personalize a forma como os perfis de utilizador são capturados. Se especificar esta opção, utilize o parâmetro <strong>ConfigFile</strong> para especificar os ficheiros de configuração XML personalizados.</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>Especifique um nome para este passo para identificá-lo na sequência de tarefas.</p>\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Quando especificar <code>-FileAccessOption Normal</code>, defina este parâmetro como para <code>$true</code> capturar no modo offline no Windows PE.</p>\n","name":"OfflineUserState","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"UserStateMigrationToolPackage","defaultValue":"None","description":"<p>Especifique um objeto para o pacote USMT. Para obter este objeto, utilize o cmdlet <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>Defina este parâmetro como <code>$true</code> para ignorar ficheiros que utilizam o sistema de ficheiros de encriptação (EFS).</p>\n","name":"SkipEncryptedFile","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Quando especificar <code>-FileAccessOption Normal</code>, defina este parâmetro para <code>$true</code> capturar localmente através de ligações fixas NTFS.</p>\n","name":"UseHardLinks","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina este parâmetro como para <code>$true</code> ativar o registo verboso USMT.</p>\n","name":"VerboseLogging","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"wi","defaultValue":"None","description":"<p>Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.</p>\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>Crie um passo <strong>Capturar Estado do Utilizador</strong> , que pode adicionar a uma sequência de tarefas.</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":"pt-br","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>Crie um passo <strong>Capturar Estado do Utilizador</strong> , que pode adicionar a uma sequência de tarefas.</p>\n","uid":"ConfigurationManager.New-CMTSStepCaptureUserState"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>Este cmdlet cria um novo objeto de passo <strong>Capturar Estado do Utilizador</strong> . Em seguida, utilize o cmdlet <a href=&quot;add-cmtasksequencestep&quot;>Add-CMTaskSequenceStep</a> para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja <a href=&quot;/mem/configmgr/osd/understand/task-sequence-steps#BKMK_CaptureUserState&quot;>Acerca dos passos de sequência de tarefas: Capturar Estado do Utilizador</a>.</p>\n<div class=&quot;NOTE&quot;>\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo <code>PS XYZ:\\&amp;gt;</code>. Para obter mais informações, veja <a href=&quot;/powershell/sccm/overview&quot;>Introdução</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=\"pt-br\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"New-CMTSStepCaptureUserState\" />\r\n<meta name=\"notes\" content=\"<p>Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja <a href=&quot;/mem/configmgr/develop/reference/osd/sms_tasksequence_captureuserstateaction-server-wmi-class&quot;>SMS_TaskSequence_CaptureUserStateAction classe WMI de servidor</a>.</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Crie um passo <strong>Capturar Estado do Utilizador</strong> , que pode adicionar a uma sequência de tarefas.</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/"}