Sintaxe de LoadState

  • Artigo

Este tópico mostra a sintaxe e as opções do comando LoadState.

Neste tópico

Antes de começar

Sintaxe

Opções de armazenamento

Opções de regra de migração

Opções de monitoramento

Opções de usuário

Opções de linha de comando incompatíveis

Antes de começar

Antes de executar o comando LoadState, observe que:

  • Para garantir que cotas as configurações do sistema operacional sejam migradas, recomendamos executar os comandos LoadState no modo de administrador com uma conta que possua credenciais administrativas.

  • Para conhecer os requisitos de software para executar o comando LoadState, veja Requisitos da USMT.

  • Você deve fazer logoff depois de executar o comando LoadState. Algumas configurações (por exemplo, configurações de fontes, papel de parede e proteção de tela) só funcionarão da próxima vez que o usuário entrar.

  • Se não for especificado de outra maneira, você pode usar cada opção apenas uma vez ao executar uma ferramenta na linha de comando.

  • LoadState não requer acesso ao controlador de domínio para aplicar perfis de domínio. Essa funcionalidade está disponível sem nenhuma configuração adicional. O computador de origem não precisa ter acesso ao controlador de domínio quando o perfil do usuário é coletado usando ScanState. Porém, os perfis de domínio só ficam acessíveis quando o computador de destino ingressa no domínio.

  • A tabela Opções de linha de comando incompatíveis lista quais opções podem ser usadas juntas e quais 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 comando LoadState. As opções podem ser especificadas em qualquer ordem. Se a opção tem um parâmetro, você pode especificar dois-pontos ou espaço como separador.

A sintaxe do comando LoadState é a seguinte:

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 com o Windows Vista ou 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"

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 de linha de comando Descrição

CaminhoDoRepositório

Indica a pasta em que os arquivos e os dados de configuração são armazenados. Especifique StorePath ao usar o comando LoadState. Você não pode especificar mais de um StorePath.

/decrypt /key:KeyString

ou

/decrypt /key:"Key String"

ou

/decrypt /keyfile:[Path\]FileName

Descriptografa o repositório com a chave especificada. Com essa opção, você precisa especificar a chave de criptografia de uma destas maneiras:

  • /key: KeyString especifica a chave de criptografia. Se houver espaço em KeyString, o argumento deverá estar entre aspas.

  • /keyfile: FilePathAndName especifica um arquivo de texto (.txt) com a chave de criptografia

KeyString não pode ter mais de 256 caracteres.

As opções /key e /keyfile não podem ser usadas na mesma linha de comando.

As opções /decrypt e /nocompress não podem ser usadas na mesma linha de comando.

> [!IMPORTANT] > Cuidado com essa opção, pois qualquer pessoa com acesso ao script de linha de comando LoadState também tem acesso à chave de criptografia. >

Por exemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /decrypt /key:mykey

/decrypt: "encryption strength"

A opção /decrypt 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 saber mais sobre os algoritmos de criptografia permitidos, veja Criptografia do repositório de migração.

/hardlink

Permite restaurar os dados de estado do usuário de um repositório de migração de link físico. O parâmetro /nocompress deve ser especificado com a opção /hardlink.

/nocompress

Especifica que o repositório não é compactado. Só use essa opção em ambientes de teste. Recomendamos 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 /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /nocompress

Opções de regra de migração

A USMT oferece as opções a seguir para especificar os itens a serem migrados.

Opção de linha de comando Descrição

/i:[Path\]FileName

(include)

Especifica um arquivo .xml com regras que definem o estado que deve ser migrado. Você pode especificar essa opção várias vezes para incluir todos os arquivos .xml (MigApp.xml, MigSys.xml, MigDocs.xml e qualquer arquivo .xml que criar). Caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Caminho, então o NomeDoArquivo deverá estar no diretório atual.

Para saber mais sobre quais arquivos especificar, veja a seção "Arquivos XML" do tópico Perguntas frequentes.

/config:[Path\]FileName

Especifica o arquivo Config.xml que o comando LoadState deve usar. Você não pode especificar essa opção mais de uma vez na linha de comando. Caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Path, FileName deverá estar no diretório atual.

Neste exemplo, os arquivos e as configurações são migrados com base nas regras dos arquivos Config.xml, MigDocs.xml e MigApp.xml:

