Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Debug-WcosDevice é um utilitário do PowerShell incluído no WSK que ajuda na configuração do depurador modificando o BCD em dispositivos do sistema operacional de fábrica.
Você pode executar Debug-WcosDevice para configurar dispositivos do sistema operacional de fábrica acessíveis das seguintes maneiras:
- Um VHD montado em um computador técnico
- Por meio do TShell (somente sistema operacional de fábrica)
Carregar o utilitário no PowerShell
Antes de executar o utilitário Debug-WcosDevice, você precisa disponibilizá-lo no computador técnico. Você pode importá-lo para o PowerShell sempre que precisar dele ou carregá-lo automaticamente quando o PowerShell for iniciado.
Opção 1: carregar Debug-WcosDevice para usar em uma única sessão do PowerShell
Set-Location 'D:\Program Files\Windows Kits\10\Tools\Scripts\'
Import-Module .\Debug-WcosDevice.psm1
Onde D:\ é o local do WSK
Opção 2: carregar Debug-WcosDevice por padrão
Você pode configurar o PowerShell no computador técnico para carregar o utilitário Debug-WcosDevice sempre que o PowerShell começar copiando os seguintes arquivos para a pasta de módulos do PowerShell:
md "C:\Program Files\WindowsPowerShell\Modules\debug-WcosDevice"
cd /D "C:\Program Files\WindowsPowerShell\Modules\debug-WcosDevice"
copy D:\Program Files\Windows Kits\10\Tools\Scripts\Debug-WcosDevice\*ps?1
md "C:\Program Files (x86)\WindowsPowerShell\Modules\debug-WcosDevice"
cd /D "C:\Program Files (x86)\WindowsPowerShell\Modules\debug-WcosDevice"
copy D:\\Program Files\Windows Kits\10\Tools\Scripts\Debug-WcosDevice\*ps?1
Onde D:\ é a raiz da sua instalação ou mídia do Windows System Kit.
Obter acesso aos arquivos BCD
Para executar Debug-WcosDevice e configurar a depuração, você precisa ter acesso aos arquivos BCD da imagem do sistema operacional de fábrica. É possível fazer isso da seguinte maneira:
Depois de acessar os arquivos BCD na imagem do sistema operacional de fábrica, você pode começar a trabalhar com Debug-WcosDevice.
Configurar os arquivos BCD para habilitar a depuração
Em um prompt administrativo do PowerShell, use Debug-WcosDevice para modificar o BCD em seu dispositivo do sistema operacional de fábrica para habilitar a depuração. Depois que a depuração é habilitada, o processo de depuração é o mesmo que qualquer outro dispositivo Windows.
Usando Debug-WcosDevice
Para configurar a conexão com o depurador, execute Debug-WcosDevice, especificando um transporte (rede, USB ou serial) para o depurador e quaisquer parâmetros associados.
A sintaxe completa para Debug-WcosDevice está abaixo.
Exemplos:
Configurando o depurador de rede
Debug-WcosDevice NET 10.23.78.12 AllUsar uma conexão TShell já conectada para configurar um depurador de rede
Debug-WcosDevice NET 10.23.78.12 All -TShellConfigurar o depurador na máquina virtual hospedada localmente por conexão serial
Debug-WcosDevice -Transport SERIAL 1 115200 -BootDebug
Depois de usar Debug-WcosDevice para modificar o BCD do dispositivo WCOS, você estará pronto para iniciar a depuração.
sintaxe e parâmetros Debug-WcosDevice
Sintaxe:
Debug-WcosDevice -Transport <NET <IpAddress> [<Bus Params>] [<HIP>] [<Port>]|USB [<Targetname>] [<Bus params>]|SERIAL <DEBUGPORT> [<BAUDRATE>|NOBAUD]|OFF|ON> <BCD Entry Target> [-TShell]
-Parâmetros de transporte
O comutador de transporte é usado para informar ao script o tipo de função de depuração a ser executada. De configurar o transporte de depuração para usar e ativar/desativar o depurador para as opções de inicialização. Os parâmetros a seguir podem ser usados para alterar as configurações de transporte para os transportes individuais.
Use debug-WcosDevice com -Transport NETou -Transport USB-Transport SERIAL para configurar a conexão com o dispositivo do sistema operacional de fábrica.
-Transport NET
Executar Debug-WcosDevice.cmd com a opção de transporte NET permite que você se conecte ao dispositivo do sistema operacional de fábrica por meio de uma conexão de rede.
Sintaxe:
Debug-WcosDevice -Transport NET <IpAddress> [<Bus Params>] [<HIP>] [<Port>] [<Key>] <BCD Entry Target> [-TShell]
Exemplo:
Debug-WcosDevice -Transport NET 10.23.78.12 All
Isso define o depurador de rede usando o endereço IP 10.23.78.12 para HostIP e habilita o depurador em todas as entradas de inicialização. Para KDNET por EEM, use HostIP=169.254.255.255, independentemente do endereço do host.
| Parâmetro | Descrição |
|---|---|
| IpAddress | O endereço HostIp a ser usado com a rede. Na forma de um endereço IP4 1.1.1.1 o padrão é usar o endereço EEM (Modelo de Emulação Ethernet)/IpOverUSB de 169.254.255.255 |
| Params de Barramento | Ao usar o tipo de transporte NET, convém especificar um BDN (Barramento, Dispositivo e Número de Função) específico para usar. Esse valor deve estar em decimal, no formato 1 ou 1.1.1. |
| HIP | Se isso for passado, o script encontrará automaticamente o primeiro endereço IP4 ip a ser usado no host. Não coloque um IpAddress se estiver usando HIP, você receberá um erro. |
| Porta | Isso representa a porta aberta no host que deve estar no intervalo de 49152 a 65535 O padrão é 50000 |
| Chave | Chave de segurança usada para ajudar a proteger a conexão.
Esse script aceita apenas chaves com todas as letras até 4 letras por nó e espera 4 nós. ^[a-zA-Z]{1,4}\.[ a-zA-Z]{1,4}\.[ a-zA-Z]{1,4}\.[ a-zA-Z]{1,4}$ Exemplo: O padrão é 1.2.3.4 (números sim, isso é ok para um padrão) |
| Destino de entrada bcd | Isso identifica a entrada de inicialização para habilitar o depurador. Selecione all ou MainOS ou UpdateOS. O padrão é MainOS |
-Transport USB
Sintaxe:
Executar Debug-WcosDevice.cmd com a opção de transporte USB permite que você se conecte ao dispositivo WCOS por meio de uma conexão USB.
Debug-WcosDevice -Transport USB [<Targetname>] [<Bus params>] <BCD Entry Target> [-TShell]
| Parâmetro | Descrição |
|---|---|
| Params de Barramento | Ao usar o tipo de transporte NET, convém especificar um BDN (Barramento, Dispositivo e Número de Função) específico para usar. Esse valor deve estar em decimal, no formato 1 ou 1.1.1. |
| TargetName | O nome do destino pode ter até 24 caracteres O padrão é WCOSTARGET |
| Destino de entrada bcd | Isso identifica a entrada de inicialização para habilitar o depurador. Selecione all ou MainOS ou UpdateOS. O padrão é MainOS |
-Transport SERIAL
Executar Debug-WcosDevice.cmd com a opção de transporte SERIAL permite que você se conecte ao dispositivo do sistema operacional de fábrica por meio de uma conexão USB.
Sintaxe:
Debug-WcosDevice -Transport SERIAL <DEBUGPORT> [<BAUDRATE>|NOBAUD] <BCD Entry Target> [-TShell]
Exemplo:
Debug-WcosDevice -Transport SERIAL 1 115200 -BootDebug
Confira Depurar em uma conexão serial para saber mais.
| Parâmetro | Descrição |
|---|---|
| DEBUGPORT | A porta de depuração pode estar entre 1 e 99 |
| BAUDRATE | Baudrate pode ser 300 ou mais. |
| NOBAUD | Isso instruirá o sistema a não definir a taxa BAUD. |
| Destino de entrada bcd | Isso identifica a entrada de inicialização para habilitar o depurador. Selecione ALL ou MainOS ou UpdateOS. O padrão é MainOS |
-Transport OFF ou ON
Exemplo:
Debug-WcosDevice -Transport OFF
| Parâmetro | Descrição |
|---|---|
| Nenhum | Ativa ou desativa o depurador com base no valor de transporte de ON ou OFF |
Parâmetros que não são de transporte
Observação
Esses parâmetros são precedidos por um obrigatório -.
| Parâmetro | Descrição |
|---|---|
| -TShell | Isso informa ao script que você está executando no TShell e que a configuração de depuração deve ser feita no dispositivo conectado por meio da conexão do TShell. |
| -BootDebug | Isso instrui o script a também fazer alterações no bootdebugger, incluindo na opção de inicialização {bootmgr}. |
| -UserPaths | Esses são caminhos parciais para o repositório bcd. O script acrescentará efi\Microsoft\boot\bcd ou boot\bcd ao caminho e marcar para ver se o arquivo existe.
O formato é |