{"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:50:55.3216134Z"},"_path":"module/configurationmanager/new-cmtssteprestoreuserstate.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-cmtssteprestoreuserstate?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/New-CMTSStepRestoreUserState.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-CMTSStepRestoreUserState.md","github_contributors":["aczechowski"],"locale":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"08/13/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-CMTSStepRestoreUserState.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/New-CMTSStepRestoreUserState.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:50 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtssteprestoreuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepRestoreUserState","schemaType":"PowershellCmdlet","summary":"<p>Crie uma etapa <strong>Restaurar Estado do Usuário</strong> , que você pode adicionar a uma sequência de tarefas.</p>\n","uid":"ConfigurationManager.New-CMTSStepRestoreUserState"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMTSStepRestoreUserState":{"href":"new-cmtssteprestoreuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepRestoreUserState","schemaType":"PowershellCmdlet","summary":"<p>Crie uma etapa <strong>Restaurar Estado do Usuário</strong> , que você pode adicionar a uma sequência de tarefas.</p>\n","uid":"ConfigurationManager.New-CMTSStepRestoreUserState"}},"description":"<p>Este cmdlet cria um novo objeto de etapa <strong>Restaurar 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 essa etapa, consulte <a href=\"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_RestoreUserState\">Sobre etapas de sequência de tarefas: Restaurar o 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-CMTSStepRestoreUserState -Name \"Restore User State\" -Package $pkgUsmt -ModeOption Standard -VerboseLogging $true -ContinueOnRestore $true -RestoreLocalAccount $false\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>Restaurar 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-cmtssteprestoreuserstate","text":"Get-CMTSStepRestoreUserState"},{"href":"remove-cmtssteprestoreuserstate","text":"Remove-CMTSStepRestoreUserState"},{"href":"set-cmtssteprestoreuserstate","text":"Set-CMTSStepRestoreUserState"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_RestoreUserState","text":"Sobre as etapas de sequência de tarefas: Restaurar o Estado do Usuário"}],"module":"ConfigurationManager","name":"New-CMTSStepRestoreUserState","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_restoreuserstateaction-server-wmi-class\">SMS_TaskSequence_RestoreUserStateAction 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 restaurados, 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>Defina esse parâmetro como <code>$true</code> para continuar restaurando o estado e as configurações do usuário, mesmo que a USMT não consiga restaurar alguns arquivos.</p>\n","name":"ContinueOnRestore","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>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>: restaure todos os perfis de usuário capturados com 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 restaurados. 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":"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":"NewPasswordForLocalAccount","defaultValue":"None","description":"<p>Se você habilitar o parâmetro <strong>RestoreLocalAccount</strong> , use esse parâmetro para atribuir uma nova senha às contas de usuário locais restauradas. A USMT não pode migrar as senhas originais. Especifique uma cadeia de caracteres segura para a senha da conta local.</p>\n","name":"Password","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SecureString</span>\n"},{"aliases":"RestoreLocalComputerUserProfile","defaultValue":"None","description":"<p>Defina esse parâmetro como <code>$true</code> para restaurar perfis de usuário do computador local. Esses perfis não são para usuários de domínio. A USMT não pode migrar as senhas originais. Para atribuir novas senhas às contas de usuário locais restauradas, use o parâmetro <strong>Password</strong> .</p>\n","name":"RestoreLocalAccount","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 <strong>Restaurar Estado do Usuário</strong> , que você pode adicionar a uma sequência de tarefas.</p>\n","syntaxes":["New-CMTSStepRestoreUserState [-ConfigFile <String[]>] [-ContinueOnRestore <Boolean>] [-ModeOption <ModeType>]\n -Package <IResultObject> [-Password <SecureString>] [-RestoreLocalAccount <Boolean>]\n [-VerboseLogging <Boolean>] [-Condition <IResultObject[]>] [-ContinueOnError] [-Description <String>]\n [-Disable] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]"],"uid":"ConfigurationManager.New-CMTSStepRestoreUserState","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-CMTSStepRestoreUserState.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtssteprestoreuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepRestoreUserState","schemaType":"PowershellCmdlet","summary":"<p>Crie uma etapa <strong>Restaurar Estado do Usuário</strong> , que você pode adicionar a uma sequência de tarefas.</p>\n","uid":"ConfigurationManager.New-CMTSStepRestoreUserState"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtssteprestoreuserstate?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtssteprestoreuserstate?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>Este cmdlet cria um novo objeto de etapa <strong>Restaurar 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 essa etapa, consulte <a href=&quot;/mem/configmgr/osd/understand/task-sequence-steps#BKMK_RestoreUserState&quot;>Sobre etapas de sequência de tarefas: Restaurar o 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-CMTSStepRestoreUserState.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-CMTSStepRestoreUserState\" />\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_restoreuserstateaction-server-wmi-class&quot;>SMS_TaskSequence_RestoreUserStateAction classe WMI do servidor</a>.</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Crie uma etapa <strong>Restaurar Estado do Usuário</strong> , que você pode adicionar a uma sequência de tarefas.</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"New-CMTSStepRestoreUserState [-ConfigFile <String[]>] [-ContinueOnRestore <Boolean>] [-ModeOption <ModeType>]\n -Package <IResultObject> [-Password <SecureString>] [-RestoreLocalAccount <Boolean>]\n [-VerboseLogging <Boolean>] [-Condition <IResultObject[]>] [-ContinueOnError] [-Description <String>]\n [-Disable] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.New-CMTSStepRestoreUserState\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}