{"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":"21/08/2026","updated_at_date_time":"2026-08-21T08:55:44.3165544Z"},"_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","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":"microsoft-endpoint-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-08-21 08:55 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtsstepcaptureuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepCaptureUserState","schemaType":"PowershellCmdlet","summary":"<p>Crie uma etapa de <strong>Captura do Estado do Usuário</strong>, que você 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 uma etapa de <strong>Captura do Estado do Usuário</strong>, que você pode adicionar a uma sequência de tarefas.</p>\n","uid":"ConfigurationManager.New-CMTSStepCaptureUserState"}},"description":"<p>Este cmdlet cria um novo objeto de etapa de <strong>Captura do Estado do Usuário</strong>. Em seguida, use o cmdlet <a href=\"add-cmtasksequencestep\">Add-CMTaskSequenceStep</a> para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, consulte <a href=\"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_CaptureUserState\">Sobre etapas de sequência de tarefas: Captura do estado do usuário</a>.</p>\n<div class=\"NOTE\">\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&gt;</code>. Para obter mais informações, consulte <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>Primeiro, esse exemplo obtém um objeto de pacote para a USMT (User State Migration Tool).\nA próxima linha cria um objeto para a etapa <strong>Capturar Estado do Usuário</strong>, que usa esse pacote da USMT e define várias configurações de etapa.\nEm seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à 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":"Sobre as etapas de sequência de tarefas: Captura do Estado do Usuário"}],"module":"ConfigurationManager","name":"New-CMTSStepCaptureUserState","notes":"<p>Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte <a href=\"/mem/configmgr/develop/reference/osd/sms_tasksequence_captureuserstateaction-server-wmi-class\">SMS_TaskSequence_CaptureUserStateAction classe WMI do 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 ser usado nesta etapa. Para obter esse objeto, use um dos cmdlets de 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>Ao especificar <code>-ModeOption Customize</code> a personalização de como os perfis de usuário são capturados, use esse parâmetro para especificar os nomes de arquivo dos arquivos de configuração XML personalizados. Esses arquivos precisam 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 habilitar a opção de etapa <strong>Continuar com erro</strong>. Quando você habilitar essa opção, se a etapa 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>Ao especificar <code>-FileAccessOption Normal</code>, defina esse parâmetro como <code>$true</code> para permitir que a USMT continue se alguns arquivos não puderem ser capturados.</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 essa etapa da 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 esse parâmetro para desabilitar essa etapa 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>Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você 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 de como a USMT acessa o sistema de arquivos:</p>\n<ul>\n<li><p>\n              <code>Normal</code>: A USMT usa acesso padrão ao sistema de arquivos. Ao especificar essa opção, você também pode habilitar <strong>ContinueOnLockedFile</strong>, <strong>OfflineUserState</strong> e <strong>-</strong>.</p>\n</li>\n<li><p>\n              <code>VolumeCopyShadowService</code>: a USMT usa o Serviço de 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>Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 a USMT pode operar:</p>\n<ul>\n<li><p>\n              <code>Standard</code>: Capture todos os perfis de usuário usando opções padrão. Esta é a opção padrão.</p>\n</li>\n<li><p>\n              <code>Customize</code>: personalize como os perfis de usuário são capturados. Se você especificar essa opção, use o parâmetro <strong>ConfigFile</strong> para especificar os arquivos 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 esta etapa para identificá-la 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>Ao especificar <code>-FileAccessOption Normal</code>, defina esse parâmetro como <code>$true</code> para 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 da USMT. Para obter esse objeto, use 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 esse parâmetro como <code>$true</code> para ignorar arquivos que usam o sistema de arquivos com criptografia (EFS).</p>\n","name":"SkipEncryptedFile","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Ao especificar <code>-FileAccessOption Normal</code>, defina esse parâmetro como <code>$true</code> para capturar localmente usando links físicos NTFS.</p>\n","name":"UseHardLinks","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para habilitar o registro em log detalhado da 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 uma etapa de <strong>Captura do Estado do Usuário</strong>, que você 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 uma etapa de <strong>Captura do Estado do Usuário</strong>, que você 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 etapa de <strong>Captura do Estado do Usuário</strong>. Em seguida, use o cmdlet <a href=&quot;add-cmtasksequencestep&quot;>Add-CMTaskSequenceStep</a> para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, consulte <a href=&quot;/mem/configmgr/osd/understand/task-sequence-steps#BKMK_CaptureUserState&quot;>Sobre etapas de sequência de tarefas: Captura do estado do usuário</a>.</p>\n<div class=&quot;NOTE&quot;>\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&amp;gt;</code>. Para obter mais informações, consulte <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 esse objeto de retorno e suas propriedades, consulte <a href=&quot;/mem/configmgr/develop/reference/osd/sms_tasksequence_captureuserstateaction-server-wmi-class&quot;>SMS_TaskSequence_CaptureUserStateAction classe WMI do servidor</a>.</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Crie uma etapa de <strong>Captura do Estado do Usuário</strong>, que você 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/"}