Sintaxe de ScanState

          </div>
          <p>Por exemplo:</p>
          <p>
            <code>scanstate \\server\share\migration\mystore /v:13 /i:migdocs.xml /i:migapp.xml</code>
          </p>
          <p>
            
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/progress</strong>:[<em>Caminho\</em>]<em>NomeDoArquivo</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>scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /progress:prog.log /l:scanlog.log</code>
          </p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/c</strong>
          </p>
        </td>
        <td colspan="2">
          <p> Quando essa opção é especificada, o comando <strong>ScanState</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, quando há um arquivo muito grande que não cabe no repositório, o comando <strong>ScanState</strong> registra um erro e continua a migração. Além disso, quando um arquivo está aberto ou sendo usado por um aplicativo, a USMT não pode migrar o arquivo e registra um erro. Sem a opção <strong>/c</strong>, o comando <strong>ScanState</strong> é encerrado no primeiro erro.</p>
          <p>Você pode usar a nova seção <strong>&lt;ErrorControl&gt;</strong> 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 <strong>&lt;ErrorControl&gt;</strong> 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 o número de tentativas quando ocorre um erro ao salvar o estado do usuário em um servidor. O padrão é três tentativas. Essa opção é útil em ambientes onde a conectividade de rede não é inteiramente confiável.</p>
          <p>Durante o armazenamento do estado do usuário, a opção <strong>/r</strong> não poderá recuperar dados perdidos devido a uma falha no hardware da rede (como um cabo de rede desconectado ou com defeito) ou quando ocorrer uma falha na conexão de VPN (rede virtual privada). A opção de repetir destina-se a redes de grande porte e ocupadas onde 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 da repetição de uma operação de arquivo de rede. O padrão é 1 segundo.</p>
        </td>
      </tr>
      <tr>
        <td>
          <p>
            <strong>/p:</strong>
            <em>&lt;CaminhoDeUmArquivo&gt;</em>
          </p>
        </td>
        <td>
          <p>Quando o comando <strong>ScanState</strong> é executado, ele cria um arquivo .xml no caminho especificado. Esse arquivo .xml inclui estimativas de aumento de espaço para o repositório de migração. O exemplo a seguir mostra como criar este arquivo .xml:</p>
          <p>
            <code>Scanstate.exe C:\MigrationLocation [additional parameters]</code>
          </p>
          <p>
            <code>/p:"C:\MigrationStoreSize.xml"</code>
          </p>
          <p>Para saber mais, veja <a runat="server" href="hh825132(v=win.10).md">Estimar o tamanho de repositórios de migração</a>.</p>
          <p>Para manter a funcionalidade dos aplicativos ou scripts existentes que requerem o comportamento anterior da USMT, você pode usar a opção <strong>/p</strong>, sem especificar <em>"CaminhoDeUmArquivo"</em>, na USMT. Se você especificar somente a opção <strong>/p</strong>, as estimativas de espaço de armazenamento serão criadas da mesma maneira que as estimativas das versões USMT3.x.</p>
        </td>
      </tr>
      <tr>
        <td colspan="1">
          <p>
            <strong>/?</strong> ou <strong>/help</strong></p>
        </td>
        <td colspan="2">
          <p>Exibe 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. Não é possível excluir usuários nos arquivos .xml de migração ou usando o arquivo Config.xml. Para saber mais, veja Identificar usuários e Migrar contas de usuário.

Opção de linha de comando	Descrição
/all	Migra todos os usuários no computador. A USMT migrará todos os usuários no computador, se você não excluir especificamente uma conta com a opção /ue ou /uel. Por esse motivo, você não precisa especificar esta opção na linha de comando. No entanto, se você escolher especificar a opção /all, não será possível especificar também a opção /ui, /ue ou /uel.
/ui: <NomeDoDomínio>\<NomeDoUsuário> ou /ui: <NomeDoComputador>\<NomeDoUsuárioLocal>	(Inclusão de usuário) Migra os usuários especificados. Por padrão, todos os usuários são incluídos na migração. Sendo assim, esta opção só é útil quando usada com a opção /ue ou /uel. Você pode especificar várias opções /ui, mas não pode usar a opção /ui com a opção /all. O NomeDoDomínio e o NomeDoUsuário podem conter o caractere curinga de asterisco (*). Quando você especifica um nome de usuário que contém espaços, é necessário inseri-lo entre aspas. 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 a opção /ue ou /uel, o usuário será incluído na migração. Por exemplo: Para incluir apenas o User2 do domínio Fabrikam, digite: /ue:*\* /ui:fabrikam\user2 Para migrar todos os usuários do domínio Fabrikam e somente as contas de usuários de outros domínios que estiveram ativas ou foram modificadas nos últimos 30 dias, digite: /uel:30 /ui:fabrikam\* Neste exemplo, uma conta de usuário do domínio Contoso que foi modificada pela última vez há 2 meses não será migrada. Para obter mais exemplos, veja as descrições das opções /ue e /ui nesta tabela.
/uel: <NúmeroDeDias> ou /uel: <AAAA/MM/DD> ou /uel:0	(Exclusão de usuário com base no último logon) Migra os usuários que fizeram logon no computador de origem dentro de um 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 funciona como uma regra de inclusão. Por exemplo, a opção /uel:30 migra os usuários que entraram ou cujas contas 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. Observação A opção /uel não é válida para migrações offline. /uel:0 migra qualquer usuário que esteja atualmente conectado. /uel:90 migra os usuários que fizeram logon ou cujas contas foram modificadas nos últimos 90 dias. /uel:1 migra os usuários cuja conta foi modificada nas últimas 24 horas. /uel:2002/1/15 migra usuários que fizeram logon ou foram modificados em 15 de janeiro de 2002 ou após essa data. Por exemplo: scanstate /i:migapp.xml /i:migdocs.xml \\server\share\migration\mystore /uel:0
/ue: <NomeDoDomínio>\<NomeDoUsuário> -ou- /ue: <NomeDoComputador>\<NomeDoUsuárioLocal>	(Exclusão de usuário) Exclui os usuários especificados da migração. Você pode especificar diversas opções /ue. Essa opção não pode ser usada com a opção /all. O <NomeDoDomínio> e o <NomeDoUsuário> podem conter o caractere curinga de asterisco (*). Ao especificar um nome de usuário que contém espaços, é necessário inseri-lo entre aspas. Por exemplo: scanstate /i:migdocs.xml /i:migapp.xml \\server\share\migration\mystore /ue:contoso\user1

Como usar /ui e /ue

Os exemplos a seguir aplicam-se às opções /ui e /ue. Você pode substituir a opção /ue pela /ui para incluir, em vez de excluir, os usuários especificados.

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ê especificar /ui:contoso\* /ue:contoso\user1, o User1 será migrado, porque a opção /ui tem precedência em relação à 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:fixed\user1 /uel:14, o User1 que efetuou logon no computador nos últimos 14 dias é migrado.

Opções de arquivo criptografado

Você pode usar as seguintes opções para migrar arquivos criptografados. Em todos os casos, por padrão, haverá falha na USMT se um arquivo criptografado for encontrado, a menos que você especifique uma opção /efs. Para migrar arquivos criptografados, é necessário mudar o comportamento padrão.

Para saber mais, veja Migrar arquivos e certificados EFS.

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 ScanState. Quando a entrada da tabela de uma 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.

Consulte também

Outros Recursos

Biblioteca de elementos XML