Sintaxe ScanState

O ScanState.exe comando é usado com a USMT (Ferramenta de Migração de Estado do Usuário) para examinar o computador de origem, coletar os arquivos e configurações e criar um repositório. Este artigo discute a ScanState.exe sintaxe de comando e as opções disponíveis com ele.

Antes de começar

Antes de executar o ScanState.exe comando, observe os itens:

  • Para garantir que todas as configurações do sistema operacional migrem, execute os ScanState.exe comandos no modo de administrador de uma conta com credenciais administrativas.

  • Se o repositório de migração for criptografado, será necessária uma chave de criptografia ou um caminho para um arquivo que contém a chave de criptografia. Observe a chave ou o local do arquivo de chave, pois essas informações não são mantidas em nenhum lugar no repositório de migração. Essas informações são necessárias quando o LoadState.exe comando é executado para descriptografar o repositório de migração ou se o utilitário de recuperação precisar ser usado. Uma chave ou arquivo chave incorreto ou ausente resulta em uma mensagem de erro.

  • Para obter informações sobre os requisitos de software para executar o ScanState.exe comando, consulte Requisitos USMT.

  • A menos que seja observado de outra forma, use cada opção apenas uma vez ao executar uma ferramenta na linha de comando.

  • Contas de domínio podem ser coletadas sem que o computador de origem tenha acesso ao controlador de domínio. Essa funcionalidade está disponível sem qualquer configuração extra.

  • A tabela de opções de linha de comando incompatíveis lista quais opções podem ser usadas em conjunto e quais opções de linha de comando são incompatíveis.

  • O local do diretório em que o repositório de migração é salvo é excluído da verificação. Por exemplo, se o repositório de migração for salvo na raiz da unidade D, a unidade D e todos os seus subdiretórios serão excluídos da verificação.

Sintaxe

Esta seção explica a sintaxe e o uso das opções de linha de comando disponíveis ao usar o ScanState.exe comando. As opções podem ser especificadas em qualquer ordem. Se a opção contiver um parâmetro, um colono ou um separador de espaço poderá ser usado.

A ScanState.exe sintaxe do comando é:

ScanState.exe [StorePath] [/apps] [/ppkg:FileName] [/i:[Path\]FileName] [/o] [/v:VerbosityLevel] [/nocompress] [/localonly] [/encrypt /key:KeyString|/keyfile:[Path\]FileName] [/l:[Path\]FileName] [/progress:[Path\]FileName] [/r:TimesToRetry] [/w:SecondsBeforeRetry] [/c] [/p] [/all] [/ui:[DomainName|ComputerName\]UserName] [/ue:[DomainName|ComputerName\]UserName] [/uel:NumberOfDays|YYYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|ajuda]

Por exemplo, para criar um Config.xml arquivo no diretório atual, use:

ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:13

Para criar um repositório criptografado usando o Config.xml arquivo e a migração padrão .xml arquivos, use:

ScanState.exe \\server\share\migration\mystore /i:MigApp.xml /i:MigDocs.xml /o /config:Config.xml /v:13 /encrypt /key:"mykey"

Opções de armazenamento

Opção Command-Line Descrição
Storepath Indica uma pasta em que arquivos e configurações são salvos. StorePath não pode ser C:\. A opção StorePath deve ser especificada no ScanState.exe comando, exceto ao usar a opção /genconfig . Mais de um local do StorePath não pode ser especificado.
/Apps Examina a imagem em busca de aplicativos e inclui-os e suas configurações de registro associadas.
/ppkg [<FileName>] Exporta para um local de arquivo específico.
/o Necessário para substituir todos os dados existentes no repositório ou Config.xml arquivo de migração. Se não for especificado, o ScanState.exe comando falhará se o repositório de migração já contiver dados. Essa opção não pode ser usada mais de uma vez em uma linha de comando.
/Vsc Essa opção permite que o serviço de cópia de sombra de volume migre arquivos bloqueados ou em uso. Essa opção de linha de comando elimina a maioria dos erros de bloqueio de arquivo que normalmente são encontrados pela <seção ErrorControl> .

