Set-CMBootImage

Referência

Módulo:: ConfigurationManager

Modificar uma imagem de arranque do SO.

Sintaxe

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   -Id <String>
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBootImage
   [-AddOptionalComponent <IResultObject[]>]
   [-BackgroundBitmapPath <String>]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-DeployFromPxeDistributionPoint <Boolean>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-EnableCommandSupport <Boolean>]
   [-EnablePrestartCommand <Boolean>]
   [-Force]
   [-IncludeFilesForPrestart <Boolean>]
   [-InputLocale <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-PrestartCommandLine <String>]
   [-PrestartIncludeFilesDirectory <String>]
   [-Priority <Priority>]
   [-Reload]
   [-RemoveOptionalComponent <IResultObject[]>]
   [-ScratchSpace <UInt32>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para modificar uma imagem de arranque do SO. As imagens de arranque são imagens do Ambiente de Pré-instalação do Windows (Windows PE) nas quais arranca um computador cliente antes de instalar um SO.

Pode adicionar controladores de dispositivo a uma imagem de arranque ou alterar as respetivas propriedades. Antes de poder adicionar um novo controlador de dispositivo, primeiro tem de importar o controlador para o catálogo de controladores do Configuration Manager e ativá-lo.

Cada versão do Configuration Manager suporta uma versão específica do Windows Assessment and Deployment Kit (Windows ADK). Pode utilizar ou personalizar imagens de arranque quando são baseadas numa versão do Windows PE a partir da versão suportada do Windows ADK.

Para obter mais informações, veja Gerir imagens de arranque com o Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Mudar o nome de uma imagem de arranque

Este comando obtém uma imagem de arranque pelo respetivo ID de pacote e, em seguida, muda o nome da mesma.

Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"

Exemplo 2: Definir propriedades descritivas

Este comando obtém uma imagem de arranque pelo respetivo nome e, em seguida, adiciona uma versão e uma descrição à mesma.

Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"

Exemplo 3: Definir o esquema de teclado

O exemplo seguinte define o esquema de teclado predefinido da imagem de arranque para o idioma russo (Rússia ). Identifica a imagem de arranque pelo respetivo ID.

Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"

Exemplo 4: Adicionar componentes opcionais

Este exemplo obtém os componentes opcionais .NET e PowerShell e, em seguida, adiciona-os à imagem de arranque.

$netfxOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-NetFX' -LanguageId 1033
$pwshOC = Get-CMWinPEOptionalComponentInfo -Architecture 'x64' -Name 'WinPE-PowerShell' -LanguageId 1033
$OCs = @($netfxOC, $pwshOC)

Set-CMBootImage -Id 'XYZ00556' -AddOptionalComponent $OCs

Parâmetros

-AddOptionalComponent

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.

Tipo:	IResultObject[]
Aliases:	AddOptionalComponents
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BackgroundBitmapPath

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CopyToPackageShareOnDistributionPoint

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.

Tipo:	Boolean
Aliases:	CopyToPackageShareOnDistributionPoints
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CustomPackageShareName

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.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DeployFromPxeDistributionPoint

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.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Description

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisconnectUserFromDistributionPoint

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

Tipo:	Boolean
Aliases:	DisconnectUsersFromDistributionPoints
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisconnectUserFromDistributionPointMins

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

Tipo:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsMinutes
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisconnectUserFromDistributionPointRetryCount

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

Tipo:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsRetries
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DistributionPointUpdateSchedule

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 .

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableBinaryDeltaReplication

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.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableCommandSupport

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.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnablePrestartCommand

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.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Force

Execute o comando sem pedir confirmação.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Id

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

Tipo:	String
Aliases:	PackageId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IncludeFilesForPrestart

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.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputLocale

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).

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

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

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Especifique o nome de uma imagem de arranque a configurar.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NewName

Especifique um novo nome para a imagem de arranque.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

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.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Path

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.

Tipo:	String
Aliases:	ImagePath
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PersistContentInCache

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.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PrestageBehavior

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.

Tipo:	PrestageBehavior
Valores aceitos:	ManualCopy, DownloadDelta, OnDemand
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PrestartCommandLine

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 .

Tipo:	String
Aliases:	CommandLine
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PrestartIncludeFilesDirectory

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Priority

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.

Tipo:	Priority
Valores aceitos:	High, Medium, Low
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Reload

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.

Tipo:	SwitchParameter
Aliases:	ReloadImage
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveOptionalComponent

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)

Tipo:	IResultObject[]
Aliases:	RemoveOptionalComponents
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ScratchSpace

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.

Tipo:	UInt32
Valores aceitos:	32, 64, 128, 256, 512
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SendToPreferredDistributionPoint

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.

Tipo:	Boolean
Aliases:	SendToPreferredDistributionPoints
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Version

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Compartilhar via