{"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:37:30.0420491Z"},"_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","document_id":"db8f9b33-7231-286a-2568-36a216f452b0","document_version_independent_id":"d25d6878-f6de-569e-3a98-e9b3a894273d","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":"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-06-25 11:37 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmtssteprestoreuserstate","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepRestoreUserState","schemaType":"PowershellCmdlet","summary":"<p>Crie um passo <strong>Restaurar Estado do Utilizador</strong> , que 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 um passo <strong>Restaurar Estado do Utilizador</strong> , que pode adicionar a uma sequência de tarefas.</p>\n","uid":"ConfigurationManager.New-CMTSStepRestoreUserState"}},"description":"<p>Este cmdlet cria um novo objeto <strong>de passo Restaurar 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_RestoreUserState\">About task sequence steps: Restore User State (Sobre os passos da sequência de tarefas: Restaurar o 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-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>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>Restaurar 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-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":"Acerca dos passos de sequência de tarefas: Restaurar o Estado do Utilizador"}],"module":"ConfigurationManager","name":"New-CMTSStepRestoreUserState","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_restoreuserstateaction-server-wmi-class\">SMS_TaskSequence_RestoreUserStateAction 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> para personalizar a forma como os perfis de utilizador são restaurados, 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>Defina este parâmetro como para <code>$true</code> continuar a restaurar o estado e as definições do utilizador, mesmo que o USMT não consiga restaurar alguns ficheiros.</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 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>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>: restaure todos os perfis de utilizador capturados com 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 restaurados. 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":"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":"NewPasswordForLocalAccount","defaultValue":"None","description":"<p>Se ativar o parâmetro <strong>RestoreLocalAccount</strong> , utilize este parâmetro para atribuir uma nova palavra-passe às contas de utilizador locais restauradas. O USMT não consegue migrar as palavras-passe originais. Especifique uma cadeia segura para a palavra-passe 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 este parâmetro como <code>$true</code> para restaurar perfis de utilizador do computador local. Estes perfis não são para utilizadores de domínio. O USMT não consegue migrar as palavras-passe originais. Para atribuir novas palavras-passe às contas de utilizador locais restauradas, utilize o parâmetro <strong>Palavra-passe</strong> .</p>\n","name":"RestoreLocalAccount","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>Restaurar Estado do Utilizador</strong> , que 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 um passo <strong>Restaurar Estado do Utilizador</strong> , que 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 <strong>de passo Restaurar 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_RestoreUserState&quot;>About task sequence steps: Restore User State (Sobre os passos da sequência de tarefas: Restaurar o 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-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 este objeto de retorno e as respetivas propriedades, veja <a href=&quot;/mem/configmgr/develop/reference/osd/sms_tasksequence_restoreuserstateaction-server-wmi-class&quot;>SMS_TaskSequence_RestoreUserStateAction 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>Restaurar Estado do Utilizador</strong> , que 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/"}