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çãoDownloadDelta: Descarregue apenas alterações de conteúdo no ponto de distribuiçãoOnDemand: 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.