Set-CMBootImage
Modifique uma imagem de inicialização do sistema operacional.
Syntax
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
Use este cmdlet para modificar uma imagem de inicialização do sistema operacional. As imagens de inicialização são imagens do Windows Preinstallation Environment (Windows PE) nas quais você inicializa um computador cliente antes de instalar um sistema operacional.
Você pode adicionar drivers de dispositivo a uma imagem de inicialização ou alterar suas propriedades. Antes de adicionar um novo driver de dispositivo, primeiro você deve importar o driver para o catálogo de driver Configuration Manager e habilitá-lo.
Cada versão do Configuration Manager dá suporte a uma versão específica do Windows Assessment and Deployment Kit (Windows ADK). Você pode atender ou personalizar imagens de inicialização quando elas se baseiam em uma versão do Windows PE da versão com suporte do Windows ADK.
Para obter mais informações, consulte Gerenciar imagens de inicialização com Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: renomear uma imagem de inicialização
Esse comando obtém uma imagem de inicialização pela ID do pacote e, em seguida, renomeia-a.
Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"Exemplo 2: Definir propriedades descritivas
Esse comando obtém uma imagem de inicialização pelo nome e adiciona uma versão e uma descrição a ela.
Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"Exemplo 3: Definir o layout do teclado
O exemplo a seguir define o layout padrão do teclado da imagem de inicialização para o idioma russo (Rússia). Ele identifica a imagem de inicialização por sua ID.
Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"Exemplo 4: adicionar componentes opcionais
Este exemplo obtém os componentes opcionais .NET e PowerShell e os adiciona à imagem de inicialização.
$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 $OCsParâmetros
-AddOptionalComponent
Especifique uma matriz de objetos componentes opcionais para adicionar à imagem de inicialização. Para obter esse objeto, use o cmdlet Get-CMWinPEOptionalComponentInfo .
Os seguintes componentes são comumente usados:
- Microsoft .NET (WinPE-NetFX): esse componente é um pré-requisito para o PowerShell. É um dos componentes opcionais maiores.
- Windows PowerShell (WinPE-PowerShell): esse componente requer .NET e adiciona suporte limitado ao PowerShell. Se você executar scripts personalizados do PowerShell durante a fase WinPE da sequência de tarefas, adicione esse componente. Há outros componentes que podem ser necessários para outros cmdlets do PowerShell.
- HTML (WinPE-HTA): se você executar aplicativos HTML personalizados durante a fase WinPE da sequência de tarefas, adicione esse componente.
Para obter mais informações, consulte Gerenciar imagens de inicialização – componentes opcionais.
| Type: | IResultObject[] |
| Aliases: | AddOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackgroundBitmapPath
Especifique o caminho do arquivo de rede de um arquivo de imagem de segundo plano personalizado a ser usado no Windows PE.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
Os clientes sempre podem baixar uma imagem de inicialização de um ponto de distribuição. Se você definir esse parâmetro como $true, o site o disponibilizará por meio de um compartilhamento de rede nomeado em pontos de distribuição. Use CustomPackageShareName para especificar um nome de compartilhamento personalizado.
Quando você habilita essa opção, é necessário mais espaço em pontos de distribuição. Ela se aplica a todos os pontos de distribuição aos quais você distribui essa imagem de inicialização.
| Type: | Boolean |
| Aliases: | CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomPackageShareName
Se você habilitar CopyToPackageShareOnDistributionPoint, poderá usar esse parâmetro para personalizar o nome do compartilhamento. O comprimento máximo é de 127 caracteres e não pode incluir nenhum dos seguintes caracteres: " / [ ] : | < > + = ; , ? *. Você pode especificar um nome de compartilhamento e um nome de pasta, mas o máximo para cada um é de 80 caracteres. Por exemplo, ShareName\FolderName.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeployFromPxeDistributionPoint
Defina esse parâmetro como $true para disponibilizar essa imagem de inicialização de um ponto de distribuição habilitado para PXE. Para obter mais informações, consulte Usar o PXE para implantar o Windows na rede.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifique uma descrição opcional de uma imagem de inicialização para ajudá-lo a identificá-la.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPoint
Essa opção está preterida. Ele define a propriedade ForcedDisconnectEnabled da imagem de inicialização.
| Type: | Boolean |
| Aliases: | DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
Essa opção está preterida. Ele define a propriedade ForcedDisconnectDelay da imagem de inicialização.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetryCount
Essa opção está preterida. Ele define a propriedade ForcedDisconnectNumRetries da imagem de inicialização.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
Use esse parâmetro para atualizar pontos de distribuição em um agendamento. Para obter um objeto de agendamento, use o cmdlet New-CMSchedule .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
Defina esse parâmetro como $true para habilitar a BDR (replicação diferencial binária). Para obter mais informações, confira Conceitos fundamentais para gerenciamento de conteúdo em Configuration Manager.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableCommandSupport
Somente em ambientes de teste sem produção, você pode definir esse parâmetro como $true para habilitar o suporte a comandos. Quando um dispositivo inicializa essa imagem, você pode pressionar F8 para abrir um prompt de comando administrativo. Essa opção é útil para solucionar problemas enquanto você está testando sua implantação. O uso dessa configuração em uma implantação de produção não é aconselhável devido a preocupações de segurança.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnablePrestartCommand
Defina esse parâmetro como $true para habilitar um comando prestart. Essa linha de comando é executada antes do início da sequência de tarefas.
Configure também os seguintes parâmetros: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Execute o comando sem pedir confirmação.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Especifique uma ID de imagem de inicialização a ser configurada. Esse valor é uma ID de pacote padrão, por exemplo: XYZ00002.
| Type: | String |
| Aliases: | PackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeFilesForPrestart
Se você habilitar EnablePrestartCommand, use esse parâmetro se o comando prestart exigir que outros arquivos sejam executados. Em seguida, use o parâmetro PrestartIncludeFilesDirectory para especificar o local dos arquivos a serem incluídos.
Por exemplo, se você quiser executar um script em lote, use essa opção para incluir o arquivo de script.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputLocale
Use esse parâmetro para configurar o layout padrão do teclado para uma imagem de inicialização. Especifique a marca de idioma. Por exemplo, para definir a localidade de entrada como russo (Rússia), especifique a cadeia de caracteres ru-ru. Para obter mais informações, consulte [MS-LCID]: Referência do LCID (Identificador de Código de Linguagem do Windows).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifique um objeto de imagem de inicialização a ser configurado. Para obter esse objeto, use o cmdlet Get-CMBootImage .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifique o nome de uma imagem de inicialização a ser configurada.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Especifique um novo nome para a imagem de inicialização.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifique o caminho de rede da imagem do Windows PE que essa imagem de inicialização usa. Você não pode alterar o caminho para imagens de inicialização padrão.
| Type: | String |
| Aliases: | ImagePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistContentInCache
Se você não quiser que o conteúdo desse pacote fique fora do cache do cliente para abrir espaço para outro conteúdo, defina esse parâmetro como $true para mantê-lo no cache do cliente.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestageBehavior
Especifique o comportamento ao habilitar um ponto de distribuição para conteúdo prestaged:
ManualCopy: copie manualmente o conteúdo deste pacote para o ponto de distribuiçãoDownloadDelta: baixar apenas alterações de conteúdo no ponto de distribuiçãoOnDemand: baixe automaticamente o conteúdo quando os pacotes são atribuídos a pontos de distribuição
Para obter mais informações, consulte Usar conteúdo prestaged.
| Type: | PrestageBehavior |
| Accepted values: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartCommandLine
Se você habilitar EnablePrestartCommand, use esse parâmetro para especificar a linha de comando a ser executada. O comprimento máximo é de 4.096 caracteres.
Se a linha de comando exigir arquivos que não estão no Windows PE, use os parâmetros IncludeFilesForPrestart e PrestartIncludeFilesDirectory .
| Type: | String |
| Aliases: | CommandLine |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartIncludeFilesDirectory
Se você habilitar EnablePrestartCommand e IncludeFilesForPrestart, use esse parâmetro para especificar o caminho de rede dos arquivos a serem incluídos na imagem de inicialização.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
Especifique a ordem na 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. Pacotes com prioridade igual são enviados na ordem em que são criados.
| Type: | Priority |
| Accepted values: | High, Medium, Low |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reload
Aplica-se à versão 2006 e posterior. Se as versões dos componentes do Windows ADK na imagem de inicialização estiverem desatualizadas, adicione esse parâmetro para recarregar a imagem de inicialização com a versão atual do Windows PE do Windows ADK. Para obter mais informações, confira Atualizar pontos de distribuição com a imagem de inicialização.
| Type: | SwitchParameter |
| Aliases: | ReloadImage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOptionalComponent
Especifique uma matriz de objetos componentes opcionais para remover da imagem de inicialização. Para obter esse objeto, use o cmdlet Get-CMWinPEOptionalComponentInfo .
Não remova os seguintes componentes, que são exigidos por Configuration Manager:
- Script (WinPE-Scripting)
- Inicialização (WinPE-SecureStartup)
- Rede (WinPE-WDS-Tools)
- Script (WinPE-WMI)
| Type: | IResultObject[] |
| Aliases: | RemoveOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScratchSpace
Configure o espaço de arranhões do Windows PE, que é o armazenamento temporário (unidade de RAM) usado pelo WinPE. Por exemplo, quando um aplicativo é executado no WinPE e precisa gravar arquivos temporários, o WinPE redireciona os arquivos para o espaço de arranhão na memória para simular a presença de um disco rígido. Por padrão, esse valor é de 512 MB para dispositivos com mais de 1 GB de RAM, caso contrário, o padrão é de 32 MB.
| Type: | UInt32 |
| Accepted values: | 32, 64, 128, 256, 512 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendToPreferredDistributionPoint
Se você quiser habilitar a distribuição de conteúdo sob demanda para pontos de distribuição preferenciais, defina esse parâmetro como $true. Quando você habilita essa configuração, se um cliente solicitar o conteúdo do pacote e o conteúdo não estiver disponível em nenhum ponto de distribuição, o ponto de gerenciamento distribuirá o conteúdo. Para obter mais informações, confira Distribuição de conteúdo sob demanda.
| Type: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
Especifique a versão da imagem de inicialização. Esse valor não é a versão do sistema operacional, mas uma cadeia de caracteres que você gerencia.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de