Sintaxe de LoadState
Este tópico discute a sintaxe do comando LoadState e as opções disponíveis com ele.
Antes de começar
Antes de executar o comando LoadState , observe o seguinte:
Para garantir que todas as configurações do sistema operacional migrem, recomendamos que você execute os comandos LoadState no modo de administrador de uma conta com credenciais administrativas.
Para obter informações sobre os requisitos de software para executar o comando LoadState , consulte UsMT Requirements.
Você deve fazer logoff depois de executar o comando LoadState . Algumas configurações (por exemplo, fontes, papel de parede e configurações do protetor 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, você pode usar cada opção apenas uma vez ao executar uma ferramenta na linha de comando.
LoadState não requer acesso de controlador de domínio para aplicar perfis de domínio. Essa funcionalidade está disponível sem nenhuma configuração adicional. Não é necessário que o computador de origem tenha tido acesso ao controlador de domínio quando o perfil do usuário foi coletado usando ScanState. No entanto, os perfis de domínio estão inacessíveis até que o computador de destino seja ingressado no domínio.
A tabela opções Command-Line lista quais opções você pode usar juntas 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 quando você usa o comando LoadState . As opções podem ser especificadas em qualquer ordem. Se a opção contiver um parâmetro, você poderá especificar um separador de dois-pontos ou de espaço.
A sintaxe do comando LoadState é:
loadstate 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\]UserName] [/uel:NumberOfDays|YYYY/MM/DD|0] [/md:OldDomain:NewDomain] [/mu:OldDomain\OldUserName:[NewDomain\]NewUserName] [/lac:[Password]] [/lae] [/config:[Path\]FileName] [/?| help]
Por exemplo, para descriptografar o repositório e migrar os arquivos e as configurações para um computador que executa o Windows 7, digite o seguinte na linha de comando:
loadstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /v:13 /decrypt /key:"mykey"
Armazenamento opções
A USMT fornece as seguintes opções que você pode usar para especificar como e onde os dados migrados são armazenados.
| Command-Line opção | Descrição |
|---|---|
StorePath |
Indica a pasta em que os arquivos e os dados de configurações são armazenados. Você deve especificar StorePath ao usar o comando LoadState . Não é possível especificar mais de um StorePath. |
/decrypt /key:KeyString or /decrypt /key:"Cadeia de caracteres de chave" or /decrypt /keyfile:[Path]FileName |
Descriptografa o repositório com a chave especificada. Com essa opção, você precisará especificar a chave de criptografia de uma das seguintes maneiras:
KeyString não pode exceder 256 caracteres. As /key opções /keyfile e as opções não podem ser usadas na mesma linha de comando. As /decrypt opções /nocompress e as opções não podem ser usadas na mesma linha de comando. Importante Tenha cuidado com essa opção, pois qualquer pessoa que tenha acesso ao script de linha de comando LoadState também terá acesso à chave de criptografia. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /decrypt /key:mykey |
/decrypt:"força de criptografia" |
A /decrypt opção aceita um parâmetro de linha de comando para definir a intensidade 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 a /hardlink opção. |
/nocompress |
Especifica que o repositório não está compactado. Você só deve usar essa opção em ambientes de teste. Recomendamos que você use um repositório compactado durante a migração real. Essa opção não pode ser usada com a /decrypt opção. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /nocompress |
Opções de regra de migração
A USMT fornece as opções a seguir para especificar quais arquivos você deseja migrar.
| Command-Line opção | Descrição |
|---|---|
/i:[Path]FileName |
(include) Especifica um arquivo .xml que contém regras que definem o estado a ser migrado. Você pode especificar essa opção várias vezes para incluir todos os arquivos .xml (MigApp.xml, MigSys.xml, MigDocs.xml e quaisquer arquivos .xml personalizados que você criar). O caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Path , FileName deverá estar localizado no diretório atual. Para obter mais informações sobre quais arquivos especificar, consulte a seção "arquivos XML" do tópico Perguntas Frequentes . |
/config:[Caminho] Filename |
Especifica o arquivo Config.xml que o comando LoadState deve usar. Não é possível especificar essa opção mais de uma vez na linha de comando. O caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Path , o FileName deverá estar localizado no diretório atual. Este exemplo migra os arquivos e as configurações com base nas regras Config.xml, MigDocs.xml e MigApp.xml arquivos: loadstate \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 que você especifique o local dos arquivos .xml padrão e, em seguida, inicie sua migração. Se nenhum caminho for especificado, a USMT usará o diretório onde 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
A USMT fornece várias opções de linha de comando que você pode usar para analisar problemas que ocorrem durante a migração.
| Command-Line opção | Descrição |
|---|---|
/l:[Caminho] Filename |
Especifica o local e o nome do log LoadState . Você não pode armazenar nenhum dos arquivos de log no StorePath. O caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Path , o log será criado no diretório atual. Você pode especificar a opção /v para ajustar a quantidade de saída. Se você executar o comando LoadState de um recurso de rede compartilhada, deverá especificar essa opção ou a USMT falhará com o erro: "a USMT não pôde criar os arquivos de log". Para corrigir esse problema, use a opção /l:load.log . |
/v:<VerbosityLevel> |
(Detalhamento) Habilita a saída detalhada no arquivo de log LoadState. O valor padrão é 0. Você pode definir o VerbosityLevel como um dos seguintes níveis:
Por exemplo: loadstate \server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml |
/progress:[Caminho] Filename |
Cria o log de progresso opcional. Você não pode armazenar nenhum dos arquivos de log no StorePath. O caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Path , FileName será criado no diretório atual. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /progress:prog.log /l:loadlog.log |
/c |
Quando essa opção for especificada, o comando LoadState continuará a ser executado, mesmo se ocorrerem 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 ajustará ao computador, o comando LoadState registrará um erro e continuará com a migração. Sem a opção /c , o comando LoadState será encerrado no primeiro erro. < Você pode usar a nova seção ErrorControl> no arquivo Config.xml para especificar quais erros de leitura/gravação de arquivo ou registro podem ser ignorados com segurança e o que pode causar falha na migração. Isso permite que a opção de linha de comando /c ignore com segurança todos os erros de E/S (entrada/saída) em seu 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 arquivo Config.xml exemplo. |
/r:<TimesToRetry> |
(Repetir) Especifica o número de vezes a repetir 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. Ao restaurar o estado do usuário, a opção /r não recuperará dados perdidos devido a uma falha de hardware de rede, como um cabo de rede com falha ou desconectado ou quando uma conexão vpn (rede virtual privada) falhar. 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. |
/? or /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. Você não pode excluir usuários nos arquivos .xml migração ou usando o arquivo Config.xml usuário. Para obter mais informações, consulte Identificar usuários.
| Command-Line opção | Descrição |
|---|---|
/all |
Migra todos os usuários no computador. A USMT migra todas as contas de usuário no computador, a menos que você exclua especificamente uma conta com as opções /ue ou /uel . Por esse motivo, você não precisa especificar essa opção na linha de comando. No entanto, se você optar por usar a opção /all , também não poderá usar as opções /ui, /ue ou /uel . |
/ui:DomainName UserName or /ui:"Nome de usuário DomainName" or /ui:ComputerName LocalUserName |
(Inclusão do 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 . Você pode especificar várias opções de /ui , mas não pode usar a opção /ui com a opção /all . DomainName e UserName podem conter o caractere curinga asterisco () . Ao especificar um nome de usuário que contenha espaços, você precisará cercá-lo entre aspas. Por exemplo:
Observação Se um usuário for especificado para inclusão com a opção /ui e também for especificado para ser excluído com as opções /ue ou /uel , o usuário será incluído na migração. Para obter mais exemplos, consulte as descrições das opções /uel, /ue e /ui nesta tabela. |
/uel:<NumberOfDays> or /uel:<YYYY/MM/DD> or /uel:0 |
(Exclusão do usuário com base no último logon) Migra somente os usuários que se conectaram ao computador de origem dentro do período de tempo especificado, com base **** na data da Última Modificação do arquivo Ntuser.dat no computador de origem. A opção /uel atua como uma regra de inclusão. Por exemplo, a opção /uel:30 migra os usuários que se conectaram ou cuja conta de usuário foi modificada nos últimos 30 dias a partir da data em que o comando ScanState é executado. Você pode especificar um número de dias ou pode especificar uma data. Você não pode usar essa opção com a opção /all . A USMT recupera as últimas informações de logon do computador local, portanto, o computador não precisa estar conectado à rede quando você executar essa opção. Além disso, se um usuário de domínio tiver feito logon em outro computador, essa instância de logon não será considerada pela USMT. Observação A opção /uel não é válida em migrações offline. Exemplos:
Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /uel:0 |
/ue:DomainName UserName or /ue"Nome de usuário DomainName" or /ue:ComputerName LocalUserName |
(Exclusão de usuário) Exclui os usuários especificados da migração. Você pode especificar várias opções /ue , mas não pode usar a opção /ue com a opção /all . DomainName e UserName podem conter o caractere curinga asterisco () . Ao especificar um nome de usuário que contenha espaços, você precisará cercá-lo entre aspas. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /ue:contoso\user1 Para obter mais exemplos, consulte as descrições das opções /uel, /ue e /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 de 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 () . Você pode especificar essa opção mais de uma vez. Talvez você queira especificar várias opções /md se estiver consolidando usuários em vários domínios em um único domínio. Por exemplo, você pode especificar o seguinte para consolidar os usuários dos domínios Corporativo e FarNorth no domínio Fabrikam: /md:corporate:fabrikam e /md:farnorth:fabrikam. Se houver conflitos entre dois comandos /md , a primeira regra especificada será aplicada. Por exemplo, se você especificar os comandos /md:corporate:fabrikam /md:corporate:farnorth e os comandos, os usuários corporativos serão mapeados para o domínio fabrikam. Observação Se você especificar um OldDomain que não existia no computador de origem, o comando LoadState parecerá ser concluído com êxito, sem um erro ou aviso. No entanto, nesse caso, os usuários não serão movidos para NewDomain , mas permanecerão em seu domínio original. Por exemplo, se "você digitar contoso" "incorretamente e especificar /md:contso:fabrikam", os usuários permanecerão em contoso no computador de destino. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /progress:prog.log /l:load.log /md:contoso:fabrikam |
/mu:OldDomain OldUserName:[NewDomain]NewUserName or /mu:OldLocalUserName:NewDomain NewUserName |
Especifica um novo nome de usuário para o usuário especificado. Se o repositório contiver mais de um usuário, você poderá especificar várias opções /mu . Você não pode usar caracteres curinga com essa opção. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /progress:prog.log /l:load.log /mu:contoso\user1:fabrikam\user1 |
/lac:[Senha] |
(criação de conta local) Especifica que, se uma conta de usuário for uma conta local (não domínio) e ela não existir no computador de destino, a USMT criará a conta no computador de destino, mas ela será desabilitada. Para habilitar a conta, você também deve usar a opção /lae . Se a opção /lac não for especificada, nenhuma conta de usuário local que ainda não exista no computador de destino não será migrada. A senha é a senha da conta recém-criada. Uma senha vazia é usada por padrão. Cuidado Use a variável Password com cuidado porque ela é fornecida em texto sem formatação e pode ser obtida por qualquer pessoa com acesso ao computador que está executando o comando LoadState . Além disso, se o computador tiver vários usuários, todos os usuários migrados terão a mesma senha. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore Para obter instruções, consulte Migrar contas de usuário. |
/lae |
(habilitar conta local) Habilita a conta que foi criada com a opção /lac . Você deve especificar a opção /lac com essa opção. Por exemplo: loadstate /i:migapp.xml /i:migdocs.xml \server\share\migration\mystore /progress:prog.log /l:load.log /lac:password /lae Para 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 . Você pode substituir a opção /ue 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 do 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 juntas
Você pode usar as opções /uel, /ue e /ui juntas para migrar somente os usuários que você deseja migrar.
A opção /ui tem precedência sobre as opções /ue e /uel. Se um usuário for especificado para ser incluído usando a opção /ui e também especificado para ser excluído usando as opções /ue ou /uel , o usuário será incluído na migração. Por exemplo, se você especificar /ui:contoso\* /ue:contoso\user1, User1 será migrado, pois 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 usuário tiver feito logon dentro do período de tempo especificado definido pela opção /uel , o perfil desse usuário será migrado mesmo que ele seja excluído usando a opção /ue . Por exemplo, se você /ue:contoso\user1 /uel:14especificar, o User1 será migrado se tiver feito logon no computador nos últimos 14 dias.
| Comportamento | Comando |
|---|---|
| Inclua somente 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 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, você precisará especificar o seguinte:
|
| Inclua somente usuários locais (não domínio). | /ue: /ui:%computername%* |
Opções de Command-Line incompatíveis
A tabela a seguir indica quais opções de linha de comando não são compatíveis com o comando LoadState . Se a entrada da tabela para uma combinação específica estiver em branco, as opções serão compatíveis e você poderá usá-las juntas. O símbolo X significa que as opções não são compatíveis. Por exemplo, você não pode usar a opção /nocompress com a opção /encrypt .
| Command-Line opção | /keyfile | /nocompress | /genconfig | /all |
|---|---|---|---|---|
| /i | ||||
| /v | ||||
| /nocompress | N/D | X | ||
| /key | X | X | ||
| /decrypt | Obrigatório* | X | X | |
| /keyfile | N/D | X | ||
| /l | ||||
| /progress | X | |||
| /r | X | |||
| /w | X | |||
| /c | X | |||
| /p | X | N/D | ||
| /all | X | |||
| /ui | X | X | ||
| /ue | X | X | ||
| /uel | X | X | ||
| /genconfig | N/D | |||
| /config | X | |||
| Storepath | ||||
| /md | ||||
| /mu | ||||
| /lae | ||||
| /lac |
Observação
Você deve especificar a opção /key ou /keyfile com a opção /encrypt .
Tópicos relacionados
Comentários
Submeter e ver comentários