Partilhar via


Set-CMBootImage

SYNOPSIS

Modifique uma imagem de arranque de SO.

SYNTAX

SetByValueMandatory (Padrão)

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>]

SetById

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>]

SetByName

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 de SO. As imagens de arranque são Windows imagens de Pré-instalação Ambiente (Windows PE) nas quais inicia um computador cliente antes de instalar um SISTEMA.

Pode adicionar controladores de dispositivo a uma imagem de arranque ou alterar as suas propriedades. Antes de poder adicionar um novo controlador de dispositivo, primeiro deve importar o controlador para o catálogo do controlador do Gestor de Configuração e ative-o.

Cada versão do Gestor de Configuração suporta uma versão específica do Kit de Avaliação e Implantação de Windows (Windows ADK). Pode servir, ou personalizar, imagens de arranque quando são baseadas numa versão PE Windows a partir da versão suportada de Windows ADK.

Para obter mais informações, consulte Gerir as imagens de arranque com o Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Mudar o nome de uma imagem de arranque

Este comando obtém uma imagem de arranque pelo seu ID de pacote, e depois rebatiza-o.

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

Exemplo 2: Definir propriedades descritivas

Este comando obtém uma imagem de arranque pelo seu nome, e em seguida, adiciona uma versão e descrição a ele.

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 esquema padrão do teclado da imagem de arranque para a língua russa (Rússia). Identifica a imagem da bota pelo seu 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

PARAMETERS

-AddOptionalComponent

Especifique um conjunto de objetos componentes opcionais para adicionar à imagem de arranque. Para obter este objeto, utilize o cmdlet Get-CMWinPEOptionalComponentInfo.

Os seguintes componentes são comumente utilizados:

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

Para obter mais informações, consulte Gerir as imagens de arranque - componentes opcionais.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddOptionalComponents

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-BackgroundBitmapPath

Especifique o caminho do ficheiro de rede de um ficheiro de imagem de fundo personalizado para usar em Windows PE.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-CopyToPackageShareOnDistributionPoint

Os clientes podem sempre descarregar uma imagem de arranque a partir de um ponto de distribuição. Se definir este parâmetro para $true, o site disponibiliza-o através de uma partilha de rede nomeada em pontos de distribuição. Utilize o Nome CustomPackageShare 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.

Type: Boolean
Parameter Sets: (All)
Aliases: CopyToPackageShareOnDistributionPoints

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CustomPackageShareName

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

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ImplementarFromPxeDistributionPoint

Desaponte este parâmetro para $true para disponibilizar esta imagem de arranque a partir de um ponto de distribuição ativado por PXE. Para obter mais informações, consulte o PXE para implementar Windows na rede.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Descrição

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

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisconnectUserFromDistributionPoint

Esta opção é depreciada. Define a propriedade ForcedDisconnectEnabled da imagem de arranque.

Type: Boolean
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPoints

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisconnectUserFromDistributionPointMins

Esta opção é depreciada. Define a propriedade ForcedDisconnectDelay da imagem de arranque.

Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsMinutes

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisconnectUserFromDistributionPointRetryCount

Esta opção é depreciada. Define a propriedade ForcedDisconnectNumRetries da imagem de arranque.

Type: UInt32
Parameter Sets: (All)
Aliases: DisconnectUsersFromDistributionPointsRetries

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPointUpdateSchedule

Utilize este parâmetro para atualizar pontos de distribuição num horário. Para obter um objeto de agenda, use o cmdlet New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableBinaryDeltaReplicação

Desente este parâmetro para $true para permitir a replicação diferencial binária (BDR). Para obter mais informações, consulte conceitos fundamentais para a gestão de conteúdos no Gestor de Configurações.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableCommandSupport

Apenas na não produção, apenas em ambientes de teste, pode definir este parâmetro para $true para permitir o suporte ao comando. Quando um dispositivo se calça a esta imagem, pode premir F8 para abrir uma indicação de comando administrativo. Esta opção é útil para a resolução de problemas enquanto está a testar a sua implementação. Usar esta definição numa implantação de produção não é aconselhável por questões de segurança.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnablePrestartCommand

