Sintaxe de ScanState
O comando ScanState é usado com a USMT (Ferramenta de Migração de Estado do Usuário) 5.0 para examinar o computador de origem, coletar os arquivos e as configurações, e criar um repositório.
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 arquivo criptografado
Opções de linha de comando incompatíveis
Antes de executar o comando ScanState, observe o seguinte:
Na maioria dos casos, você deve executar os comandos ScanState no modo Administrador usando uma conta com credenciais administrativas para garantir que todas as configurações do sistema operacional sejam migradas.
Se criptografar o repositório de migração, você terá que inserir uma chave de criptografia ou um caminho para um arquivo que contenha essa chave. Certifique-se de anotar o local da chave ou do arquivo da chave, porque essa informação não será mantida em nenhum local do repositório de migração. Você precisará dessa informação quando executar o comando LoadState para descriptografar o repositório de migração ou se for necessário executar o utilitário de recuperação. Uma chave ou um arquivo de chave incorreto ou ausente gera uma mensagem de erro.
Para saber mais sobre os requisitos de software para executar o comando ScanState, veja Requisitos da USMT.
Importante
O Windows XP e o Windows Vista® são permitidos somente como sistemas operacionais no computador de origem.
A menos que indicado o contrário, você só poderá usar cada opção uma vez ao executar uma ferramenta na linha de comando.
Você pode coletar contas de domínio sem que o computador de origem tenha acesso ao controlador de domínio. Essa funcionalidade está disponível sem nenhuma configuração adicional.
A tabela Opções de linha de comando incompatíveis lista quais opções podem ser usadas juntas e quais são incompatíveis.
O local do diretório em que você salvar o repositório de migração será excluído da verificação. Por exemplo, se você salvar o repositório de migração na raiz da unidade D, a unidade D e todos os seus subdiretórios serão excluídos da verificação.
Esta seção explica a sintaxe e o uso das opções de linha de comando de ScanState. As opções podem ser especificadas em qualquer ordem. Quando a opção contém um parâmetro, você pode usar um separador de dois pontos ou espaço.
A sintaxe do comando ScanState é a seguinte:
scanstate [CaminhoDoRepositório] [/i:[Caminho\]NomeDoArquivo] [/o] [/v:NívelDeDetalhe] [/nocompress] [/localonly] [/encrypt /key:Chave|/keyfile:[Caminho\]NomeDoArquivo] [/l:[Caminho\]NomeDoArquivo] [/progress:[Caminho\]NomeDoArquivo] [/r:NúmeroDeTentativas] [/w:SegundosAtéNovaTentativa] [/c] [/p] [/all] [/ui:[NomeDoDomínio|NomeDoComputador\]NomeDoUsuário] [/ue:[NomeDoDomínio|NomeDoComputador\]NomeDoUsuário] [/uel:NúmeroDeDias|AAAA/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Caminho\]NomeDoArquivo[/config:[Caminho\]NomeDoArquivo] [/?|help]
Por exemplo:
Para criar um arquivo Config.xml no diretório atual, especifique:
scanstate /i:migapp.xml /i:migdocs.xml /genconfig:config.xml /v:13
Para criar um repositório criptografado usando o arquivo Config.xml e os arquivos .xml de migração padrão, especifique:
scanstate \\server\share\migration\mystore /i:migapp.xml /i:migdocs.xml /o /config:config.xml /v:13 /encrypt /key:"mykey"
Opção de linha de comando | Descrição |
---|---|
CaminhoDoRepositório |
Indica uma pasta onde os arquivos e as configurações serão salvos. Observe que o CaminhoDoRepositório não pode ser c:\. Você deve especificar a opção de CaminhoDoRepositório no comando ScanState, exceto quando usar a opção /genconfig. Não é possível especificar mais do que um local de CaminhoDoRepositório. |
/o |
Necessária para substituir os dados existentes no repositório de migração ou no arquivo Config.xml. Se não for especificada, o comando ScanState gerará uma falha se o repositório de migração já contiver dados. Não é possível especificar esta opção mais de uma vez em uma linha de comando. |
/vsc |
Esta opção permite que o serviço de cópias de sombra de volume migre arquivos que estão bloqueados ou em uso. Esta opção de linha de comando elimina a maioria dos erros de bloqueio de arquivo que normalmente são encontrados pela seção <ErrorControl>. Esta opção só pode ser usada com o arquivo executável do ScanState e não pode ser combinada com a opção /hardlink. |
/hardlink |
Permite a criação de um repositório de migração de link físico no local especificado. A opção /nocompress deve ser especificada com a opção /hardlink . |
/encrypt [{/key:<Chave> | /keyfile:<Caminho>]} |
Criptografa o repositório com a chave especificada. Por padrão, a criptografia está desabilitada. Com esta opção, você precisará especificar a chave de criptografia de uma destas maneiras:
Recomendamos que Chave tenha pelo menos oito caracteres, mas ela não pode exceder 256 caracteres. As opções /key e /keyfile não podem ser usadas na mesma linha de comando. As opções /encrypt e /nocompress não podem ser usadas na mesma linha de comando. > [!IMPORTANT] > Tenha muito cuidado ao usar esta opção, pois qualquer pessoa que tenha acesso ao script de linha de comando de ScanState também terá acesso à chave de criptografia. >O exemplo a seguir mostra o comando ScanState e a opção /key:
|
/encrypt:<NívelDeCriptografia> |
A opção /encrypt aceita um parâmetro de linha de comando para definir o nível de criptografia a ser usado para o repositório de migração. Para saber mais sobre os algoritmos de criptografia permitidos, veja o tópico sobre Criptografia do repositório de migração. |
/nocompress |
Desabilita a compactação de dados e salva os arquivos em uma pasta oculta chamada "File" em CaminhoDoRepositório\USMT. Por padrão, a compactação está desabilitada. A combinação da opção /nocompress com a opção /hardlink gera um repositório de migração de link físico. Você pode usar o repositório descompactado para visualizar o que é armazenado pela USMT, solucionar um problema ou executar um utilitário antivírus nos arquivos. Essa opção deve ser usada apenas em ambientes de teste, pois recomendamos usar um repositório compactado para migrações reais, a menos que você esteja combinando a opção /nocompress com a opção /hardlink. As opções /nocompress e /encrypt não podem ser usadas juntas em uma instrução na linha de comando. No entanto, se você optar por migrar um repositório descompactado, o comando LoadState migrará cada arquivo diretamente do repositório para o local correto no computador de destino sem um local temporário. Por exemplo:
|
Você pode executar o comando ScanState no Windows PE. Além disso, a USMT permite migração de instalações anteriores do Windows contidas nos diretórios Windows.old. O diretório offline pode ser um diretório do Windows quando você executa o comando ScanState no Windows PE ou um diretório Windows.old quando você executa o comando ScanState no Windows.
Há vários benefícios em executar o comando ScanState em uma imagem do Windows offline, incluindo:
Melhora no desempenho.
Como o Windows PE é um sistema operacional limitado, há menos serviços em execução. Nesse ambiente, o comando ScanState tem mais acesso aos recursos locais de hardware, permitindo que o ScanState execute operações de migração mais rapidamente.
Processo simplificado de implantação ponta a ponta.
A migração de dados do Windows.old simplifica o processo de implantação ponta a ponta, permitindo que o processo de migração ocorra após a instalação do novo sistema operacional.
Maior êxito da migração.
A taxa de êxito de migração aumenta, porque os arquivos não serão bloqueados para edição enquanto estiverem offline e porque o Windows PE fornece acesso de administrador aos arquivos no sistema de arquivos offline do Windows, eliminando a necessidade de acesso no nível do administrador ao sistema online.
Capacidade de recuperar um computador não inicializável.
Há a possibilidade de recuperar e migrar dados de um computador não inicializável.
Opção de linha de comando | Definição |
---|---|
/offline: "caminho de um arquivo offline.xml" |
Esta opção é usada para definir um caminho para um arquivo .xml offline que pode especificar outras opções de migração offline, por exemplo, um diretório offline do Windows ou qualquer redirecionamento de domínio ou pasta necessário na migração. |
/offlinewindir: "caminho de um diretório do Windows" |
Esta opção especifica o diretório offline do Windows a partir do qual o comando ScanState coleta o estado do usuário. O diretório offline pode ser o Windows.old quando você executa o comando ScanState no Windows ou um diretório do Windows quando você executa o comando ScanState no Windows PE. |
/offlinewinold: "diretório Windows.old" |
Esta opção de linha de comando habilita o modo de migração offline e inicia a migração a partir do local especificado. Ela só deve ser usada nos cenários de migração do Windows.old, onde a migração está ocorrendo a partir de um diretório Windows.old. |
A USMT oferece as opções a seguir para especificar os itens a serem migrados.
Opção de linha de comando | Descrição | ||||||||
---|---|---|---|---|---|---|---|---|---|
/i:[Caminho\]NomeDoArquivo |
(incluir) Especifica um arquivo .xml que contém regras que definem qual estado de usuário, aplicativo ou sistema a ser migrado. Você pode definir esta opção várias vezes para especificar todos os seus arquivos .xml (MigApp.xml, MigDocs.xml e qualquer arquivo .xml personalizado criado). 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. |
||||||||
/genconfig:[Caminho\]NomeDoArquivo |
(gerar Config.xml) Gera o arquivo Config.xml opcional, mas não cria um repositório de migração. Para assegurar que este arquivo contenha cada componente, aplicativo e configuração que possa ser migrado, você deve criá-lo em um computador de origem que contenha todos os componentes, os aplicativos e as configurações que estarão presentes nos computadores de destino. Além disso, você deve especificar outros arquivos .xml de migração, usando a opção /i, ao especificar esta opção. Depois que você criar esse arquivo, será necessário usá-lo com o comando ScanState usando a opção /config. As únicas opções que podem ser especificadas com esta opção são /i, /v e /l. Você não pode especificar CaminhoDoRepositório, porque a opção /genconfig não cria um repositório. Caminho pode ser um caminho relativo ou completo. Se você não especificar a variável Caminho, então NomeDoArquivo será criado no diretório atual. Exemplos:
|
||||||||
/config:[Caminho\]NomeDoArquivo |
Especifica o arquivo Config.xml que o comando ScanState deve usar para criar o repositório. Você não pode especificar esta 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 Caminho, então o NomeDoArquivo deverá estar no diretório atual. O exemplo a seguir cria um repositório usando os arquivos Config.xml, MigDocs.xml e MigApp.xml:
O exemplo a seguir migra os arquivos e as configurações para o computador de destino usando os arquivos Config.xml, MigDocs.xml e MigApp.xml:
|
||||||||
/auto: caminho dos arquivos de script |
Essa opção permite que você especifique o local dos arquivos .xml padrão e inicie a migração. Se nenhum caminho for especificado, a USMT referenciará o diretório onde os binários da USMT estão localizados. A opção /auto tem o mesmo efeito que usar as seguintes opções: /i:MigDocs.xml/i:MigApp.xml /v:5. |
||||||||
/genmigxml: caminho de um arquivo |
Esta opção especifica que o comando ScanState deve usar o localizador de documentos para criar e exportar um arquivo .xml que define como migrar todos os arquivos no computador em que o comando ScanState está sendo executado. |
||||||||
/localonly |
Migra somente arquivos armazenados no computador local, independentemente das regras nos arquivos .xml especificados na linha de comando. Use esta opção quando você desejar excluir dados das unidades removíveis do computador de origem (unidades flash USB, alguns discos rígidos externos e outros) e quando existirem unidades de rede mapeadas no computador de origem. Se a opção /localonly não for especificada, o comando ScanState copiará os arquivos dessas unidades removíveis ou de rede no repositório. Tudo o que não é considerado uma unidade fixa pelo sistema operacional será excluído por /localonly. Em alguns casos, grandes unidades de disco externas são consideradas unidades fixas. Essas unidades podem ser excluídas explicitamente da migração usando um arquivo .xml personalizado. Para saber mais sobre como excluir todos os arquivos em uma unidade específica, veja Excluir arquivos e configurações. A opção de linha de comando /localonly inclui ou exclui dados na migração, conforme identificado na tabela a seguir:
|
A USMT oferece várias opções que podem ser usadas para analisar problemas que ocorrem durante a migração.
Dica
O log do ScanState é criado por padrão, mas é possível especificar o nome e o local do log com a opção /l.
Opção de linha de comando | Descrição | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/listfiles:<NomeDoArquivo> |
Você pode usar a opção de linha de comando /listfiles com o comando ScanState para gerar um arquivo de texto que lista todos os arquivos incluídos na migração. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/l:[Caminho\]NomeDoArquivo |
Especifica o local e o nome do log do ScanState. Não armazene nenhum dos arquivos de log no CaminhoDoRepositório. 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 usar a opção /v para ajustar a quantidade de saída. Se você executar os comandos ScanState ou LoadState usando um recurso de rede compartilhado, especifique esta opção; caso contrário, a USMT gerará uma falha com o erro "USMT não pôde criar os arquivos de log". Para corrigir esse problema, use o comando /l:scan.log. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
/v: <NívelDeDetalhe> |
(Verbosity) Habilita a saída detalhada no arquivo de log do ScanState. O valor padrão é 0. Você pode definir o NívelDeDetalhe como um dos seguintes níveis:
Opções de usuárioPor 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.
Como usar /ui e /ueOs 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 juntasVocê 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 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
Opções de arquivo criptografadoVocê 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. Dica Os certificados EFS serão migrados automaticamente ao migrar para o Windows Vista Windows 7ou Windows 8. Portanto, especifique a opção /efs:copyraw com o comando ScanState para migrar os arquivos criptografados. Aviso Tenha muito cuidado ao migrar arquivos criptografados. Se você migrar um arquivo criptografado sem migrar o certificado, os usuários finais não poderão acessar o arquivo após a migração.
Opções de linha de comando incompatíveisA 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.
Dica Você deve especificar a opção /key ou /keyfile com a opção /encrypt. Consulte tambémOutros Recursos |