Partilhar via


Sintaxe ScanState

O ScanState.exe comando é utilizado com a Ferramenta de Migração de Estado do Utilizador (USMT) para analisar o computador de origem, recolher os ficheiros e definições e criar um arquivo. Este artigo aborda a ScanState.exe sintaxe do comando e as opções disponíveis.

Antes de começar

Antes de executar o ScanState.exe comando, tenha em atenção os itens:

  • Para garantir que todas as definições do sistema operativo são migradas, execute os ScanState.exe comandos no modo de administrador a partir de uma conta com credenciais administrativas.

  • Se o arquivo de migração estiver encriptado, é necessária uma chave de encriptação ou um caminho para um ficheiro que contenha a chave de encriptação. Certifique-se de que anota a chave ou a localização do ficheiro de chave, uma vez que estas informações não são mantidas em nenhum lugar no arquivo de migração. Estas informações são necessárias quando o LoadState.exe comando é executado para desencriptar o arquivo de migração ou se o utilitário de recuperação precisa de ser utilizado. Um ficheiro de chave ou chave incorreto ou em falta resulta numa mensagem de erro.

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

  • Salvo indicação em contrário, utilize cada opção apenas uma vez ao executar uma ferramenta na linha de comandos.

  • As contas de domínio podem ser recolhidas sem que o computador de origem tenha acesso ao controlador de domínio. Esta funcionalidade está disponível sem qualquer configuração adicional.

  • A tabela de opções da linha de comandos Incompatível lista as opções que podem ser utilizadas em conjunto e quais as opções da linha de comandos incompatíveis.

  • A localização do diretório onde o arquivo de migração é guardado é excluída da análise. Por exemplo, se o arquivo de migração for guardado na raiz da unidade D, a unidade D e todos os respetivos subdiretórios serão excluídos da análise.

Sintaxe

