Set-CMBootImage
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