Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O LoadState.exe comando é usado com a USMT (User State Migration Tool) para restaurar um armazenamento capturado ScanState.exe anteriormente pelo comando em um computador de destino. Este artigo discute a sintaxe de LoadState.exe comando e as opções disponíveis com ele.
Antes de começar
Antes de executar o LoadState.exe comando, observe os seguintes itens:
Para garantir que todas as configurações do sistema operacional migrem, a Microsoft recomenda executar
LoadState.execomandos no modo de administrador de uma conta com credenciais administrativas.Para obter informações sobre os requisitos de software para executar o comando, consulte os requisitos da
LoadState.exeUSMT.Saia depois de executar o
LoadState.execomando. Algumas configurações, como por exemplo, fontes, papel de parede e configurações de proteção de tela, não entrarão em vigor até a próxima vez que o usuário fizer logon.A menos que especificado de outra forma, cada opção só pode ser usada uma vez ao executar uma ferramenta na linha de comando.
O LoadState não requer acesso ao controlador de domínio para aplicar perfis de domínio. Esta funcionalidade está disponível sem qualquer configuração adicional. Não é necessário que o computador de origem tenha acesso ao controlador de domínio quando o perfil do usuário foi coletado usando ScanState. No entanto, os perfis de domínio permanecem inacessíveis até que o computador de destino seja ingressado no domínio.
A tabela de opções de linha de comando incompatíveis lista quais opções podem ser usadas em conjunto e quais opções de linha de comando são incompatíveis.
Sintaxe
Esta seção explica a sintaxe e o uso das opções de linha de comando disponíveis ao usar o LoadState.exe comando. As opções podem ser especificadas em qualquer ordem. Se a opção contiver um parâmetro, um separador de dois-pontos ou de espaço poderá ser especificado.
A LoadState.exe sintaxe do comando é:
LoadState.exe StorePath [/i:[Path\]FileName] [/v:VerbosityLevel] [/nocompress] [/decrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[DomainName|:ComputerName\]UserName] [/ue:[[DomainName|:ComputerName\]Nome de usuário] [/uel:NumberOfDays|AAAA/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|ajuda]
Por exemplo, para descriptografar o armazenamento e migrar os arquivos e configurações para um computador, digite o seguinte comando:
LoadState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /v:13 /decrypt /key:"mykey"
Opções de armazenamento
A USMT fornece as seguintes opções que podem ser usadas para especificar como e onde os dados migrados são armazenados.
| Opção Command-Line | Descrição |
|---|---|
| StorePath | Indica a pasta onde os arquivos e os dados de configurações são armazenados.
StorePath deve ser especificado ao usar o LoadState.exe comando. Mais de um StorePath não pode ser especificado. |
|
/decrypt /key:KeyString or /decrypt /key:"Key String" or /decrypt /keyfile:[Path]FileName |
Descriptografa o armazenamento com a chave especificada. Com essa opção, a chave de criptografia precisa ser especificada de uma das seguintes maneiras:
KeyString não pode exceder 256 caracteres. As /key opções e /keyfile não podem ser usadas na mesma linha de comando.As /decrypt opções e /nocompress não podem ser usadas na mesma linha de comando.
Importante Tenha cuidado ao usar as /key opções ou keyfile . Por exemplo, qualquer pessoa que tenha acesso a scripts que executam o LoadState.exe comando com essas opções também terá acesso à chave de criptografia.Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
| /decrypt:"Força da criptografia" | A /decrypt opção aceita um parâmetro de linha de comando para definir a força de criptografia especificada para a criptografia do repositório de migração. Para obter mais informações sobre algoritmos de criptografia com suporte, consulte Criptografia do repositório de migração. |
| /hardlink | Permite que os dados de estado do usuário sejam restaurados de um repositório de migração de link rígido. O /nocompress parâmetro deve ser especificado com /hardlink opção. |
| /nocompress | Especifica que o repositório não é compactado. Essa opção só deve ser usada em ambientes de teste. A Microsoft recomenda o uso de um repositório compactado durante a migração real. Esta opção não pode ser usada com a /decrypt opção.Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
Opções de regra de migração
A USMT fornece as seguintes opções para especificar quais arquivos migrar.
| Opção Command-Line | Descrição |
|---|---|
| /i:[Caminho]Nome do arquivo |
(incluir) Especifica um arquivo .xml que contém regras que definem quais dados migrar. Essa opção pode ser especificada várias vezes para incluir todos os arquivos .xml ( MigApp.xml, MigSys.xmle MigDocs.xml quaisquer arquivos de.xml personalizados criados).
O caminho pode ser relativo ou completo. Se a variável Path não for especificada, FileName deverá estar localizado no diretório atual.Para obter mais informações sobre quais arquivos especificar, consulte a seção "Arquivos XML" do artigo de Perguntas frequentes . |
| /config:[Path]FileName | Especifica o Config.xml arquivo que o LoadState.exe comando deve usar. Essa opção não pode ser especificada mais de uma vez na linha de comando.
O caminho pode ser relativo ou completo. Se a variável Path não for especificada, o FileName deverá estar localizado no diretório atual.Este exemplo migra os arquivos e as configurações com base nas regras no , MigDocs.xml, Config.xmle MigApp.xml arquivos:LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log |
| /auto:"caminho para arquivos de script" | Essa opção permite especificar o local dos arquivos .xml padrão. Se nenhum caminho for especificado, a USMT usará o diretório onde os binários da USMT estão localizados. A /auto opção tem o mesmo efeito que usar as seguintes opções: /i:MigDocs.xml/i:MigApp.xml /v:5. |
Opções de monitoramento
A USMT fornece várias opções de linha de comando que podem ser usadas para analisar problemas que ocorrem durante a migração.
| Opção Command-Line | Descrição |
|---|---|
| /l:[Caminho]Nome_do_arquivo | Especifica o local e o nome do log LoadState . Os arquivos de log não podem ser armazenados em StorePath.
O caminho pode ser relativo ou completo. Se a variável Path não for especificada, o log será criado no diretório atual. A /v opção pode ser especificada para ajustar o detalhamento do log.Se estiver executando o LoadState.exe comando de um recurso de rede compartilhada, a l opção deverá ser especificada ou a USMT falhará com o erro:A USMT não pôde criar o(s) arquivo(s) de log Para corrigir esse problema, especifique a /l opção ao executar LoadState.exe de um recurso de rede compartilhado. |
/v:<VerbosityLevel> |
(Verbosidade) Habilita a saída detalhada no arquivo de log LoadState . O valor padrão é 0. O VerbosityLevel pode ser definido como um dos seguintes níveis:
Por exemplo: LoadState.exe \server\share\migration\mystore /v:5 /i:MigDocs.xml /i:MigApp.xml |
| /progress:[Path]FileName | Cria o log de progresso opcional. Os arquivos de log não podem ser armazenados em StorePath.
O caminho pode ser relativo ou completo. Se a variável Path não for especificada, FileName será criado no diretório atual. Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:loadlog.log |
| /c | Quando essa opção é especificada, o LoadState.exe comando continua a ser executado, mesmo que ocorram erros não fatais. Todos os arquivos ou configurações que causam um erro são registrados no log de progresso. Por exemplo, se houver um arquivo grande que não cabe no computador, o LoadState.exe comando registra um erro e continua com a migração. Sem a /c opção, o LoadState.exe comando sai no primeiro erro. A < seção ErrorControl> pode ser usada no Config.xml arquivo para especificar quais erros de leitura/gravação de arquivo ou registro podem ser ignorados com segurança e quais podem causar falha na migração. Esse controle de erro permite que a /c opção de linha de comando ignore com segurança todos os erros de entrada/saída (E/S) no ambiente. Além disso, a /genconfig opção agora gera uma seção ErrorControl> de amostra < que é habilitada ao especificar mensagens de erro e comportamentos desejados no Config.xml arquivo. |
/r:<TimesToRetry> |
(Tentar novamente) Especifica o número de vezes a ser repetido quando ocorrer um erro durante a migração do estado do usuário de um servidor. O padrão é três vezes. Essa opção é útil em ambientes em que a conectividade de rede não é confiável. Quando o estado do usuário está sendo restaurado, a /r opção não recupera os dados perdidos devido a uma falha de hardware de rede, como um cabo de rede defeituoso ou desconectado, ou quando uma conexão de rede virtual privada (VPN) falha. A opção de repetição destina-se a redes grandes e ocupadas em que a conectividade é satisfatória, mas a latência de comunicação é um problema. |
/w:<SecondsBeforeRetry> |
(Aguarde) Especifica o tempo de espera, em segundos, antes de repetir uma operação de arquivo de rede. O padrão é 1 segundo. |
| /? ou /help | Exibe a Ajuda na linha de comando. |
Opções do usuário
Por padrão, todos os usuários são migrados. A única maneira de especificar quais usuários incluir e excluir é usando as opções a seguir. Os usuários não podem ser excluídos na migração .xml arquivos ou usando o Config.xml arquivo. Para obter mais informações, consulte Identificar usuários.
| Opção Command-Line | Descrição |
|---|---|
| /todos | Migra todos os usuários no computador. A USMT migra todas as contas de usuário no computador, a menos que uma conta seja especificamente excluída com as /ue opções ou /uel . Por esse motivo, essa opção não precisa ser especificada na linha de comando. No entanto, se estiver usando a /all opção, as /uiopções ou /ue/uel também não poderão ser usadas. |
|
/ui:DomainName Nome de usuário or /ui:"Nome de usuário do nome de domínio" or /ui:ComputerName LocalUserName |
(Incluir usuário) Migra o usuário especificado. Por padrão, todos os usuários são incluídos na migração. Portanto, essa opção só é útil quando usada com a /ue opção. Várias /ui opções podem ser especificadas, mas a /ui opção não pode ser usada com a /all opção.
DomainName e UserName podem conter o caractere curinga asterisco (*). Quando o nome de usuário que contém espaços é especificado, ele precisa ser colocado entre aspas (").Por exemplo, para incluir somente o Usuário2 do domínio Corporativo, insira: /ue:* /ui:corporate\user2
Observação Se um usuário for especificado para inclusão com a /ui opção e também especificado para ser excluído com as /ue opções ou /uel , o usuário será incluído na migração.Para obter mais exemplos, consulte as descrições do /uel, /uee /ui opções nesta tabela. |
/uel:<NumberOfDays>or /uel: <YYYY/MM/DD>or /uel:0 |
(Exclusão de usuário com base no último logon) Migra apenas os usuários que fizeram logon no computador de origem no período especificado, com base na data da última modificação do arquivo Ntuser.dat no computador de origem. A /uel opção atua como uma regra de inclusão. Por exemplo, a /uel:30 opção migra os usuários que fizeram logon ou cuja conta de usuário foi modificada nos últimos 30 dias a partir da data em que o ScanState.exe comando foi executado. O número de dias pode ser especificado ou uma data pode ser especificada. Esta opção não pode ser usada com a /all opção. A USMT recupera as informações da última entrada do computador local para que o computador não precise estar conectado à rede ao executar essa opção. Além disso, se um usuário do domínio entrar em outro computador, a USMT não considerará essa instância de entrada.
Observação A /uel opção não é válida em migrações offline.Exemplos:
Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /uel:0 |
|
/ue:DomainName\UserName or /ue"DomainName\User Name" or /ue:ComputerName\LocalUserName |
(Exclusão de usuário) Exclui os usuários especificados da migração. Várias /ue opções podem ser usadas, mas a /ue opção não pode ser usada com a /all opção.
DomainName e UserName podem conter o caractere curinga asterisco (*). Quando um nome de usuário que contém espaços é especificado, ele precisa estar entre aspas (").Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1Para obter mais exemplos, consulte as descrições do /uel, /uee /ui opções nesta tabela. |
|
/md:OldDomain:NewDomain or /md:LocalComputerName:NewDomain |
(Mover domínio) Especifica um novo domínio para o usuário. Use essa opção para alterar o domínio para usuários em um computador ou migrar um usuário local para uma conta de domínio. OldDomain pode conter o caractere curinga asterisco (). Essa opção pode ser especificada mais de uma vez. Se estiver consolidando usuários em vários domínios para um único domínio, pode ser necessário especificar várias /md opções. Por exemplo, para consolidar os usuários dos domínios Corporate e FarNorth no domínio da Fabrikam, especifique as seguintes configurações: /md:corporate:fabrikam e /md:farnorth:fabrikam.Se houver conflitos entre dois /md comandos, a primeira regra especificada será aplicada. Por exemplo, se os /md:corporate:fabrikam comandos and /md:corporate:farnorth forem especificados, os usuários corporativos serão mapeados para o domínio da Fabrikam.
Observação Se um domínio que não existia no computador de origem for especificado, o LoadState.exe comando parecerá ser concluído com êxito, sem erros ou avisos. No entanto, nesse caso, os usuários não são movidos para NewDomain , mas permanecem em seu domínio original. Por exemplo, se contoso tiver sido digitado incorretamente e, em vez disso, /md:contso:fabrikam for especificado, os usuários permanecerão em contoso no computador de destino.Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /md:contoso:fabrikam |
|
/mu:OldDomain OldUserName:[NewDomain]NewUserName or /mu:OldLocalUserName:NewDomain NewUserName |
(Mover usuário) Especifica um novo nome de usuário para o usuário especificado. Se o repositório contiver mais de um usuário, várias /mu opções poderão ser especificadas. Caracteres curinga não podem ser usados com essa opção.Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /mu:contoso\user1:fabrikam\user1 |
| /lac:[Password] |
(Criação de conta local) Se uma conta de usuário for:
/lae opção também deve ser usada.Se a /lac opção não for especificada, as contas de usuário locais que ainda não existirem no computador de destino não serão migradas.Password é a senha da conta recém-criada. Uma senha vazia é usada por padrão.
Cuidado Use a variável Password com cuidado. A variável Password é fornecida em texto simples e qualquer pessoa com acesso ao computador que está executando o LoadState.exe comando pode obter a senha.Além disso, se o computador tiver vários usuários, todos os usuários migrados terão a mesma senha. Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystorePara obter instruções, consulte Migrar contas de usuário. |
/lae |
(Habilitar conta local) Habilita a conta que foi criada com a /lac opção. A /lac opção deve ser especificada com essa opção.Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore/progress:Progress.log /l:LoadState.log /lac:password /laePara obter instruções, consulte Migrar contas de usuário. |
Exemplos para as opções /ui e /ue
Os exemplos a seguir se aplicam às opções /ui e /ue . A opção /ue pode ser substituída pela opção /ui para incluir, em vez de excluir, os usuários especificados.
| Comportamento | Comando |
|---|---|
| Exclua o usuário denominado Usuário Um no domínio Corporativo. | /ue:"corporate\user one" |
| Exclua o usuário denominado User1 no domínio Corporativo. | /ue:corporate\user1 |
| Exclua o usuário local chamado User1. | /ue:%computername%\user1 |
| Exclua todos os usuários do domínio. | /ue:Domain |
| Exclua todos os usuários locais. | /ue:%computername% |
| Exclua usuários em todos os domínios denominados Usuário1, Usuário2 e assim por diante. | /ue:\user |
Usando as opções em conjunto
As /uelopções e /ui/ue podem ser usadas em conjunto para migrar somente os usuários que precisam ser migrados.
A opção /ui tem precedência sobre as opções /ue e /uel. Se um usuário for incluído usando a /ui opção e também excluído usando as /ue opções ou /uel , o usuário será incluído na migração. Por exemplo, se /ui:contoso\* /ue:contoso\user1 for especificado, User1 será migrado, pois a /ui opção tem precedência sobre a /ue opção.
A opção /uel tem precedência sobre a opção /ue. Se um usuário fizer logon dentro do período de tempo especificado definido pela opção, o /uel perfil desse usuário será migrado, mesmo que ele seja excluído usando a /ue opção. Por exemplo, se /ue:contoso\user1 /uel:14 for especificado, o Usuário1 será migrado se ele tiver feito logon no computador nos últimos 14 dias.
| Comportamento | Comando |
|---|---|
| Inclua somente o User2 do domínio da Fabrikam e exclua todos os outros usuários. | /ue:* /ui:fabrikam\user2 |
| Inclua apenas o usuário local chamado User1 e exclua todos os outros usuários. | /ue:* /ui:user1 |
| Inclua somente os usuários de domínio da Contoso, exceto Contoso\User1. | Esse comportamento não pode ser concluído usando um único comando. Em vez disso, para migrar esse conjunto de usuários, especifique as seguintes opções:
|
| Incluir apenas usuários locais (não domínio). | /ue: /ui:%computername%* |
Opções de linha de comando incompatíveis
A tabela a seguir indica quais opções de linha de comando não são compatíveis com o LoadState.exe comando. Se a entrada da tabela para uma combinação específica tiver um ✅, as opções são compatíveis e podem ser usadas em conjunto. O ❌ símbolo significa que as opções não são compatíveis. Por exemplo, a /nocompress opção não pode ser usada com a /encrypt opção.
| Opção Command-Line | /arquivo de chave | /nocompress | /genconfig | /todos |
|---|---|---|---|---|
| /i | ✅ | ✅ | ✅ | ✅ |
| /v | ✅ | ✅ | ✅ | ✅ |
| /nocompress | ✅ | N/D | ❌ | ✅ |
| /chave | ❌ | ✅ | ❌ | ✅ |
| /decrypt | Obrigatório* | ❌ | ❌ | ✅ |
| /arquivo de chave | N/D | ✅ | ❌ | ✅ |
| /l | ✅ | ✅ | ✅ | ✅ |
| /progresso | ✅ | ✅ | ❌ | ✅ |
| /r | ✅ | ✅ | ❌ | ✅ |
| /w | ✅ | ✅ | ❌ | ✅ |
| /c | ✅ | ✅ | ❌ | ✅ |
| /p | ✅ | ✅ | ❌ | N/D |
| /todos | ✅ | ✅ | ❌ | ✅ |
| /ui | ✅ | ✅ | ❌ | ❌ |
| /ue | ✅ | ✅ | ❌ | ❌ |
| /uel | ✅ | ✅ | ❌ | ❌ |
| /genconfig | ✅ | ✅ | N/D | ✅ |
| /config | ✅ | ✅ | ❌ | ✅ |
| StorePath | ✅ | ✅ | ✅ | ✅ |
| /md | ✅ | ✅ | ✅ | ✅ |
| /mu | ✅ | ✅ | ✅ | ✅ |
| /lae | ✅ | ✅ | ✅ | ✅ |
| /lac | ✅ | ✅ | ✅ | ✅ |
Observação
A /key opção ou /keyfile deve ser especificada com a /decrypt opção.