loadstate \\server\share\migration\mystore /config:config.xml /i:migdocs.xml /i:migapp.xml /v:5 /l:loadstate.log

/auto: "path to script files"

Esta opção permite especificar o local dos arquivos .xml padrão e quando a migração deve ser iniciada. Se nenhum caminho for especificado, a USMT usará o diretório em que estão os binários da USMT. A opção /auto tem o mesmo efeito de usar as seguintes opções: /i:MigDocs.xml/i:MigApp.xml /v:5.

Opções de monitoramento

A USMT tem várias opções de linha de comando que podem ser usadas para analisar problemas ocorridos durante a migração.

Opção de linha de comando Descrição

/l:[Path\]FileName

Especifica o local e o nome do log de LoadState. Você não pode armazenar nenhum dos arquivos de log em StorePath. Caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Caminho, o log será criado no diretório atual. Você pode especificar a opção /v para ajustar o volume de saída.

Se o comando LoadState é executado em um recurso de rede compartilhado, especifique essa opção ou a USMT falha 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>

(Verbosity)

Habilita a saída detalhada no arquivo de log de LoadState. O valor padrão é 0.

Você pode definir o NívelDeDetalhe como um dos seguintes níveis:

 

Nível Explicação

0

Apenas os erros e avisos padrão são permitidos.

1

Permite a saída detalhada.

4

Permite a saída de erros e status.

5

Permite a saída detalhada e de status.

8

Permite a saída de erros em um depurador.

9

Permite a saída detalhada em um depurador.

12

Permite a saída de erros e status em um depurador.

13

Permite a saída detalhada, de status e no depurador.

 
          </div>
          <p>Por exemplo:</p>
          <p>
            <code>loadstate \\server\share\migration\mystore /v:5 /i:migdocs.xml /i:migapp.xml</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/progress:</strong>[<em>Path\</em>]<em>FileName</em></p>
        </td>
        <td colspan="1">
          <p>Cria o log de andamento opcional. Não armazene nenhum dos arquivos de log no <em>CaminhoDoRepositório</em>. <em>Caminho</em> pode ser um caminho relativo ou completo. Se você não especificar a variável <em>Caminho</em>, então <em>NomeDoArquivo</em> será criado no diretório atual.</p>
          <p>Por exemplo:</p>
          <p>
            <code>loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td>
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td>
          <p>Quando essa opção é especificada, o comando <strong>LoadState</strong> continua em execução, mesmo que ocorram erros não fatais. Os arquivos ou as configurações que geram erro são registrados no log de andamento. Por exemplo, se existe um arquivo grande que não vai caber no computador, o comando <strong>LoadState</strong> registra um erro e continua a migração. Sem a opção <strong>/c</strong>, o comando <strong>LoadState</strong> sai no primeiro erro. Você pode usar a nova seção &lt;<strong>ErrorControl</strong>&gt; no arquivo Config.xml para especificar quais erros de leitura/gravação de arquivos ou do Registro podem ser ignorados com segurança e quais podem fazer a migração falhar. Assim, a opção de linha de comando <strong>/c</strong> pode ignorar com segurança todos os erros de entrada/saída (E/S) no ambiente. Agora, a opção <strong>/genconfig</strong> também gera uma seção &lt;<strong>ErrorControl</strong>&gt; de exemplo que é habilitada especificando mensagens de erro e comportamentos desejados no arquivo Config.xml.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/r:</strong>
            <em>&lt;NúmeroDeTentativas&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Repetir)</strong>
          </p>
          <p>Especifica quantas vezes repetir quando ocorrer um erro ao migrar o estado do usuário de um servidor. O padrão é três vezes. Essa opção é útil em ambientes onde a conectividade de rede não é inteiramente confiável.</p>
          <p>Ao restaurar o estado do usuário, a opção <strong>/r</strong> não recupera dados perdidos devido a falhas de hardware de rede, como um cabo de rede defeituoso ou desconectado, ou quando uma conexão de VPN (rede virtual privada) falha. A opção retry (repetir) destina-se a redes de grande porte e ocupadas, em que a conectividade é satisfatória, mas a latência da comunicação é um problema.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/w:</strong>
            <em>&lt;SegundosAtéNovaTentativa&gt;</em>
          </p>
        </td>
        <td colspan="2">
          <p>
            <strong>(Aguardar)</strong>
          </p>
          <p>Especifica o tempo de espera, em segundos, antes de repetir uma operação de arquivo de rede. O padrão é 1 segundo.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/?</strong> ou <strong>/help</strong></p>
        </td>
        <td colspan="2">
          <p>Mostra a Ajuda na linha de comando.</p>
        </td>
      </tr>
    </table>

