{"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"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"26/06/2026","updated_at_date_time":"2026-06-26T00:10:11.8376254Z"},"_path":"module/configurationmanager/set-cmstatemigrationpoint.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/set-cmstatemigrationpoint?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/Set-CMStateMigrationPoint.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","description":"Modifica as definições de um ponto de migração de estado no Configuration Manager.","document_id":"ec1eb74b-4122-923c-dfd7-46f0eef10958","document_version_independent_id":"1cc90fd2-ada4-4de6-740c-29875a61cccf","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":"48cf632fb4b9ad92060012681a500478254de750","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/48cf632fb4b9ad92060012681a500478254de750/sccm-ps/ConfigurationManager/Set-CMStateMigrationPoint.md","github_contributors":["aczechowski","damabe","sankethka"],"locale":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"05/07/2019","ms.service":"configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/Set-CMStateMigrationPoint.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/Set-CMStateMigrationPoint.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"Set-CMStateMigrationPoint","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-06-26 12:10 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/set-cmstatemigrationpoint","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMStateMigrationPoint","schemaType":"PowershellCmdlet","summary":"<p>Modifica as definições de um ponto de migração de estado no Configuration Manager.</p>\n","uid":"ConfigurationManager.Set-CMStateMigrationPoint"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMStateMigrationPoint":{"href":"set-cmstatemigrationpoint","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMStateMigrationPoint","schemaType":"PowershellCmdlet","summary":"<p>Modifica as definições de um ponto de migração de estado no Configuration Manager.</p>\n","uid":"ConfigurationManager.Set-CMStateMigrationPoint"}},"description":"<p>O cmdlet <strong>Set-CMStateMigrationPoint</strong> modifica as definições para um ponto de migração de estado no Configuration Manager.\nUm ponto de migração de estado é uma função do sistema de sites que gere a transferência de dados de computadores cliente durante um processo de instalação do sistema operativo.\nUtilize este cmdlet para modificar os grupos de limites e as pastas de armazenamento associadas ao ponto de migração, quanto tempo esperar até que o ponto de migração elimine os dados do cliente, se pretende permitir uma localização de origem de contingência para o conteúdo e se pretende ativar o modo apenas de restauro.</p>\n<p>Pode especificar o ponto de migração a modificar com o nome do servidor do sistema de sites e o código do site ou utilizar o cmdlet <a href=\"get-cmstatemigrationpoint\">Get-CMStateMigrationPoint</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":"PS XYZ:\\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode \"CM4\" -SiteSystemServerName \"MigrationServer.TSQA.Contoso.com\"\nPS XYZ:\\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours","description":"<p>Este exemplo modifica um ponto de migração com o nome MigrationServer.TSQA.Contoso.com para o site que tem o código CM4.\nO exemplo altera o ponto de migração para permitir uma localização de origem de contingência para o conteúdo e modifica quanto tempo após a transferência de dados para eliminar dados.</p>\n<p>O primeiro comando utiliza o cmdlet <strong>Get-CMStateMigrationPoint</strong> para obter um ponto de migração para o código do site especificado e o nome do servidor e armazena-o na variável $StateMigrationPoint.</p>\n<p>O segundo comando modifica o objeto de entrada armazenado na variável $StateMigrationPoint.\nO comando define o parâmetro <em>AllowFallbackSourceLocationForContent</em> para $True e modifica o tempo a eliminar após 12 horas.</p>\n","summary":"","title":"Exemplo 1: Modificar um ponto de migração de estado"},{"code":"PS XYZ:\\> $Storage01 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte -StorageFolderName \"C:\\\"\nPS XYZ:\\> $Storage02 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte -StorageFolderName \"D:\\\"\nPS XYZ:\\> Set-CMStateMigrationPoint -SiteCode \"CM4\" -SiteSystemServerName \"MigrationServer.TSQA.Contoso.com\" -AddBoundaryGroupName \"BG07\" -AddStorageFolder $Storage02 -AllowFallbackSourceLocationForContent $False -DeleteImmediately -EnableRestoreOnlyMode $True -RemoveBoundaryGroupName \"BG22\" -RemoveStorageFolder $Storage01","description":"<p>Este exemplo modifica as definições de um ponto de migração de estado com o nome MigrationServer.TSQA.Contoso.com para o site que tem o código do site CM4.\nO exemplo substitui um grupo de limites diferente e uma pasta de armazenamento diferente e modifica outras definições.</p>\n<p>O primeiro comando utiliza o cmdlet <strong>New-CMStoragefolder</strong> para criar um objeto de pasta de armazenamento e armazena-o na variável $Storage 01.\nConsulte a documentação desse cmdlet para obter mais informações.</p>\n<p>O segundo comando utiliza o cmdlet <strong>New-CMStoragefolder</strong> para criar um objeto de pasta de armazenamento e armazena-o na variável $Storage 02.</p>\n<p>O terceiro comando remove a pasta de armazenamento armazenada na variável $Storage 01 do ponto de migração e, no mesmo comando, adiciona a pasta de armazenamento armazenada na variável $Storage 02 ao ponto de migração.\nDa mesma forma, o comando remove o grupo de limites denominado BG22 e adiciona o grupo de limites denominado BG07.\nO comando também especifica um valor de $False para o parâmetro <em>AllowFallbackSourceLocationForContent</em> e um valor de $True para o parâmetro <em>EnableRestoreOnlyMode</em> .\nO comando utiliza o parâmetro <em>DeleteImmediately</em> ; por conseguinte, o ponto de migração elimina as informações do cliente imediatamente após a transferência.</p>\n","summary":"","title":"Exemplo 2: Modificar pastas de armazenamento e grupos de limites para um ponto de migração de estado"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">Microsoft.ConfigurationManagement.ManagementProvider.IResultObject</span>\n"}],"links":[{"href":"add-cmstatemigrationpoint","text":"Add-CMStateMigrationPoint"},{"href":"get-cmstatemigrationpoint","text":"Get-CMStateMigrationPoint"},{"href":"remove-cmstatemigrationpoint","text":"Remove-CMStateMigrationPoint"},{"href":"new-cmstoragefolder","text":"New-CMStoragefolder"}],"module":"ConfigurationManager","name":"Set-CMStateMigrationPoint","notes":"","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"<p>Especifica uma matriz de nomes de grupos de limites.\nO cmdlet adiciona estes grupos de limites ao ponto de migração de estado.\nDurante a migração, os clientes num grupo de limites utilizam este site como uma localização de origem para o conteúdo.</p>\n","name":"AddBoundaryGroupName","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifica uma matriz de pastas de armazenamento, como objetos de dados de diretório de armazenamento.\nO cmdlet adiciona estas pastas ao ponto de migração de estado.\nPara obter um objeto de dados de diretório de armazenamento, utilize o cmdlet <a href=\"new-cmstoragefolder\">New-CMStoragefolder</a> .</p>\n<p>Um ponto de migração de estado armazena dados de estado do utilizador quando migra um computador para um novo sistema operativo.</p>\n","name":"AddStorageFolder","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">StorageDirectoryData</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>Indica se está disponível uma localização de origem de contingência.</p>\n","name":"AllowFallbackSourceLocationForContent","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</span>\n"},{"aliases":"cf","defaultValue":"False","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>Indica que a eliminação de dados de cliente ocorre imediatamente após o computador de destino transferir esses dados.\nSe selecionar um valor de $False, especifique quanto tempo esperar com os parâmetros <em>TimeDeleteAfter</em> e <em>TimeUnit</em> .</p>\n","name":"DeleteImmediately","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>Indica se pretende ativar o modo apenas de restauro.\nNo modo apenas de restauro, o Configuration Manager recusa novos pedidos para armazenar dados de cliente.</p>\n","name":"EnableRestoreOnlyMode","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Boolean</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":"StateMigrationPoint","defaultValue":"None","description":"<p>Especifica um objeto de ponto de migração de estado.\nPara obter um objeto de ponto de migração de estado, utilize o cmdlet <a href=\"get-cmstatemigrationpoint\">Get-CMStateMigrationPoint</a> .</p>\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"<span class=\"no-loc xref\">IResultObject</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.</p>\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifica uma matriz de nomes de grupos de limites.\nO cmdlet remove estes grupos de limites do ponto de migração de estado.\nDurante a migração, os clientes num grupo de limites utilizam este site como uma localização de origem para o conteúdo.</p>\n","name":"RemoveBoundaryGroupName","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifica uma matriz de pastas de armazenamento, como objetos de dados de diretório de armazenamento.\nO cmdlet remove estas pastas do ponto de migração de estado.\nUm ponto de migração de estado armazena dados de estado do utilizador quando migra um computador para um novo sistema operativo.</p>\n","name":"RemoveStorageFolder","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">StorageDirectoryData</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifica o código do site para um site do Configuration Manager.</p>\n","name":"SiteCode","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"Name, ServerName","defaultValue":"None","description":"<p>Especifica o nome do anfitrião para um ponto de migração de estado.</p>\n","isRequired":true,"name":"SiteSystemServerName","parameterValueGroup":"","position":"0","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifica a quantidade de tempo a aguardar depois de o computador de destino transferir os dados para eliminar esses dados.\nEspecifique uma unidade de tempo com o parâmetro <em>TimeUnit</em> .\nPara eliminar dados imediatamente, especifique um valor de $True para o parâmetro <em>DeleteImmediately</em> .</p>\n","name":"TimeDeleteAfter","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">Int32</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifica uma unidade de tempo para o valor especificado no parâmetro <em>TimeDeleteAfter</em> .\nOs valores aceitáveis para este parâmetro são: Dias e Horas.</p>\n","name":"TimeUnit","parameterValueGroup":"Hours, Days","position":"Named","type":"<span class=\"no-loc xref\">IntervalType</span>\n"},{"aliases":"wi","defaultValue":"False","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>Modifica as definições de um ponto de migração de estado no Configuration Manager.</p>\n","syntaxes":["Set-CMStateMigrationPoint [-AddBoundaryGroupName <String[]>] [-AddStorageFolder <StorageDirectoryData[]>]\n [-AllowFallbackSourceLocationForContent <Boolean>] [-DeleteImmediately] [-EnableRestoreOnlyMode <Boolean>]\n -InputObject <IResultObject> [-PassThru] [-RemoveBoundaryGroupName <String[]>]\n [-RemoveStorageFolder <StorageDirectoryData[]>] [-TimeDeleteAfter <Int32>] [-TimeUnit <IntervalType>]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]","Set-CMStateMigrationPoint [-AddBoundaryGroupName <String[]>] [-AddStorageFolder <StorageDirectoryData[]>]\n [-AllowFallbackSourceLocationForContent <Boolean>] [-DeleteImmediately] [-EnableRestoreOnlyMode <Boolean>]\n [-PassThru] [-RemoveBoundaryGroupName <String[]>] [-RemoveStorageFolder <StorageDirectoryData[]>]\n [-SiteCode <String>] [-SiteSystemServerName] <String> [-TimeDeleteAfter <Int32>] [-TimeUnit <IntervalType>]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]"],"uid":"ConfigurationManager.Set-CMStateMigrationPoint","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/Set-CMStateMigrationPoint.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/set-cmstatemigrationpoint","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMStateMigrationPoint","schemaType":"PowershellCmdlet","summary":"<p>Modifica as definições de um ponto de migração de estado no Configuration Manager.</p>\n","uid":"ConfigurationManager.Set-CMStateMigrationPoint"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmstatemigrationpoint?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmstatemigrationpoint?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>O cmdlet <strong>Set-CMStateMigrationPoint</strong> modifica as definições para um ponto de migração de estado no Configuration Manager.\nUm ponto de migração de estado é uma função do sistema de sites que gere a transferência de dados de computadores cliente durante um processo de instalação do sistema operativo.\nUtilize este cmdlet para modificar os grupos de limites e as pastas de armazenamento associadas ao ponto de migração, quanto tempo esperar até que o ponto de migração elimine os dados do cliente, se pretende permitir uma localização de origem de contingência para o conteúdo e se pretende ativar o modo apenas de restauro.</p>\n<p>Pode especificar o ponto de migração a modificar com o nome do servidor do sistema de sites e o código do site ou utilizar o cmdlet <a href=&quot;get-cmstatemigrationpoint&quot;>Get-CMStateMigrationPoint</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/Set-CMStateMigrationPoint.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=\"Set-CMStateMigrationPoint\" />\r\n<meta name=\"notes\" content=\"\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Modifica as definições de um ponto de migração de estado no Configuration Manager.</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"Set-CMStateMigrationPoint [-AddBoundaryGroupName <String[]>] [-AddStorageFolder <StorageDirectoryData[]>]\n [-AllowFallbackSourceLocationForContent <Boolean>] [-DeleteImmediately] [-EnableRestoreOnlyMode <Boolean>]\n -InputObject <IResultObject> [-PassThru] [-RemoveBoundaryGroupName <String[]>]\n [-RemoveStorageFolder <StorageDirectoryData[]>] [-TimeDeleteAfter <Int32>] [-TimeUnit <IntervalType>]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Set-CMStateMigrationPoint [-AddBoundaryGroupName <String[]>] [-AddStorageFolder <StorageDirectoryData[]>]\n [-AllowFallbackSourceLocationForContent <Boolean>] [-DeleteImmediately] [-EnableRestoreOnlyMode <Boolean>]\n [-PassThru] [-RemoveBoundaryGroupName <String[]>] [-RemoveStorageFolder <StorageDirectoryData[]>]\n [-SiteCode <String>] [-SiteSystemServerName] <String> [-TimeDeleteAfter <Int32>] [-TimeUnit <IntervalType>]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.Set-CMStateMigrationPoint\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}