Esta secção explica a sintaxe e a utilização das opções da linha de comandos disponíveis ao utilizar o ScanState.exe comando . As opções podem ser especificadas por qualquer ordem. Se a opção contiver um parâmetro, pode ser utilizado um separador de dois pontos ou um separador de espaço.

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|YYYY/MM/DD|0] [/efs:abort|skip|decryptcopy|copyraw] [/genconfig:[Path\]FileName[/config:[Path\]FileName] [/?|ajuda]

Por exemplo, para criar um Config.xml ficheiro no diretório atual, utilize:

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

Para criar um arquivo encriptado com o Config.xml ficheiro e a migração predefinida .xml ficheiros, utilize:

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 onde os ficheiros e as definições são guardados. StorePath não pode ser C:\. A opção StorePath tem de ser especificada no ScanState.exe comando, exceto quando utilizar a opção /genconfig . Não é possível especificar mais do que uma localização do StorePath .
/apps Analisa a imagem das aplicações e inclui-as e as respetivas definições de registo associadas.
/ppkg [<FileName>] Exporta para uma localização de ficheiro específica.
/o Necessário para substituir quaisquer dados existentes no arquivo ou Config.xml ficheiro de migração. Se não for especificado, o ScanState.exe comando falhará se o arquivo de migração já contiver dados. Esta opção não pode ser utilizada mais do que uma vez numa linha de comandos.
/vsc Esta opção permite ao serviço de cópia sombra de volumes migrar ficheiros bloqueados ou em utilização. Esta opção de linha de comandos elimina a maioria dos erros de bloqueio de ficheiros que normalmente são encontrados pela <secção ErrorControl> .

Esta opção só é utilizada com o ficheiro executável ScanState e não pode ser combinada com a opção /hardlink .
/hardlink Permite a criação de um arquivo de migração hard-link na localização especificada. A /nocompress opção tem de ser especificada com a opção /hardlink .
/encrypt [{/key:<KeyString> | /keyfile:<file>]} Encripta o arquivo com a chave especificada. A encriptação está desativada por predefinição. Com esta opção, a chave de encriptação tem de ser especificada de uma das seguintes formas:
  • /key: KeyString especifica a chave de encriptação. Se existir um espaço em KeyString, o KeyString tem de estar entre aspas (").
  • /keyfile: FilePathAndName especifica um ficheiro de texto (.txt) que contém a chave de encriptação.

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

O exemplo seguinte 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 comandos para definir a força de encriptação a ser utilizada para encriptação do arquivo de migração. Para obter mais informações sobre os algoritmos de encriptação suportados, veja Encriptação do Arquivo de Migração.
/nocompress Desativa a compressão de dados e guarda os ficheiros numa pasta oculta chamada "Ficheiro" em StorePath\USMT. A compressão está ativada por predefinição. Combinar a opção /nocompress com a opção /hardlink gera um arquivo de migração hard-link. O arquivo não comprimido pode ser utilizado para ver que USMT armazenou, resolver um problema ou executar um utilitário antivírus nos ficheiros. Esta opção só deve ser utilizada em ambientes de teste. A Microsoft recomenda a utilização de um arquivo comprimido 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 utilizadas em conjunto numa instrução na linha de comandos. No entanto, se um arquivo não comprimido for migrado, o LoadState.exe comando migra cada ficheiro diretamente do arquivo para a localização correta no computador de destino sem uma localização temporária.

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

Executar o comando ScanState num sistema Windows offline

O ScanState.exe comando pode ser executado no Ambiente de Pré-instalação do Windows (WinPE). Além disso, o USMT suporta 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 num diretório Windows.old quando o ScanState.exe comando é executado no Windows.

Existem várias vantagens em executar o comando numa imagem offline do ScanState.exe Windows, incluindo:

  • Desempenho melhorado.

    Uma vez que o WinPE é um sistema operativo dinâmico, existem menos serviços em execução. Neste ambiente, o ScanState.exe comando tem mais acesso aos recursos de hardware locais, permitindo ao ScanState realizar operações de migração mais rapidamente.

  • Processo de implementação ponto a ponto simplificado.

    A migração de dados do Windows.old simplifica o processo de implementação ponto a ponto ao permitir que o processo de migração ocorra após a instalação do novo sistema operativo.

  • Melhoramento do sucesso da migração.

    A taxa de êxito da migração foi aumentada porque:

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

    Poderá ser possível recuperar e migrar dados de um computador que não arranca.

Opções de migração offline

Opção Command-Line Definição
/offline:"caminho para um ficheiro de Offline.xml" Esta opção é utilizada para definir um caminho para um ficheiro 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" Esta opção especifica o diretório offline do Windows a partir do qual o comando recolhe o ScanState.exe estado do utilizador. O diretório offline pode ser Windows.old quando o ScanState.exe comando é executado no Windows ou num diretório do Windows quando o ScanState.exe comando é executado no WinPE.
/offlinewinold:"Diretório Windows.old" Esta opção de linha de comandos ativa o modo de migração offline e inicia a migração a partir da localização especificada. Esta opção destina-se apenas a ser utilizada em cenários de migração windows.old , em que a migração está a ocorrer a partir de um diretório Windows.old .

Opções de regras de migração

O USMT fornece as seguintes opções para especificar os ficheiros a migrar.

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

Especifica um ficheiro de.xml que contém regras que definem o estado do utilizador, da aplicação ou do sistema a migrar. Esta opção pode ser especificada várias vezes para incluir todos os ficheiros de.xml (MigApp.xml, MigDocs.xmle quaisquer ficheiros de.xml personalizados criados). O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, o FileName tem de estar localizado no diretório atual. Para obter mais informações sobre os ficheiros a especificar, consulte a secção "Ficheiros XML" do artigo Perguntas mais frequentes .
/genconfig:[Path]FileName (Gerar Config.xml)

Gera o ficheiro opcional Config.xml , mas não cria um arquivo de migração. Para garantir que este ficheiro contém tudo o que precisa de ser migrado, crie este ficheiro num computador de origem que contenha todos os:
  • componentes
  • applications
  • settings
presentes nos computadores de destino. Além disso, a outra migração .xml ficheiros deve ser especificada, utilizando a opção /i , quando esta opção é especificada.

Depois de criar este ficheiro, pode ser utilizado com o ScanState.exe comando com a opção /config .

As únicas opções que podem ser especificadas com esta opção são as /iopções , /ve /l . Não é possível especificar o StorePath porque a opção /genconfig não cria um arquivo. O caminho pode ser um caminho relativo ou completo. Se a variável Path não for especificada, fileName é criado no diretório atual.

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

O exemplo seguinte cria um arquivo com o Config.xml ficheiro , MigDocs.xmle MigApp.xml os ficheiros:
ScanState.exe \server\share\migration\mystore /config:Config.xml /i:MigDocs.xml /i:MigApp.xml /v:13 /l:ScanState.log

O exemplo seguinte migra os ficheiros e definições para o computador de destino com os Config.xmlficheiros , 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 ficheiros de script Esta opção permite especificar a localização dos ficheiros de.xmlpredefinidos . Se não for especificado nenhum caminho, a USMT referencia o diretório onde estão localizados os binários USMT. A /auto opção tem o mesmo efeito que utilizar as seguintes opções: /i: MigDocs.xml /i:MigApp.xml /v:5.
/genmigxml:path para um ficheiro Esta opção especifica que o ScanState.exe comando deve utilizar o finder de documentos para criar e exportar um ficheiro de.xml que define como migrar todos os ficheiros no computador em que o ScanState.exe comando está a ser executado.
/localmente Migra apenas os ficheiros armazenados no computador local, independentemente das regras nos ficheiros de.xml especificados na linha de comandos. Esta opção deve ser utilizada para excluir os dados de unidades amovíveis no computador de origem e quando existem unidades de rede mapeadas no computador de origem. Exemplos de unidades amovíveis incluem pens USB (UFDs) e alguns discos rígidos externos. Se a opção /localonly não for especificada, o ScanState.exe comando copia ficheiros destas unidades amovíveis ou de rede para o arquivo.

/localonly exclui tudo o que não seja considerado uma unidade fixa pelo SO. Em alguns casos, os discos rígidos externos grandes são considerados unidades fixas. Estas unidades podem ser explicitamente excluídas da migração através de um ficheiro de.xml personalizado. Para obter mais informações sobre como excluir todos os ficheiros numa unidade específica, veja Excluir ficheiros e definições.

A /localonly opção da linha de comandos inclui ou exclui dados na migração, conforme identificado nas seguintes localizações de armazenamento:
  • Unidades amovíveis, como uma pen USB – Excluída
  • Unidades de rede – Excluídas
  • Unidades fixas - Incluídas

Opções de monitorização

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

Observação

O registo ScanState é criado por predefinição, mas o nome e a localização do registo podem ser especificados com a opção /l .

Opção Command-Line Descrição
/listfiles:<FileName> A /listfiles opção da linha de comandos pode ser utilizada com o ScanState.exe comando para gerar um ficheiro de texto que lista todos os ficheiros incluídos na migração.
/l:[Path]FileName Especifica a localização e o nome do registo ScanState .

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

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

O USMT não conseguiu criar o(s) ficheiro(s) de registo(s)

Para corrigir este problema, certifique-se de que especifica a opção /l ao executar ScanState.exe a partir de um recurso de rede partilhado.
/v:<VerbosityLevel> (Verbosidade)

Ativa a saída verbosa no ficheiro de registo ScanState . O valor padrão é 0.

O VerbosityLevel pode ser definido para um dos seguintes níveis:
  • 0 - Apenas os erros e avisos predefinidos estão ativados.
  • 1 - Ativa a saída verbosa.
  • 4 - Ativa o erro e a saída do estado.
  • 5 - Ativa a saída verbosa e de estado.
  • 8 - Ativa a saída do erro para um depurador.
  • 9 - Ativa a saída verbosa para um depurador.
  • 12 - Ativa o erro e a saída de estado para um depurador.
  • 13 - Ativa a saída verbosa, de estado e depurador.

Por exemplo:
ScanState.exe \server\share\migration\mystore /v:13 /i:MigDocs.xml /i:MigApp.xml
/progress:[Path]FileName Cria o registo de progresso opcional. Os ficheiros de registo 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 é 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 esta opção é especificada, o ScanState.exe comando continua a ser executado, mesmo que ocorram erros não fatais. Todos os ficheiros ou definições que causem um erro são registados no registo de progresso. Por exemplo, se existir um ficheiro grande que não cabe no arquivo, o ScanState.exe comando regista um erro e continua a migração. Além disso, se um ficheiro estiver aberto ou a ser utilizado por uma aplicação, o USMT poderá não conseguir migrar o ficheiro e registar um erro. Sem a opção /c , o ScanState.exe comando sai no primeiro erro.

A < secção ErrorControl> no Config.xml ficheiro pode ser utilizada para especificar que erros de leitura/escrita de ficheiros ou registos podem ser ignorados com segurança e que podem fazer com que a migração falhe. Esta vantagem no Config.xml ficheiro permite que a opção da /c linha de comandos ignore em segurança todos os erros de entrada/saída (E/S) no ambiente. Além disso, a opção /genconfiggera agora uma < secção ErrorControl> de exemplo que está ativada ao especificar mensagens de erro e comportamentos pretendidos no Config.xml ficheiro.
/r:<TimesToRetry> (Repetir)

Especifica o número de vezes que tentar novamente quando ocorre um erro ao guardar o estado do utilizador num servidor. A predefinição é três vezes. Esta opção é útil em ambientes onde a conectividade de rede não é fiável.

Quando o estado do utilizador é armazenado, a opção /r não consegue recuperar dados perdidos devido a uma falha de hardware de rede, como um cabo de rede com falhas ou desligado, ou quando uma ligação de rede privada virtual (VPN) falha. 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 a aguardar, em segundos, antes de repetir uma operação de ficheiro de rede. A predefinição é de 1 segundo.
/p:<pathToFile> Quando o ScanState.exe comando é executado, cria um ficheiro .xml no caminho especificado. Este ficheiro.xml inclui estimativas de espaço melhoradas para o arquivo de migração. O exemplo seguinte mostra como criar este ficheiro de.xml :
ScanState.exe C:\MigrationLocation [additional parameters]
/p:"C:\MigrationStoreSize.xml"

Para obter mais informações, veja Estimar o Tamanho do Arquivo de Migração.

Para preservar a funcionalidade de aplicações ou scripts existentes que requerem o comportamento anterior do USMT, a opção /p pode ser utilizada, sem especificar "pathtoafile", no USMT. Se apenas a opção /p for especificada, as estimativas de espaço de armazenamento são criadas da mesma forma que com as versões USMT 3.x.
/? ou /help Apresenta a Ajuda na linha de comandos.

Opções de utilizador

Por predefinição, todos os utilizadores são migrados. A única forma de especificar os utilizadores a incluir e excluir é através das seguintes opções. Os utilizadores não podem ser excluídos na migração .xml ficheiros ou através do Config.xml ficheiro. Para obter mais informações, veja Identificar utilizadores e Migrar contas de utilizador.

Opção Command-Line Descrição
/all Migra todos os utilizadores no computador.

O USMT migra todas as contas de utilizador no computador, a menos que uma conta seja especificamente excluída com as /ue opções ou /uel . Por este motivo, esta opção não precisa de ser especificada na linha de comandos. No entanto, se a opção /all for especificada, as /uiopções ou /ue/uel também não podem ser especificadas.
/ui:<DomainName>\<UserName>
or
/ui:<ComputerName>\<LocalUserName>
(Inclusão do utilizador)

Migra os utilizadores especificados. Por predefinição, todos os utilizadores estão incluídos na migração. Por conseguinte, esta opção só é útil quando utilizada com as /ue opções ou /uel . Podem ser especificadas várias /ui opções, mas a opção /ui não pode ser utilizada com a opção /all . DomainName e UserName podem conter o caráter universal asterisco (*). Quando um nome de utilizador que contém espaços é especificado, tem de estar entre aspas (").
Observação
Se um utilizador for especificado para inclusão com a opção /ui e também for especificado para ser excluído com as /ue opções ou /uel , o utilizador será incluído na migração.

Por exemplo:
  • Para incluir apenas o Utilizador2 do domínio Fabrikam, introduza:

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

  • Para migrar todos os utilizadores do domínio fabrikam e apenas as contas de utilizador de outros domínios que estejam ativos ou modificados nos últimos 30 dias, introduza:

    /uel:30 /ui:fabrikam\*

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

Para obter mais exemplos, veja as descrições das /ue opções e /ui nesta tabela.
/uel:<NumberOfDays>
or
/uel:<AAAA/MM/DD>
or
/uel:0
(Exclusão do utilizador com base no último início de sessão)

Migra os utilizadores que iniciaram sessão no computador de origem no período de tempo especificado, com base na data da Última Modificação do ficheiro Ntuser.dat no computador de origem. A /uel opção funciona como uma regra de inclusão. Por exemplo, a opção migra os /uel:30 utilizadores que iniciaram sessão 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. Esta opção não pode ser utilizada com a opção /all . O USMT obtém as últimas informações de início de sessão do computador local, pelo que o computador não precisa de estar ligado à rede ao executar esta opção. Além disso, se um utilizador de domínio iniciar sessão noutro computador, a USMT não considerará essa instância de início de sessão.
Observação
A /uel opção não é válida em migrações offline.
  • /uel:0 migra todos os utilizadores com sessão iniciada.
  • /uel:90 migra os utilizadores que iniciaram sessão ou cujas contas foram modificadas nos últimos 90 dias.
  • /uel:1 migra os utilizadores cuja conta foi modificada nas últimas 24 horas.
  • /uel:2020/2/15 migra os utilizadores que iniciaram sessão ou foram modificados a 15 de fevereiro de 2020 ou posterior.

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 do utilizador)

Exclui os utilizadores especificados da migração. Podem ser especificadas várias /ue opções. Esta opção não pode ser utilizada com a opção /all . <DomainName> e <UserName> podem conter o caráter universal asterisco (*). Quando um nome de utilizador que contém espaços é especificado, tem de estar entre aspas (").

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

Como utilizar /ui e /ue

Os exemplos seguintes aplicam-se às /ui opções e /ue . A /ue opção pode ser substituída pela opção /ui para incluir, em vez de excluir, os utilizadores especificados.

Comportamento Comando
Exclua o utilizador com o nome User One no domínio Fabrikam. /ue:"fabrikam\user one"
Exclua o utilizador com o nome User1 no domínio Fabrikam. /ue:fabrikam\user1
Exclua o utilizador local com o nome User1. /ue:%computername%\user1
Excluir todos os utilizadores de domínio. /ue:Domain\*
Excluir todos os utilizadores locais. /ue:%computername%\*
Exclua utilizadores em todos os domínios denominados Utilizador1, Utilizador2, entre outros. /ue:*\user*

Utilizar as opções em conjunto

As /uelopções e /ue/ui podem ser utilizadas em conjunto para migrar apenas os utilizadores que precisam de ser migrados.

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

A /uel opção tem precedência sobre a opção /ue . Se um utilizador tiver iniciado sessão no período de tempo especificado definido pela opção, o /uel perfil desse utilizador será migrado mesmo que seja excluído através da opção /ue . Por exemplo, se /ue:fixed\user1 /uel:14 for especificado, o Utilizador1 será migrado se tiver iniciado sessão no computador nos últimos 14 dias.

Comportamento Comando
Inclua apenas o Utilizador2 do domínio Fabrikam e exclua todos os outros utilizadores. /ue:*\* /ui:fabrikam\user2
Inclua apenas o utilizador local com o nome User1 e exclua todos os outros utilizadores. /ue:*\* /ui:user1
Inclua apenas os utilizadores de domínio da Contoso, exceto Contoso\User1. Este comportamento não pode ser concluído com um único comando. Em vez disso, para migrar este conjunto de utilizadores, especifique os seguintes comandos:
  • ScanState.exe Na linha de comandos, introduza:
    /ue:*\* /ui:contoso\*
  • LoadState.exe Na linha de comandos, introduza:
    /ue:contoso\user1
Inclua apenas utilizadores locais (não domínios). /ue:*\* /ui:%computername%\*

Opções de ficheiro encriptado

As seguintes opções podem ser utilizadas para migrar ficheiros encriptados. Em todos os casos, por predefinição, o USMT falha se for encontrado um ficheiro encriptado, a menos que a opção /efs seja especificada. Para migrar ficheiros encriptados, o comportamento predefinido tem de ser alterado.

Para obter mais informações, veja Migrar Ficheiros e Certificados EFS.

Observação

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

Cuidado

Tenha cuidado ao migrar ficheiros encriptados. Se um ficheiro encriptado for migrado sem também migrar o certificado, os utilizadores finais não poderão aceder ao ficheiro após a migração.

Opção Command-Line Explicação
/efs:hardlink Cria uma ligação rígida para o ficheiro EFS em vez de o copiar. Utilize apenas com as /hardlink opções e /nocompress .
/efs:abort Faz com que o ScanState.exe comando falhe com um código de erro, se for encontrado um ficheiro do Sistema de Encriptação de Ficheiros (EFS) no computador de origem. Ativado por predefinição.
/efs:skip Faz com que o ScanState.exe comando ignore os ficheiros EFS.
/efs:decryptcopy Faz com que o ScanState.exe comando desencripte o ficheiro, se possível, antes de o guardar no arquivo de migração e falhar se não for possível desencriptar o ficheiro. Se o ScanState.exe comando for bem-sucedido, o ficheiro não é encriptado no arquivo de migração e, assim que o LoadState.exe comando for executado, o ficheiro é copiado para o computador de destino.
/efs:copyraw Faz com que o ScanState.exe comando copie os ficheiros no formato encriptado. Os ficheiros estão inacessíveis no computador de destino até que os certificados EFS sejam migrados. Os certificados EFS são migrados automaticamente; no entanto, por predefinição, o USMT falha se for encontrado um ficheiro encriptado, a menos que a opção /efs seja especificada. Por conseguinte, a opção /efs:copyraw deve ser especificada com o ScanState.exe comando para migrar o ficheiro encriptado. Quando o LoadState.exe comando é executado, o ficheiro encriptado 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 ficheiros têm de ser encriptados se a pasta principal estiver encriptada. Se o atributo de encriptação num ficheiro dentro de uma pasta encriptada for removido, o ficheiro será encriptado durante a migração com as credenciais da conta utilizada para executar a ferramenta LoadState . Para obter mais informações, veja Migrar ficheiros e certificados EFS.

Opções de linha de comandos incompatíveis

A tabela seguinte indica quais as opções da linha de comandos que não são compatíveis com o ScanState.exe comando . Se a entrada de tabela para uma combinação específica tiver um ✅, as opções são compatíveis e podem ser utilizadas em conjunto. O ❌ símbolo significa que as opções não são compatíveis. Por exemplo, a opção /nocompress não pode ser utilizada com a opção /encrypt .

Opção Command-Line /keyfile /nocompress /genconfig /all
/eu
/o
/v
/nocompress N/D
/localmente
/key
/encrypt Necessário*
/keyfile N/D
/l
/listfiles
/progress
/r
/w
/c
/p N/D
/all
/ui
/ue
/uel
/efs:<option>
/genconfig N/D
/config
<StorePath>

Observação

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