Opções de usuário

Por padrão, todos os usuários são migrados. A única maneira de especificar os usuários a serem incluídos e excluídos é por meio das opções a seguir. Você não pode excluir usuários dos arquivos .xml de migração ou usando o arquivo Config.xml. Para saber mais, veja Identificar usuários.

Opção de linha de comando Descrição

/all

Migra todos os usuários no computador.

A USMT migra todas as contas de usuário do computador, a menos que você exclua uma conta especificamente com as opções /ue ou /uel. Por esse motivo, você não precisa especificar essa opção na linha de comando. Mas, ao usar a opção /all, você também não pode usar as opções /ui, /ue ou /uel.

/ui: DomainName\UserName

ou

/ui:"DomainName\User Name"

ou

/ui: ComputerName\LocalUserName

(Inclusão de usuário)

Migra o usuário especificado. Por padrão, todos os usuários são incluídos na migração. Ou seja, essa opção só é útil quando usada com a opção /ue. Você pode especificar várias opções /ui, mas não pode usar a opção /ui com a opção /all. DomainName e UserName podem ter o asterisco (*) curinga. Ao especificar um nome de usuário com espaços, coloque-o entre aspas.

Por exemplo:

  • Para incluir somente User2 do domínio Corporate, digite:

    /ue:*\* /ui:corporate\user2

noteObservação
Se um usuário é especificado para inclusão com a opção /ui e também para exclusão com as opções /ue ou /uel, o usuário é incluído na migração.

Para mais exemplos, veja as descrições das opções /uel, /ue e /ui nesta tabela.

/uel:<NumberOfDays>

ou

/uel:<YYYY/MM/DD>

ou

/uel:0

(Exclusão de usuário com base no último logon)

Migra somente os usuários que entraram no computador de origem no período especificado, com base na data Last Modified do arquivo Ntuser.dat do computador de origem. A opção /uel funciona como uma regra de inclusão. Por exemplo, a opção /uel:30 migra os usuários que entraram ou cujas contas de usuário foram modificadas nos últimos 30 dias a partir da data em que o comando ScanState é executado.

Você pode especificar um número de dias ou uma data. Essa opção não pode ser usada 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ê executa esta opção. Além disso, se um usuário do domínio tiver efetuado logon em outro computador, esse logon não será considerado pela USMT.

noteObservação
A opção /uel não é válida em migrações offline.

Exemplos:

  • /uel:0 migra as contas conectadas ao computador de origem quando o comando ScanState foi executado.

  • /uel:90 migra os usuários que fizeram logon ou cujas contas foram modificadas nos últimos 90 dias.

  • /uel:1 migra os usuários cujas contas foram modificadas nas últimas 24 horas.

  • /uel:2002/1/15 migra os usuários que entraram ou cujas contas foram modificadas desde 15 de janeiro de 2002.

Por exemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0

/ue:DomainName\UserName

ou

/ue:"DomainName\User Name"

ou

/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 (*). Quando você especifica um nome de usuário que contém espaços, é necessário inseri-lo entre aspas.

Por exemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /ue:contoso\user1

Para mais exemplos, veja as descrições das opções /uel, /ue e /ui nesta tabela.

/md: OldDomain:NewDomain

ou

/md: LocalComputerName:NewDomain

(mover domínio)

Especifica um novo domínio para o usuário. Use essa opção para mudar o domínio dos usuários em um computador ou migrar um usuário local para uma conta de domínio. OldDomain pode ter o asterisco (*) curinga.

Você pode especificar essa opção mais de uma vez. É possível especificar várias opções /md ao consolidar usuários de vários domínios em um único domínio. Por exemplo, você pode especificar o seguinte para consolidar os usuários dos domínios Corporate e FarNorth no domínio Fabrikam: /md:corporate:fabrikam e /md:farnorth:fabrikam.

