Set-CMBootImage

Especifique uma matriz de objetos de componente opcionais a adicionar à imagem de arranque. Para obter este objeto, utilize o cmdlet Get-CMWinPEOptionalComponentInfo .

Os seguintes componentes são normalmente utilizados:

• Microsoft .NET (WinPE-NetFX): este componente é um pré-requisito do PowerShell. É um dos componentes opcionais maiores.
• Windows PowerShell (WinPE-PowerShell): este componente necessita de .NET e adiciona suporte limitado do PowerShell. Se executar scripts personalizados do PowerShell durante a fase WinPE da sequência de tarefas, adicione este componente. Existem outros componentes que podem ser necessários para outros cmdlets do PowerShell.
• HTML (WinPE-HTA): se executar aplicações HTML personalizadas durante a fase WinPE da sequência de tarefas, adicione este componente.

Para obter mais informações, veja Gerir imagens de arranque – componentes opcionais.

Especifique o caminho do ficheiro de rede de um ficheiro de imagem de fundo personalizado a utilizar no Windows PE.

Solicita a confirmação antes de executar o cmdlet.

Os clientes podem sempre transferir uma imagem de arranque a partir de um ponto de distribuição. Se definir este parâmetro como $true, o site disponibiliza-o através de uma partilha de rede nomeada em pontos de distribuição. Utilize CustomPackageShareName para especificar um nome de partilha personalizado.

Quando ativa esta opção, é necessário mais espaço nos pontos de distribuição. Aplica-se a todos os pontos de distribuição aos quais distribui esta imagem de arranque.

Se ativar CopyToPackageShareOnDistributionPoint, pode utilizar este parâmetro para personalizar o nome da partilha. O comprimento máximo é de 127 carateres e não pode incluir nenhum dos seguintes carateres: " / [ ] : | < > + = ; , ? *. Pode especificar um nome de partilha e um nome de pasta, mas o máximo para cada um é de 80 carateres. Por exemplo, ShareName\FolderName.

Defina este parâmetro como $true para disponibilizar esta imagem de arranque a partir de um ponto de distribuição preparado para PXE. Para obter mais informações, consulte Utilizar o PXE para implementar o Windows através da rede.

Especifique uma descrição opcional de uma imagem de arranque para o ajudar a identificá-la.

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Esta opção foi preterida. Define a propriedade ForcedDisconnectEnabled da imagem de arranque.

Esta opção foi preterida. Define a propriedade ForcedDisconnectDelay da imagem de arranque.

Esta opção foi preterida. Define a propriedade ForcedDisconnectNumRetries da imagem de arranque.

Utilize este parâmetro para atualizar pontos de distribuição com base numa agenda. Para obter um objeto de agendamento, utilize o cmdlet New-CMSchedule .

Defina este parâmetro como $true para ativar a replicação diferencial binária (BDR). Para obter mais informações, veja Conceitos fundamentais para a gestão de conteúdos no Configuration Manager.

Apenas em ambientes de teste de não produção, pode definir este parâmetro como $true para ativar o suporte de comandos. Quando um dispositivo arranca nesta imagem, pode premir F8 para abrir uma linha de comandos administrativa. Esta opção é útil para a resolução de problemas enquanto testa a implementação. A utilização desta definição numa implementação de produção não é aconselhada devido a questões de segurança.

Defina este parâmetro como $true para ativar um comando de pré-início. Esta linha de comandos é executada antes do início da sequência de tarefas.

Configure também os seguintes parâmetros: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.

Execute o comando sem pedir confirmação.

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Especifique um ID de imagem de arranque a configurar. Este valor é um ID de pacote padrão, por exemplo: XYZ00002.

Se ativar EnablePrestartCommand, utilize este parâmetro se o comando de pré-início exigir a execução de outros ficheiros. Em seguida, utilize o parâmetro PrestartIncludeFilesDirectory para especificar a localização dos ficheiros a incluir.