Essa opção é usada apenas com o arquivo executável ScanState e não pode ser combinada com a opção /hardlink .
/hardlink Habilita a criação de um repositório de migração de link rígido no local especificado. A opção /nocompress deve ser especificada com a opção /hardlink .
/encrypt [{/key:<KeyString> | /keyfile:<file>]} Criptografa o repositório com a chave especificada. A criptografia é desabilitada por padrão. Com essa opção, a chave de criptografia precisa ser especificada de uma das seguintes maneiras:
  • /key: KeyString especifica a chave de criptografia. Se houver um espaço no KeyString, o KeyString precisará estar cercado de aspas (").
  • /keyfile: FilePathAndName especifica um arquivo de texto (.txt) que contém a chave de criptografia.

Recomenda-se que KeyString tenha pelo menos oito caracteres, mas não pode exceder 256 caracteres. As /key opções e /keyfile não podem ser usadas na mesma linha de comando. As /encrypt opções e /nocompress não podem ser usadas na mesma linha de comando.
Importante
Tenha cuidado ao usar as /key opções ou keyfile . Por exemplo, qualquer pessoa que tenha acesso a scripts que executam o ScanState.exe comando com essas opções também tem acesso à chave de criptografia.

O exemplo a seguir mostra o ScanState.exe comando e a opção /key :
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /encrypt /key:mykey
/encrypt:<EncryptionStrength> A /encrypt opção aceita um parâmetro de linha de comando para definir a força de criptografia a ser usada para criptografia do repositório de migração. Para obter mais informações sobre algoritmos de criptografia com suporte, consulte Criptografia da Loja de Migração.
/nocompress Desabilita a compactação de dados e salva os arquivos em uma pasta oculta chamada "Arquivo" no StorePath\USMT. A compactação está habilitada por padrão. Combinar a opção /nocompress com a opção /hardlink gera um repositório de migração de link rígido. O repositório não compactado pode ser usado para exibir o que o USMT armazenou, solucionar problemas de um problema ou executar um utilitário antivírus nos arquivos. Essa opção só deve ser usada em ambientes de teste. A Microsoft recomenda usar um repositório compactado durante as migrações de produção, a menos que combine a opção /nocompress com a opção /hardlink .

As /nocompress opções e /encrypt não podem ser usadas juntas em uma instrução na linha de comando. No entanto, se um repositório não compactado for migrado, o LoadState.exe comando migrará cada arquivo diretamente do repositório para o local correto no computador de destino sem um local temporário.

Por exemplo:
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /nocompress

Executar o comando ScanState em um sistema Windows offline

O ScanState.exe comando pode ser executado no WinPE (Ambiente de Pré-instalação do Windows). Além disso, o USMT dá suporte a migrações de instalações anteriores do Windows contidas em diretórios windows.old . O diretório offline pode ser um diretório do Windows quando o ScanState.exe comando é executado no WinPE ou em um diretório windows.old quando o ScanState.exe comando é executado no Windows.

Há vários benefícios para executar o comando em uma imagem offline do ScanState.exe Windows, incluindo:

  • Melhor desempenho.

    Como o WinPE é um sistema operacional fino, há menos serviços em execução. Nesse ambiente, o ScanState.exe comando tem mais acesso aos recursos de hardware locais, permitindo que o ScanState execute operações de migração mais rapidamente.

  • Processo de implantação de ponta a ponta simplificado.

    A migração de dados do Windows.old simplifica o processo de implantação de ponta a ponta, permitindo que o processo de migração ocorra após a instalação do novo sistema operacional.

  • Melhor sucesso da migração.

    A taxa de sucesso de migração é aumentada porque:

    • Os arquivos não estão bloqueados para edição enquanto estiverem offline.
    • O WinPE fornece acesso do administrador a arquivos no sistema de arquivos do Windows offline, eliminando a necessidade de acesso no nível do administrador ao sistema online.
  • Capacidade de recuperar um de um computador que não inicializa.

    Talvez seja possível recuperar e migrar dados de um computador que não inicializa.

Opções de migração offline

Opção Command-Line Definição
/offline:"caminho para um arquivo Offline.xml" Essa opção é usada para definir um caminho para um arquivo de.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 para um diretório do Windows" Essa opção especifica o diretório offline do Windows do qual o comando reúne o ScanState.exe estado do usuário. O diretório offline pode ser windows.old quando o ScanState.exe comando é executado no Windows ou em um diretório do Windows quando o ScanState.exe comando é executado no WinPE.
/offlinewinold:"Diretório windows.old" Essa opção de linha de comando habilita o modo de migração offline e inicia a migração do local especificado. Essa opção destina-se apenas a ser usada em cenários de migração antigos do Windows , em que a migração está ocorrendo de um diretório windows.old .

Opções de regra de migração

O USMT fornece as seguintes opções para especificar quais arquivos migrar.

Opção Command-Line Descrição
/i:[Path]FileName (inclua)

Especifica um arquivo .xml que contém regras que definem qual estado de usuário, aplicativo ou sistema migrar. Essa opção pode ser especificada várias vezes para incluir todos os arquivos de.xml (MigApp.xmle MigDocs.xmlquaisquer arquivos de.xml personalizados criados). O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, o FileName deverá estar localizado no diretório atual. Para obter mais informações sobre quais arquivos especificar, consulte a seção "Arquivos XML" do artigo Perguntas frequentes .
/genconfig:[Path]FileName (Gerar Config.xml)

Gera o arquivo opcional Config.xml , mas não cria um repositório de migração. Para garantir que esse arquivo contenha tudo o que precisa ser migrado, crie este arquivo em um computador de origem que contenha todos os:
  • componentes
  • applications
  • settings
presentes nos computadores de destino. Além disso, os outros arquivos de.xml de migração devem ser especificados, usando a opção /i , quando essa opção for especificada.

Depois que esse arquivo é criado, ele pode ser usado com o ScanState.exe comando usando a opção /config .

As únicas opções que podem ser especificadas com essa opção são as /iopções , /ve /l . O StorePath não pode ser especificado, pois a opção /genconfig não cria um repositório. O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, FileName será criado no diretório atual.

Exemplos:
  • O exemplo a seguir cria um Config.xml arquivo no diretório atual:
    ScanState.exe /i:MigApp.xml /i:MigDocs.xml /genconfig:Config.xml /v:13
/config:[Path]FileName Especifica o Config.xml arquivo que o ScanState.exe comando deve usar para criar o repositório. Essa opção não pode ser usada mais de uma vez na linha de comando. O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, o FileName deverá estar localizado no diretório atual.

O exemplo a seguir cria um repositório usando o Config.xml arquivo e MigDocs.xmlos MigApp.xml arquivos:
ScanState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:13 /l:ScanState.log

O exemplo a seguir migra os arquivos e as configurações para o computador de destino usando os Config.xmlarquivos , MigDocs.xmle MigApp.xml :
LoadState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:13 /l:LoadState.log
/auto:caminho para arquivos de script Essa opção permite especificar o local dos arquivos de.xml padrão. Se nenhum caminho for especificado, o USMT referenciará o diretório em que 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.
/genmigxml:path to a file Essa opção especifica que o ScanState.exe comando deve usar o localizador de documentos para criar e exportar um arquivo .xml que define como migrar todos os arquivos no computador no qual o ScanState.exe comando está em execução.
/Localonly Migra apenas arquivos armazenados no computador local, independentemente das regras nos arquivos .xml especificados na linha de comando. Essa opção deve ser usada para excluir os dados de unidades removíveis no computador de origem e quando houver unidades de rede mapeadas no computador de origem. Exemplos de unidades removíveis incluem UFDs (unidades flash USB) e alguns discos rígidos externos. Se a opção /localonly não for especificada, o ScanState.exe comando copiará arquivos dessas unidades removíveis ou de rede para o repositório.

/localonly exclui qualquer coisa que não seja considerada uma unidade fixa pelo sistema operacional. Em alguns casos, discos rígidos externos grandes são considerados unidades fixas. Essas unidades podem ser excluídas explicitamente da migração usando um arquivo de.xml personalizado. Para obter mais informações sobre como excluir todos os arquivos em uma unidade específica, consulte Excluir arquivos e configurações.

A /localonly opção de linha de comando inclui ou exclui dados na migração conforme identificado nos seguintes locais de armazenamento:
  • Unidades removíveis, como uma unidade flash USB - Excluídas
  • Unidades de rede – Excluídos
  • Unidades fixas – Incluído

Opções de monitoramento

O USMT fornece várias opções que podem ser usadas para analisar problemas que ocorrem durante a migração.

Observação

O log ScanState é criado por padrão, mas o nome e o local do log podem ser especificados com a opção /l .

Opção Command-Line Descrição
/listfiles:<FileName> A /listfiles opção de linha de comando pode ser usada com o ScanState.exe comando para gerar um arquivo de texto que lista todos os arquivos incluídos na migração.
/l:[Path]FileName Especifica o local e o nome do log ScanState .

Os arquivos de log 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 log será criado no diretório atual. A /v opção pode ser usada para ajustar a quantidade de saída.

Se o ScanState.exe comando for executado a partir de um recurso de rede compartilhada, a opção /l deverá ser especificada ou o USMT falhará com o seguinte erro:

O USMT não pôde criar os arquivos de log

Para corrigir esse problema, especifique a opção /l ao executar ScanState.exe de um recurso de rede compartilhada.
/v:<VerbosityLevel> (Verbosity)

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

O VerbosityLevel pode ser definido como um dos seguintes níveis:
  • 0 – Somente os erros e avisos padrão estão habilitados.
  • 1 – Habilita a saída verbosa.
  • 4 – Habilita a saída de erro e status.
  • 5 – Habilita a saída verbosa e status.
  • 8 – Habilita a saída de erro para um depurador.
  • 9 – Habilita a saída verbosa para um depurador.
  • 12 – Habilita a saída de erro e status para um depurador.
  • 13 – Habilita a saída verbosa, status e depurador.

Por exemplo:
ScanState.exe \server\share\migration\mystore /v:13 /i:MigDocs.xml /i:MigApp.xml
/progress:[Path]FileName Cria o log de progresso opcional. Os arquivos de log 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 será criado no diretório atual.

Por exemplo:
ScanState.exe /i:MigApp.xml /i:MigDocs.xml \server\share\migration\mystore /progress:Progress.log /l:scanlog.log
/C Quando essa opção é especificada, o ScanState.exe comando continua a ser executado, mesmo que ocorram 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 encaixe no repositório, o ScanState.exe comando registrará um erro e continuará com a migração. Além disso, se um arquivo estiver aberto ou em uso por um aplicativo, o USMT poderá não ser capaz de migrar o arquivo e registrar um erro no log. Sem a opção /c , o ScanState.exe comando sai no primeiro erro.

A < seção ErrorControl> no Config.xml arquivo pode ser usada para especificar quais erros de leitura/gravação de arquivo ou registro podem ser ignorados com segurança e o que pode fazer com que a migração falhe. Essa vantagem no Config.xml arquivo permite que a opção /c de linha de comando ignore com segurança todos os erros de E/S (entrada/saída) no ambiente. Além disso, a opção /genconfigagora gera uma seção ErrorControl> de exemplo < habilitada especificando mensagens de erro e comportamentos desejados no Config.xml arquivo.
/r:<TimesToRetry> (Repetindo)

Especifica o número de vezes para tentar novamente quando ocorre um erro ao salvar o estado do usuário em um servidor. O padrão é três vezes. Essa opção é útil em ambientes em que a conectividade de rede não é confiável.

Quando o estado do usuário é armazenado, a opção /r não pode recuperar dados perdidos devido a uma falha de hardware de rede, como um cabo de rede defeituoso ou desconectado ou quando uma conexão VPN (rede virtual privada) falha. A opção de repetição destina-se a redes grandes e movimentadas em que a conectividade é satisfatória, mas a latência de comunicação é um problema.
/w:<SecondsBeforeRetry> (Aguarde)

Especifica o tempo para aguardar, em segundos, antes de tentar novamente uma operação de arquivo de rede. O padrão é 1 segundo.
/p:<pathToFile> Quando o ScanState.exe comando é executado, ele cria um arquivo .xml no caminho especificado. Este arquivo.xml inclui estimativas de espaço aprimoradas para o repositório de migração. O exemplo a seguir mostra como criar este arquivo.xml :
ScanState.exe C:\MigrationLocation [additional parameters]
/p:"C:\MigrationStoreSize.xml"

Para obter mais informações, confira Estimar Tamanho do Repositório de Migração.

Para preservar a funcionalidade de aplicativos ou scripts existentes que exigem o comportamento anterior do USMT, a opção /p pode ser usada, sem especificar "pathtoafile", no USMT. Se apenas a opção /p for especificada, as estimativas de espaço de armazenamento serão criadas da mesma maneira que com as versões USMT 3.x.
/? ou /help Exibe Ajuda na linha de comando.

Opções de 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 seguintes opções. Os usuários não podem ser excluídos na migração .xml arquivos ou usando o Config.xml arquivo. Para obter mais informações, consulte Identificar usuários e Migrar contas de usuário.

Opção Command-Line Descrição
/Todos Migra todos os usuários no computador.

O USMT migra todas as contas de usuário no computador, a menos que uma conta seja especificamente excluída com as /ue opções ou /uel . Por esse motivo, essa opção não precisa ser especificada na linha de comando. No entanto, se a opção /all for especificada, as /ui/ue opções ou /uel também não poderão ser especificadas.
/ui:<DomainName>\<UserName>
or
/ui:<ComputerName>\<LocalUserName>
(Incluir usuário)

Migra os usuários especificados. Por padrão, todos os usuários são incluídos na migração. Portanto, essa opção é útil somente quando usada com as /ue opções ou /uel . Várias /ui opções podem ser especificadas, mas a opção /ui não pode ser usada com a opção /all . DomainName e UserName podem conter o caractere curinga asterisco (*). Quando um nome de usuário que contém espaços é especificado, ele precisa ser cercado com aspas (").
Observação
Se um usuário for especificado para inclusão com a opção /ui e também especificado para ser excluído com as /ue opções ou /uel , o usuário será incluído na migração.

Por exemplo:
  • Para incluir apenas o User2 do domínio Fabrikam, insira:

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

  • Para migrar todos os usuários do domínio Fabrikam e somente as contas de usuário de outros domínios que estiverem ativos ou modificados nos últimos 30 dias, insira:

    /uel:30 /ui:fabrikam\*

    Neste exemplo, uma conta de usuário do domínio Contoso que foi modificada pela última vez há dois meses não é migrada.

Para obter mais exemplos, confira as descrições das /ue opções e /ui nesta tabela.
/uel:<NumberOfDays>
or
/uel:<YYYYY/MM/DD>
or
/uel:0
(Exclusão de usuário com base no último logon)

Migra os usuários que se conectaram ao computador de origem no período de tempo especificado, com base na última data modificada do arquivo Ntuser.dat no computador de origem. A /uel opção atua como uma regra de inclusão. Por exemplo, a opção /uel:30 migra usuários que se conectaram ou cuja conta foi modificada nos últimos 30 dias a partir da data em que o ScanState.exe comando é executado.

O número de dias ou a data pode ser especificado. Essa opção não pode ser usada com a opção /all . O USMT recupera as últimas informações de entrada do computador local, portanto, o computador não precisa ser conectado à rede ao executar essa opção. Além disso, se um usuário de domínio entrar em outro computador, o USMT não considerará essa instância de entrada.
Observação
A /uel opção não é válida em migrações offline.
  • /uel:0 migra todos os usuários que estão conectados no momento.
  • /uel:90 migra usuários que se conectaram ou cujas contas foram modificadas de outra forma, nos últimos 90 dias.
  • /uel:1 migra usuários cuja conta foi modificada nas últimas 24 horas.
  • /uel:2020/2/15 migra usuários que fizeram logon ou foram modificados em 15 de fevereiro de 2020 ou posteriores.

Por exemplo:
ScanState.exe /i:MigApp.xml /i:MigDocs.xml \\server\share\migration\mystore /uel:0
/ue:<DomainName>\<UserName>
-ou-

/ue:<ComputerName>\<LocalUserName>
(Exclusão de usuário)

Exclui os usuários especificados da migração. Várias /ue opções podem ser especificadas. Essa opção não pode ser usada com a opção /all . <DomainName> e <UserName> podem conter o caractere curinga asterisco (*). Quando um nome de usuário que contém espaços é especificado, ele precisa ser cercado com aspas (").

Por exemplo:
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \\server\share\migration\mystore /ue:contoso\user1

Como usar /ui e /ue

Os exemplos a /ui seguir se aplicam às opções e /ue . A /ue opção pode ser substituída pela opção /ui de incluir, em vez de excluir, os usuários especificados.

Comportamento Comando
Exclua o usuário chamado User One no domínio Fabrikam. /ue:"fabrikam\user one"
Exclua o usuário chamado User1 no domínio Fabrikam. /ue:fabrikam\user1
Exclua o usuário local chamado User1. /ue:%computername%\user1
Exclua todos os usuários de 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 em conjunto

As /uelopções e /ue/ui podem ser usadas em conjunto para migrar apenas os usuários que precisam ser migrados.

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

A /uel opção tem precedência sobre a opção /ue . Se um usuário estiver conectado dentro do período de tempo especificado definido pela opção, o /uel perfil desse usuário será migrado mesmo que ele seja excluído usando a opção /ue . Por exemplo, se /ue:fixed\user1 /uel:14 for especificado, o User1 será migrado se ele fizer logon no computador nos últimos 14 dias.

Comportamento Comando
Inclua apenas o 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 apenas 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, especifique os seguintes comandos:
  • ScanState.exe Na linha de comando, insira:
    /ue:*\* /ui:contoso\*
  • LoadState.exe Na linha de comando, insira:
    /ue:contoso\user1
Inclua apenas usuários locais (não domínio). /ue:*\* /ui:%computername%\*

Opções de arquivo criptografado

As opções a seguir podem ser usadas para migrar arquivos criptografados. Em todos os casos, por padrão, o USMT falhará se um arquivo criptografado for encontrado, a menos que a opção /efs seja especificada. Para migrar arquivos criptografados, o comportamento padrão deve ser alterado.

Para obter mais informações, consulte Migrar arquivos e certificados EFS.

Observação

Os certificados EFS são migrados automaticamente durante a migração. Portanto, a opção /efs:copyraw deve ser especificada com o ScanState.exe comando para migrar os arquivos criptografados.

Cuidado

Tenha cuidado ao migrar arquivos criptografados. Se um arquivo criptografado for migrado sem também migrar o certificado, os usuários finais não poderão acessar o arquivo após a migração.

Opção Command-Line Explicação
/efs:hardlink Cria um link rígido para o arquivo EFS em vez de copiá-lo. Use somente com as /hardlink/nocompress opções e.
/efs:abort Faz com que o ScanState.exe comando falhe com um código de erro, se um arquivo EFS (Sistema de Arquivos criptografados) for encontrado no computador de origem. Habilitado por padrão.
/efs:skip Faz com que o ScanState.exe comando ignore os arquivos EFS.
/efs:decryptcopy Faz com que o ScanState.exe comando descriptografe o arquivo, se possível, antes de salvá-lo no repositório de migração e falhe se o arquivo não puder ser descriptografado. Se o ScanState.exe comando for bem-sucedido, o arquivo não será criptografado no repositório de migração e, depois que o LoadState.exe comando for executado, o arquivo será copiado para o computador de destino.
/efs:copyraw Faz com que o ScanState.exe comando copie os arquivos no formato criptografado. Os arquivos são inacessíveis no computador de destino até que os certificados EFS sejam migrados. Os certificados EFS são migrados automaticamente; no entanto, por padrão, o USMT falhará se um arquivo criptografado for encontrado, a menos que a opção /efs seja especificada. Portanto, a opção /efs:copyraw deve ser especificada com o ScanState.exe comando para migrar o arquivo criptografado. Quando o LoadState.exe comando é executado, o arquivo criptografado e o certificado EFS são migrados automaticamente.

Por exemplo:
ScanState.exe /i:MigDocs.xml /i:MigApp.xml \server\share\migration\mystore /efs:copyraw
Importante
Todos os arquivos devem ser criptografados se a pasta pai for criptografada. Se o atributo de criptografia em um arquivo dentro de uma pasta criptografada for removido, o arquivo será criptografado durante a migração usando as credenciais da conta usada para executar a ferramenta LoadState . Para obter mais informações, consulte Migrar arquivos e certificados EFS.

Opções de linha de comando incompatíveis

A tabela a seguir indica quais opções de linha de comando não são compatíveis com o ScanState.exe comando. Se a entrada da tabela de uma combinação específica tiver um ✅, as opções serão compatíveis e poderão ser usadas juntas. O ❌ símbolo significa que as opções não são compatíveis. Por exemplo, a opção /nocompress não pode ser usada com a opção /encrypt .

Opção Command-Line /Keyfile /nocompress /genconfig /Todos
/Eu
/o
/V
/nocompress N/D
/Localonly
/Chave
/Criptografar Necessário*
/Keyfile N/D
/L
/listfiles
/Progresso
/R
/W
/C
/P N/D
/Todos
/Ui
/ue
/Uel
/efs:<option>
/genconfig N/D
/Config
<Storepath>

Observação

A opção /key ou /keyfile deve ser especificada com a opção /encrypt .