Desa esta definição deste parâmetro para $true para ativar um comando de prestar. Esta linha de comando é executado antes do início da sequência de tarefas.

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

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Force

Executar o comando sem pedir confirmação.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- ID

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

Type: String
Parameter Sets: SetById
Aliases: PackageId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncluirFilesForPrestart

Se ativar EnablePrestartCommand, utilize este parâmetro se o comando prestart necessitar de outros ficheiros para executar. Em seguida, utilize o parâmetro PrestartIncludeFilesDirectory para especificar a localização dos ficheiros a incluir.

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

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputLocale

Utilize este parâmetro para configurar o esquema padrão do teclado para uma imagem de arranque. Especificar a etiqueta linguística. Por exemplo, para definir o local de entrada para o russo (Rússia), especifique a cadeia ru-ru . Para obter mais informações, consulte [MS-LCID]: Windows referência do identificador de código linguístico (LCID).

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

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

Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Especifique o nome de uma imagem de arranque para configurar.

Type: String
Parameter Sets: SetByName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Novo Nome

Especifique um novo nome para a imagem de arranque.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- PassThru

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Path

Especifique o caminho de rede da imagem PE Windows que esta imagem de arranque utiliza. Não é possível alterar o caminho para imagens de arranque padrão.

Type: String
Parameter Sets: (All)
Aliases: ImagePath

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PersistContentInCache

Se não quiser que o conteúdo deste pacote encate fora da cache do cliente para abrir espaço para outros conteúdos, desa um parâmetro para $true persistir na cache do cliente.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PrestageBehavior

Especifique o comportamento quando ativar um ponto de distribuição para conteúdo satisfatório:

  • ManualCopy: Copiar manualmente o conteúdo desta embalagem para o ponto de distribuição
  • DownloadDelta: Descarregue apenas alterações de conteúdo no ponto de distribuição
  • OnDemand: Descarregue automaticamente o conteúdo quando os pacotes são atribuídos a pontos de distribuição

Para obter mais informações, consulte o conteúdo de prestaçãode informação .

Type: PrestageBehavior
Parameter Sets: (All)
Aliases:
Accepted values: ManualCopy, DownloadDelta, OnDemand

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PrestatCommandLine

Se ativar EnablePrestartCommand, utilize este parâmetro para especificar a linha de comando a ser executada. O comprimento máximo é de 4096 caracteres.

Se a linha de comando necessitar de ficheiros que não estejam em Windows PE, utilize os parâmetros IncluiFilesForPrestart e PrestartIncludeFilesDirectory.

Type: String
Parameter Sets: (All)
Aliases: CommandLine

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PrestatIncludeFilesDirectory

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

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Prioridade

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 média ou baixa prioridade. Pacotes com igual prioridade são enviados na ordem em que são criados.

Type: Priority
Parameter Sets: (All)
Aliases:
Accepted values: High, Medium, Low

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Recarregar

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ReloadImage

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Remover OptionalComponent

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

Não remova os seguintes componentes, que são exigidos pelo Gestor de Configuração:

  • Scripting (WinPE-Scripting)
  • Startup (WinPE-SecureStartup)
  • Rede (winpe-WDS-tools)
  • Scripting (WinPE-WMI)
Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveOptionalComponents

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScratchSpace

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

Type: UInt32
Parameter Sets: (All)
Aliases:
Accepted values: 32, 64, 128, 256, 512

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SendToPreferredDistributionPoint

Se pretender permitir a distribuição de conteúdos a pedido para pontos de distribuição preferidos, desaponte este parâmetro para $true. Quando ativa esta definição, se um cliente solicitar o conteúdo do pacote e o conteúdo não estiver disponível em quaisquer pontos de distribuição, então o ponto de gestão distribui o conteúdo. Para obter mais informações, consulte a distribuição de conteúdos a pedido.

Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Versão

Especifique a versão da imagem de arranque. Este valor não é a versão SO, mas uma corda que geres.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Get-CMBootImage

Nova CMBootImage

Remover-CMBootImage

Get-CMWinPEOptionalComponentInfo

Gerir imagens de arranque com o Gestor de Configuração