Por exemplo, se quiser executar um script de lote, utilize esta opção para incluir o ficheiro de script.

Utilize este parâmetro para configurar o esquema de teclado predefinido para uma imagem de arranque. Especifique a etiqueta de idioma. Por exemplo, para definir a região de entrada como russo (Rússia), especifique a cadeia ru-ru. Para obter mais informações, consulte [MS-LCID]: Referência do Identificador de Código de Idioma do Windows (LCID).

Especifique um objeto de imagem de arranque a configurar. Para obter este objeto, utilize o cmdlet Get-CMBootImage .

Especifique o nome de uma imagem de arranque a configurar.

Especifique um novo nome para a imagem de arranque.

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Especifique o caminho de rede da imagem do Windows PE que esta imagem de arranque utiliza. Não pode alterar o caminho para imagens de arranque predefinidas.

Se não quiser que o conteúdo deste pacote fique fora da cache do cliente para libertar espaço para outros conteúdos, defina este parâmetro como $true para o manter na cache do cliente.

Especifique o comportamento quando ativa um ponto de distribuição para conteúdo pré-configurado:

• ManualCopy: copie manualmente o conteúdo deste pacote para o ponto de distribuição
• DownloadDelta: transferir apenas alterações de conteúdo para o ponto de distribuição
• OnDemand: transferir automaticamente conteúdo quando os pacotes são atribuídos a pontos de distribuição

Para obter mais informações, veja Utilizar conteúdo pré-configurado.

Se ativar EnablePrestartCommand, utilize este parâmetro para especificar a linha de comandos a executar. O comprimento máximo é de 4096 carateres.

Se a linha de comandos necessitar de ficheiros que não estejam no Windows PE, utilize os parâmetros IncludeFilesForPrestart e PrestartIncludeFilesDirectory .

Se ativar EnablePrestartCommand e IncludeFilesForPrestart, utilize este parâmetro para especificar o caminho de rede dos ficheiros a incluir na imagem de arranque.

Especifique a ordem pela qual o site envia o conteúdo para outros sites e os pontos de distribuição neste site.

O site envia conteúdo de alta prioridade antes de pacotes com prioridade média ou baixa. Os pacotes com prioridade igual são enviados pela ordem em que são criados.

Aplica-se à versão 2006 e posterior. Se as versões dos componentes do Windows ADK na imagem de arranque estiverem desatualizadas, adicione este parâmetro para recarregar a imagem de arranque com a versão atual do Windows PE a partir do Windows ADK. Para obter mais informações, consulte Atualizar pontos de distribuição com a imagem de arranque.

Especifique uma matriz de objetos de componente opcionais a remover da imagem de arranque. Para obter este objeto, utilize o cmdlet Get-CMWinPEOptionalComponentInfo .

Não remova os seguintes componentes, que são necessários pelo Configuration Manager:

• Scripting (WinPE-Scripting)
• Arranque (WinPE-SecureStartup)
• Rede (WinPE-WDS-Tools)
• Scripting (WinPE-WMI)

Configure o espaço de rascunho do Windows PE, que é o armazenamento temporário (unidade de RAM) utilizado pelo WinPE. Por exemplo, quando uma aplicação é executada no WinPE e precisa de escrever ficheiros temporários, o WinPE redireciona os ficheiros para o espaço de rascunho na memória para simular a presença de um disco rígido. Por predefinição, este valor é de 512 MB para dispositivos com mais de 1 GB de RAM, caso contrário, a predefinição é de 32 MB.

Se quiser ativar a distribuição de conteúdos a pedido para pontos de distribuição preferenciais, defina este parâmetro como $true. Quando ativa esta definição, se um cliente pedir o conteúdo do pacote e o conteúdo não estiver disponível em pontos de distribuição, o ponto de gestão distribui o conteúdo. Para obter mais informações, veja Distribuição de conteúdos a pedido.

Especifique a versão da imagem de arranque. Este valor não é a versão do SO, mas sim uma cadeia que gere.

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.