Se houver conflitos entre dois comandos /md, a primeira regra especificada é aplicada. Por exemplo, se você especificar os comandos /md:corporate:fabrikam e /md:corporate:farnorth, os usuários Corporate são mapeados para o domínio Fabrikam.

noteObservação
Se você especificar um OldDomain que não existia no computador de origem, parece que o comando LoadState é concluído com êxito, sem erros ou avisos. Mas, nesse caso, os usuários não vão para NewDomain, mas ficam em seu domínio original. Por exemplo, se você digita "contoso" incorretamente e especifica "/md:contso:fabrikam", os usuários ficam 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

ou

/mu: OldLocalUserName:NewDomain\NewUserName

Especifica o novo nome do usuário especificado. Se o repositório tem mais de um usuário, você pode especifica várias opções /mu. Você não pode usar curingas 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:[Password]

(criação de conta local)

Especifica que, se uma conta de usuário é local (não de domínio) e não existe no computador de destino, a USMT cria a conta o computador de destino, mas ela é desabilitada. Para habilitar a conta, você também precisa usar a opção /lae.

Se a opção /lac não está especificada, todas as contas de usuário locais que ainda não existem no computador de destino não são migradas.

Password é a senha da conta recém-criada. Uma senha vazia é usada por padrão.

CautionCuidado
Use a variável Password com cuidado, pois ela está em texto sem formatação e qualquer pessoa com acesso ao computador que está executando o comando LoadState pode descobri-la.

Além disso, se o computador tem vários usuários, todos os usuários migrados têm a mesma senha.

Por exemplo:

loadstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore

Para obter instruções, veja Migrar contas de usuário.

/lae

(habilitação de conta local)

Habilita a conta 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, veja Migrar contas de usuário.

Exemplos das 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

Excluir o usuário User One do domínio Corporate.

/ue:"corporate\user one"

Excluir o usuário User1 do domínio Corporate.

/ue:corporate\user1

Excluir o usuário local chamado User1.

/ue:%computername%\user1

Excluir todos os usuários do domínio.

/ue:Domain\*

Excluir todos os usuários locais.

/ue:%computername%\*

Excluir usuários em todos os domínios identificados como 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 apenas os usuários desejados.

A opção /ui tem prioridade sobre as opções /ue e /uel. Se um usuário é especificado para ser incluído usando a opção /ui e também para ser excluído usando as opções /ue ou /uel, ele é incluído na migração. Por exemplo, se você especifica /ui:contoso\* /ue:contoso\user1, User1 é migrado, pois a opção /ui tem prioridade sobre a opção /ue.

A opção /uel tem prioridade sobre a opção /ue. Se um usuário entrou no período especificado definido pela opção /uel, seu perfil é migrado, mesmo que ele seja excluído usando a opção /ue. Por exemplo, se você especificar /ue:contoso\user1 /uel:14, o User1 será migrado se tiver entrado no computador nos últimos 14 dias.

Comportamento Comando

Incluir somente User2 no domínio Fabrikam e excluir todos os outros usuários.

/ue:*\* /ui:fabrikam\user2

Incluir somente o usuário local identificado como User1 e excluir todos os outros usuários.

/ue:*\* /ui:user1

Incluir somente os usuários de domínio do 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, será necessário especificar os itens a seguir:

  • Usando a ferramenta de linha de comando ScanState, digite: /ue:*\* /ui:contoso\*

  • Usando a ferramenta de linha de comando LoadState, digite: /ue:contoso\user1

Incluir somente usuários locais (não do domínio).

/ue:*\* /ui:%computername%\*

Opções de linha de comando incompatíveis

A tabela a seguir indica as opções de linha de comando incompatíveis com o comando LoadState. Quando a entrada da tabela de determinada combinação fica em branco, isso indica que as opções são compatíveis e você pode usá-las em conjunto. 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.

Opção de linha de comando /keyfile /nocompress /genconfig /all

/i

/v

/nocompress

N/A

X

/key

X

X

/decrypt

Necessária*

X

X

/keyfile

N/A

X

/l

/progress

X

/r

X

/w

X

/c

X

/p

X

N/A

/all

X

/ui

X

X

/ue

X

X

/uel

X

X

/genconfig

N/A

/config

X

StorePath

/md

/mu

/lae

/lac

Dica

Você deve especificar a opção /key ou /keyfile com a opção /encrypt.

Consulte também

Outros Recursos

Biblioteca de elementos XML