Sintaxe LoadState
O LoadState.exe comando é utilizado com a Ferramenta de Migração de Estado do Utilizador (USMT) para restaurar um arquivo capturado anteriormente pelo ScanState.exe comando para um computador de destino. Este artigo aborda a LoadState.exe sintaxe do comando e as opções disponíveis.
Antes de começar
Antes de executar o LoadState.exe comando, tenha em atenção os seguintes itens:
Para garantir que todas as definições do sistema operativo são migradas, a Microsoft recomenda a execução
LoadState.exede comandos no modo de administrador a partir de uma conta com credenciais administrativas.Para obter informações sobre os requisitos de software para executar o
LoadState.execomando, veja Requisitos de USMT.Termine sessão depois de executar o
LoadState.execomando . Algumas definições, como, por exemplo, tipos de letra, padrões de fundo e definições de deteção de ecrã, só entrarão em vigor na próxima vez que o utilizador iniciar sessão.Salvo especificação em contrário, cada opção só pode ser utilizada uma vez ao executar uma ferramenta a partir da linha de comandos.
LoadState não requer acesso de 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 de controlador de domínio quando o perfil de utilizador foi recolhido com ScanState. No entanto, os perfis de domínio estão inacessíveis até que o computador de destino seja associado ao domínio.
A tabela de opções da linha de comandos Incompatível lista as opções que podem ser utilizadas em conjunto e quais as opções da linha de comandos incompatíveis.
Sintaxe
Esta secção explica a sintaxe e a utilização das opções da linha de comandos disponíveis ao utilizar o LoadState.exe comando . As opções podem ser especificadas por qualquer ordem. Se a opção contiver um parâmetro, pode ser especificado um separador de dois pontos ou de espaço.
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\]NomedeUtilizador] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?|ajuda]
Por exemplo, para desencriptar o arquivo e migrar os ficheiros e definições para um computador, escreva 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 utilizadas para especificar como e onde os dados migrados são armazenados.
| Opção Command-Line | Descrição |
|---|---|
| StorePath | Indica a pasta onde os dados de ficheiros e definições são armazenados.
O StorePath tem de ser especificado ao utilizar o LoadState.exe comando . Não é possível especificar mais do que um StorePath . |
|
/decrypt /key:KeyString or /decrypt /key:"Key String" or /decrypt /keyfile:[Path]FileName |
Desencripta o arquivo com a chave especificada. Com esta opção, a chave de encriptação tem de ser especificada de uma das seguintes formas:
O KeyString não pode exceder os 256 carateres. As /key opções e /keyfile não podem ser utilizadas na mesma linha de comandos.As /decrypt opções e /nocompress não podem ser utilizadas na mesma linha de comandos.
Importante Tenha cuidado ao utilizar as /key opções ou keyfile . Por exemplo, qualquer pessoa que tenha acesso a scripts que executem o LoadState.exe comando com estas opções também tem acesso à chave de encriptação.Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /decrypt /key:mykey |
| /decrypt:"encryption strength" | A /decrypt opção aceita um parâmetro de linha de comandos para definir a força de encriptação especificada para a encriptação do arquivo de migração. Para obter mais informações sobre os algoritmos de encriptação suportados, veja Encriptação do Arquivo de Migração. |
| /hardlink | Permite que os dados de estado do utilizador sejam restaurados a partir de um arquivo de migração hard-link. O /nocompress parâmetro tem de ser especificado com /hardlink a opção . |
| /nocompress | Especifica que o arquivo não está comprimido. Esta opção só deve ser utilizada em ambientes de teste. A Microsoft recomenda a utilização de um arquivo comprimido durante a migração real. Esta opção não pode ser utilizada com a opção /decrypt .Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /nocompress |
Opções de regras de migração
O USMT fornece as seguintes opções para especificar os ficheiros a migrar.
| Opção Command-Line | Descrição |
|---|---|
| /i:[Path]FileName |
(incluir) Especifica um ficheiro de.xml que contém regras que definem os dados a migrar. Esta opção pode ser especificada várias vezes para incluir todos os ficheiros de.xml ( MigApp.xml, MigSys.xmle MigDocs.xml quaisquer ficheiros de.xml personalizados criados).
O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, o FileName tem de estar localizado no diretório atual.Para obter mais informações sobre os ficheiros a especificar, veja a secção "Ficheiros XML" do artigo Perguntas Mais Frequentes . |
| /config:[Path]FileName | Especifica o Config.xml ficheiro que o LoadState.exe comando deve utilizar. Esta opção não pode ser especificada mais do que uma vez na linha de comandos.
O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, o FileName tem de estar localizado no diretório atual.Este exemplo migra os ficheiros e definições com base nas regras nos Config.xmlficheiros , MigDocs.xmle MigApp.xml :LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:5 /l:LoadState.log |
| /auto:"caminho para ficheiros de script" | Esta opção permite especificar a localização dos ficheiros de.xmlpredefinidos . Se não for especificado nenhum caminho, a USMT utiliza o diretório onde estão localizados os binários USMT. A /auto opção tem o mesmo efeito que utilizar as seguintes opções: /i:MigDocs.xml/i:MigApp.xml /v:5. |
Opções de monitorização
O USMT fornece várias opções de linha de comandos que podem ser utilizadas para analisar problemas que ocorrem durante a migração.
| Opção Command-Line | Descrição |
|---|---|
| /l:[Path]FileName | Especifica a localização e o nome do registo LoadState . Os ficheiros de registo 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 registo é criado no diretório atual. A /v opção pode ser especificada para ajustar a verbosidade do registo.Se executar o comando a LoadState.exe partir de um recurso de rede partilhada, a opção l tem de ser especificada ou o USMT falhará com o erro:O USMT não conseguiu criar o(s) ficheiro(s) de registo(s) Para corrigir este problema, certifique-se de que especifica a opção /l ao executar LoadState.exe a partir de um recurso de rede partilhado. |
/v:<VerbosityLevel> |
(Verbosidade) Ativa a saída verbosa no ficheiro de registo LoadState . O valor padrão é 0. O VerbosityLevel pode ser definido para 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 registo de progresso opcional. Os ficheiros de registo 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 é 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 esta opção é especificada, o LoadState.exe comando continua a ser executado, mesmo que ocorram erros não fatais. Todos os ficheiros ou definições que causem um erro são registados no registo de progresso. Por exemplo, se existir um ficheiro grande que não cabe no computador, o LoadState.exe comando regista um erro e continua a migração. Sem a opção /c , o LoadState.exe comando sai no primeiro erro. A < secção ErrorControl> pode ser utilizada no Config.xml ficheiro para especificar que erros de leitura/escrita de ficheiros ou registos podem ser ignorados com segurança e que podem causar a falha da migração. Este controlo de erro permite que a opção da /c linha de comandos ignore com segurança todos os erros de entrada/saída (E/S) no ambiente. Além disso, a opção /genconfig gera agora uma < secção ErrorControl> de exemplo que está ativada ao especificar mensagens de erro e comportamentos pretendidos no Config.xml ficheiro. |
/r:<TimesToRetry> |
(Repetir) Especifica o número de vezes que tentar novamente quando ocorre um erro ao migrar o estado do utilizador a partir de um servidor. A predefinição é três vezes. Esta opção é útil em ambientes onde a conectividade de rede não é fiável. Quando o estado do utilizador está a ser restaurado, a opção /r não recupera dados perdidos devido a uma falha de hardware de rede, como um cabo de rede com falhas ou desligado, ou quando uma ligação de rede privada virtual (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 a aguardar, em segundos, antes de repetir uma operação de ficheiro de rede. A predefinição é de 1 segundo. |
| /? ou /help | Apresenta a Ajuda na linha de comandos. |
Opções de utilizador
Por predefinição, todos os utilizadores são migrados. A única forma de especificar os utilizadores a incluir e excluir é através das seguintes opções. Os utilizadores não podem ser excluídos na migração .xml ficheiros ou através do Config.xml ficheiro. Para obter mais informações, veja Identificar Utilizadores.
| Opção Command-Line | Descrição |
|---|---|
| /all | Migra todos os utilizadores no computador. O USMT migra todas as contas de utilizador no computador, a menos que uma conta seja especificamente excluída com as /ue opções ou /uel . Por este motivo, esta opção não precisa de ser especificada na linha de comandos. No entanto, se utilizar a opção /all , as /uiopções ou /ue/uel também não podem ser utilizadas. |
|
/ui:DomainName UserName or /ui:"Nome de Utilizador do Nome de Domínio" or /ui:ComputerName LocalUserName |
(Inclusão do utilizador) Migra o utilizador especificado. Por predefinição, todos os utilizadores estão incluídos na migração. Por conseguinte, esta opção só é útil quando utilizada com a opção /ue . Podem ser especificadas várias /ui opções, mas a opção /ui não pode ser utilizada com a opção /all .
DomainName e UserName podem conter o caráter universal asterisco (*). Quando o nome de utilizador que contém espaços é especificado, tem de estar entre aspas (").Por exemplo, para incluir apenas o Utilizador2 do domínio Empresarial, introduza: /ue:* /ui:corporate\user2
Observação Se um utilizador for especificado para inclusão com a opção /ui e também for especificado para ser excluído com as /ue opções ou /uel , o utilizador será incluído na migração.Para obter mais exemplos, veja as descrições das /uelopções , /uee /ui nesta tabela. |
/uel:<NumberOfDays>or /uel: <YYYY/MM/DD>or /uel:0 |
(Exclusão do utilizador com base no último início de sessão) Migra apenas os utilizadores que iniciaram sessão no computador de origem no período de tempo especificado, com base na data da Última Modificação do ficheiro Ntuser.dat no computador de origem. A /uel opção funciona como uma regra de inclusão. Por exemplo, a opção migra os /uel:30 utilizadores que iniciaram sessão ou cuja conta de utilizador 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. Esta opção não pode ser utilizada com a opção /all . O USMT obtém as últimas informações de início de sessão do computador local, pelo que o computador não precisa de estar ligado à rede ao executar esta opção. Além disso, se um utilizador de domínio iniciar sessão noutro computador, a USMT não considerará essa instância de início de sessão.
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 do utilizador) Exclui os utilizadores especificados da migração. Podem ser utilizadas várias /ue opções, mas a opção /ue não pode ser utilizada com a opção /all .
DomainName e UserName podem conter o caráter universal asterisco (*). Quando um nome de utilizador que contém espaços é especificado, tem de estar entre aspas (").Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /ue:contoso\user1Para obter mais exemplos, veja 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 utilizador. Utilize esta opção para alterar o domínio dos utilizadores num computador ou para migrar um utilizador local para uma conta de domínio. OldDomain pode conter o caráter universal asterisco (). Esta opção pode ser especificada mais do que uma vez. Se consolidar utilizadores em vários domínios num único domínio, poderão ter de ser especificadas várias /md opções. Por exemplo, para consolidar os utilizadores dos domínios Empresarial e FarNorth no domínio fabrikam, especifique as seguintes definições: /md:corporate:fabrikam e /md:farnorth:fabrikam.Se existirem conflitos entre dois /md comandos, é aplicada a primeira regra especificada. Por exemplo, se os /md:corporate:fabrikam comandos e /md:corporate:farnorth forem especificados, os utilizadores empresariais serão mapeados para o domínio fabrikam.
Observação Se um domínio que não existia no computador de origem for especificado, o LoadState.exe comando parece ser concluído com êxito, sem um erro ou aviso. No entanto, neste caso, os utilizadores não são movidos para NewDomain , mas permanecem no domínio original. Por exemplo, se contoso estiver mal escrito e, em vez disso, for especificado /md:contso:fabrikam , os utilizadores permanecerão na 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 utilizador) Especifica um novo nome de utilizador para o utilizador especificado. Se o arquivo contiver mais do que um utilizador, podem ser especificadas várias /mu opções. Os carateres universais não podem ser utilizados com esta 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:[Palavra-passe] |
(Criação de conta local) Se uma conta de utilizador for:
/lae também tem de ser utilizada.Se a opção /lac não for especificada, as contas de utilizador locais que ainda não existem no computador de destino não serão migradas.A palavra-passe é a palavra-passe da conta criada recentemente. Uma palavra-passe vazia é utilizada por predefinição.
Cuidado Utilize a variável Palavra-passe com cuidado. A variável Palavra-passe é fornecida em texto simples e qualquer pessoa com acesso ao computador que está a executar o LoadState.exe comando pode obter a palavra-passe.Além disso, se o computador tiver vários utilizadores, todos os utilizadores migrados têm a mesma palavra-passe. Por exemplo: LoadState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystorePara obter instruções, veja Migrar contas de utilizador. |
/lae |
(Ativar conta local) Ativa a conta que foi criada com a opção /lac . A /lac opção tem de ser especificada com esta 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, veja Migrar contas de utilizador. |
Exemplos para as opções /ui e /ue
Os exemplos seguintes aplicam-se à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 utilizadores especificados.
| Comportamento | Comando |
|---|---|
| Exclua o utilizador com o nome User One no domínio Empresarial. | /ue:"corporate\user one" |
| Exclua o utilizador com o nome User1 no domínio Empresarial. | /ue:corporate\user1 |
| Exclua o utilizador local com o nome User1. | /ue:%computername%\user1 |
| Excluir todos os utilizadores de domínio. | /ue:Domain |
| Excluir todos os utilizadores locais. | /ue:%computername% |
| Exclua utilizadores em todos os domínios denominados Utilizador1, Utilizador2, entre outros. | /ue:\user |
Utilizar as opções em conjunto
As /uelopções e /ue/ui podem ser utilizadas em conjunto para migrar apenas os utilizadores que precisam de ser migrados.
A opção /ui tem precedência sobre as opções /ue e /uel. Se um utilizador for incluído com a opção /ui e também for excluído através das /ue opções ou /uel , o utilizador será incluído na migração. Por exemplo, se /ui:contoso\* /ue:contoso\user1 for especificado, o Utilizador1 é migrado porque a opção /ui tem precedência sobre a opção /ue .
A opção /uel tem precedência sobre a opção /ue. Se um utilizador tiver iniciado sessão no período de tempo especificado definido pela opção, o /uel perfil desse utilizador será migrado mesmo que seja excluído através da opção /ue . Por exemplo, se /ue:contoso\user1 /uel:14 for especificado, o Utilizador1 será migrado se tiver iniciado sessão no computador nos últimos 14 dias.
| Comportamento | Comando |
|---|---|
| Inclua apenas o Utilizador2 do domínio Fabrikam e exclua todos os outros utilizadores. | /ue:* /ui:fabrikam\user2 |
| Inclua apenas o utilizador local com o nome User1 e exclua todos os outros utilizadores. | /ue:* /ui:user1 |
| Inclua apenas os utilizadores de domínio da Contoso, exceto Contoso\User1. | Este comportamento não pode ser concluído com um único comando. Em vez disso, para migrar este conjunto de utilizadores, especifique as seguintes opções:
|
| Inclua apenas utilizadores locais (não domínios). | /ue: /ui:%computername%* |
Opções de linha de comandos incompatíveis
A tabela seguinte indica quais as opções da linha de comandos que não são compatíveis com o LoadState.exe comando . Se a entrada de tabela para uma combinação específica tiver um ✅, as opções são compatíveis e podem ser utilizadas em conjunto. O ❌ símbolo significa que as opções não são compatíveis. Por exemplo, a opção /nocompress não pode ser utilizada com a opção /encrypt .
| Opção Command-Line | /keyfile | /nocompress | /genconfig | /all |
|---|---|---|---|---|
| /eu | ✅ | ✅ | ✅ | ✅ |
| /v | ✅ | ✅ | ✅ | ✅ |
| /nocompress | ✅ | N/D | ❌ | ✅ |
| /key | ❌ | ✅ | ❌ | ✅ |
| /desencriptar | Necessário* | ❌ | ❌ | ✅ |
| /keyfile | N/D | ✅ | ❌ | ✅ |
| /l | ✅ | ✅ | ✅ | ✅ |
| /progress | ✅ | ✅ | ❌ | ✅ |
| /r | ✅ | ✅ | ❌ | ✅ |
| /w | ✅ | ✅ | ❌ | ✅ |
| /c | ✅ | ✅ | ❌ | ✅ |
| /p | ✅ | ✅ | ❌ | N/D |
| /all | ✅ | ✅ | ❌ | ✅ |
| /ui | ✅ | ✅ | ❌ | ❌ |
| /ue | ✅ | ✅ | ❌ | ❌ |
| /uel | ✅ | ✅ | ❌ | ❌ |
| /genconfig | ✅ | ✅ | N/D | ✅ |
| /config | ✅ | ✅ | ❌ | ✅ |
| StorePath | ✅ | ✅ | ✅ | ✅ |
| /md | ✅ | ✅ | ✅ | ✅ |
| /mu | ✅ | ✅ | ✅ | ✅ |
| /lae | ✅ | ✅ | ✅ | ✅ |
| /lac | ✅ | ✅ | ✅ | ✅ |
Observação
A opção /key ou /keyfile tem de ser especificada com a opção /decrypt .