Sintaxe LoadState
O LoadState.exe comando é usado com a USMT (Ferramenta de Migração de Estado do Usuário) para restaurar um repositório capturado anteriormente pelo ScanState.exe comando em um computador de destino. Este artigo discute a LoadState.exe sintaxe de 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
LoadState.execomando, consulte Requisitos USMT.Saia depois de executar o
LoadState.execomando. Algumas configurações, como exemplo, fontes, papel de parede e configurações de protetor de tela, só entrarão em vigor na próxima vez que o usuário fizer logon.A menos que seja especificado de outra forma, cada opção só pode ser usada uma vez ao executar uma ferramenta da linha de comando.
LoadState não requer acesso do controlador de domínio para aplicar perfis de domínio. Essa 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 de usuário foi coletado usando o ScanState. No entanto, os perfis de domínio são 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 pontos ou 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\]ArquivoName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsToWait] [/c] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName ComputerName|\]UserName] [/uel:NumberOfDays|YYYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|ajuda]
Por exemplo, para descriptografar o repositório e migrar os arquivos e as 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
O 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 em que 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. |
| /descriptografar /key:KeyString or /descriptografar /key:"Cadeia de caracteres de chave" or /decrypt /keyfile:[Path]FileName |
Descriptografa o repositório 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 tem acesso à chave de criptografia.Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
| /descriptografar:"força de 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 da Loja 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 a opção. |
| /nocompress | Especifica que o repositório não está compactado. Essa opção só deve ser usada em ambientes de teste. A Microsoft recomenda usar um repositório compactado durante a migração real. Essa opção não pode ser usada com a opção /decrypt .Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
Opções de regra de migração
O USMT fornece as seguintes opções para especificar quais arquivos migrar.
| Opção Command-Line | Descrição |
|---|---|
| /i:[Path]FileName | (inclua) 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 de.xml ( MigApp.xmle MigSys.xmlMigDocs.xml todos os arquivos de.xml personalizados criados). O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, o 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 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 um caminho 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.xmle MigApp.xml nos Config.xmlarquivos: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 de.xml padrão. Se nenhum caminho for especificado, o USMT usará o diretório em que os binários 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
O 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:[Path]FileName | Especifica o local e o nome do log loadstate . Os arquivos de log não podem ser armazenados no StorePath. O caminho pode ser um caminho 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 a verbosidade do log.Se executar o LoadState.exe comando de um recurso de rede compartilhada, a opção l deverá ser especificada ou o USMT falhará com o erro:O USMT não pôde criar os arquivos de log Para corrigir esse problema, especifique a opção /l ao executar LoadState.exe de um recurso de rede compartilhada. |
/v:<VerbosityLevel> |
(Verbosity) Habilita a saída verbosa 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 no StorePath. O caminho pode ser um caminho 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 se encaixe no computador, o LoadState.exe comando registrará um erro e continuará com a migração. Sem a opção /c , 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 o que pode fazer com que a migração falhe. Esse controle de erro permite que a opção /c de linha de comando ignore com segurança todos os erros de E/S (entrada/saída) no ambiente. Além disso, a opção /genconfig agora gera uma seção ErrorControl> de exemplo < habilitada especificando mensagens de erro e comportamentos desejados no Config.xml arquivo. |
/r:<TimesToRetry> |
(Repetindo) Especifica o número de vezes para tentar novamente quando ocorre um erro ao migrar o 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 opção /r não recupera dados perdidos devido a uma falha de hardware de rede, como um cabo de rede defeituoso ou desconectado ou quando uma conexão VPN (rede virtual privada) falha. A opção de repetição destina-se a redes grandes e movimentadas em que a conectividade é satisfatória, mas a latência de comunicação é um problema. |
/w:<SecondsBeforeRetry> |
(Aguarde) Especifica o tempo para aguardar, em segundos, antes de tentar novamente uma operação de arquivo de rede. O padrão é 1 segundo. |
| /? ou /help | Exibe Ajuda na linha de comando. |
Opções de 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 seguintes opções. 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. O 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 opção /all , as /uiopções ou /ue/uel também não poderão ser usadas. |
| /ui:DomainName UserName or /ui:"Nome de usuário domainname" 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 opção /ue . Várias /ui opções podem ser especificadas, mas a opção /ui não pode ser usada com a opção /all . DomainName e UserName podem conter o caractere curinga asterisco (*). Quando o nome de usuário que contém espaços é especificado, ele precisa ser cercado com aspas (").Por exemplo, para incluir apenas o User2 do domínio Corporativo, insira: /ue:* /ui:corporate\user2Observação Se um usuário for especificado para inclusão com a opção /ui 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, confira as descrições das /uelopções , /uee /ui 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 entraram no computador de origem no período de tempo especificado, com base na última data modificada do arquivo Ntuser.dat no computador de origem. A /uel opção atua como uma regra de inclusão. Por exemplo, a opção /uel:30 migra usuários que se conectaram ou cuja conta de usuário foi modificada, nos últimos 30 dias a partir da data em que o ScanState.exe comando é executado. O número de dias pode ser especificado ou uma data pode ser especificada. Essa opção não pode ser usada com a opção /all . O USMT recupera as últimas informações de entrada do computador local, portanto, o computador não precisa ser conectado à rede ao executar essa opção. Além disso, se um usuário de domínio entrar em outro computador, o 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\Nome de Usuário" 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 opção /ue não pode ser usada com a opção /all . DomainName e UserName podem conter o caractere curinga asterisco (*). Quando um nome de usuário que contém espaços é especificado, ele precisa estar cercado de aspas (").Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1Para obter mais exemplos, confira as descrições das /uelopções , /uee /ui 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 para 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 consolidar usuários em vários domínios em um único domínio, várias /md opções poderão precisar ser especificadas. Por exemplo, para consolidar os usuários dos domínios Corporativo e FarNorth no domínio 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 e /md:corporate:farnorth forem especificados, os usuários corporativos serão mapeados para o domínio Fabrikam. Observação Se um domínio que não existiu no computador de origem for especificado, o LoadState.exe comando será concluído com êxito, sem um erro ou aviso. 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 for escrito 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:[Senha] | (Criação de conta local) Se uma conta de usuário for:
/lae também deve ser usada.Se a opção não for especificada, todas as /lac contas de usuário locais que ainda não existem no computador de destino não serão migradas.Senha é a senha da conta recém-criada. Uma senha vazia é usada por padrão. Cuidado Use a variável Senha com cuidado. A variável Senha é 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 |
(Habilitação da conta local) Habilita a conta que foi criada com a opção /lac . 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 chamado User One no domínio Corporativo. | /ue:"corporate\user one" |
| Exclua o usuário chamado User1 no domínio Corporativo. | /ue:corporate\user1 |
| Exclua o usuário local chamado User1. | /ue:%computername%\user1 |
| Exclua todos os usuários de domínio. | /ue:Domain |
| Exclua todos os usuários locais. | /ue:%computername% |
| Exclua usuários em todos os domínios chamados User1, User2 e assim por diante. | /ue:\user |
Usando as opções em conjunto
As /uelopções e /ue/ui podem ser usadas em conjunto para migrar apenas 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 opção /ui 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, o User1 será migrado, pois a opção /ui terá precedência sobre a opção /ue .
A opção /uel tem precedência sobre a opção /ue. Se um usuário estiver conectado 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 opção /ue . Por exemplo, se /ue:contoso\user1 /uel:14 for especificado, o User1 será migrado se ele fizer logon no computador nos últimos 14 dias.
| Comportamento | Comando |
|---|---|
| Inclua apenas o User2 do domínio 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 apenas 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:
|
| Inclua 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 de uma combinação específica tiver um ✅, as opções serão compatíveis e poderão ser usadas juntas. O ❌ símbolo significa que as opções não são compatíveis. Por exemplo, a opção /nocompress não pode ser usada com a opção /encrypt .
| Opção Command-Line | /Keyfile | /nocompress | /genconfig | /Todos |
|---|---|---|---|---|
| /Eu | ✅ | ✅ | ✅ | ✅ |
| /V | ✅ | ✅ | ✅ | ✅ |
| /nocompress | ✅ | N/D | ❌ | ✅ |
| /Chave | ❌ | ✅ | ❌ | ✅ |
| /Descriptografar | Necessário* | ❌ | ❌ | ✅ |
| /Keyfile | 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 opção /key ou /keyfile deve ser especificada com a opção /decrypt .
Artigos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de