Set-CMBootImage
Modifique una imagen de arranque del sistema operativo.
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 una imagen de arranque del sistema operativo. Las imágenes de arranque son imágenes del entorno de preinstalación de Windows (Windows PE) en las que se arranca un equipo cliente antes de instalar un sistema operativo.
Puede agregar controladores de dispositivo a una imagen de arranque o cambiar sus propiedades. Para poder agregar un nuevo controlador de dispositivo, primero debe importarlo al catálogo de controladores de Configuration Manager y habilitarlo.
Cada versión de Configuration Manager admite una versión específica del Kit de evaluación e implementación de Windows (Windows ADK). Puede atender o personalizar las imágenes de arranque cuando se basan en una versión de Windows PE de la versión compatible de Windows ADK.
Para obtener más información, consulte Administración de imágenes de arranque con Configuration Manager.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Cambiar el nombre de una imagen de arranque
Este comando obtiene una imagen de arranque por su identificador de paquete y, a continuación, le cambia el nombre.
Set-CMBootimage -Id "CM100004" -NewName "Custom boot image"Ejemplo 2: Establecer propiedades descriptivas
Este comando obtiene una imagen de arranque por su nombre y, a continuación, le agrega una versión y una descripción.
Set-CMBootImage -Name "Custom boot image (x64)" -Version "Contoso v2.1" -Description "Managed by jqpublic"Ejemplo 3: Establecer el diseño del teclado
En el ejemplo siguiente se establece el diseño de teclado predeterminado de la imagen de arranque en el idioma ruso (Rusia). Identifica la imagen de arranque por su identificador.
Set-CMBootimage -Id "CM100004" -InputLocale "ru-ru"Ejemplo 4: Agregar componentes opcionales
En este ejemplo se obtienen los componentes opcionales de .NET y PowerShell y, a continuación, se agregan a la imagen 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 $OCsParámetros
-AddOptionalComponent
Especifique una matriz de objetos de componente opcionales que se van a agregar a la imagen de arranque. Para obtener este objeto, use el cmdlet Get-CMWinPEOptionalComponentInfo .
Los siguientes componentes se usan habitualmente:
- Microsoft .NET (WinPE-NetFX): este componente es un requisito previo para PowerShell. Es uno de los componentes opcionales más grandes.
- Windows PowerShell (WinPE-PowerShell): este componente requiere .NET y agrega compatibilidad limitada con PowerShell. Si ejecuta scripts personalizados de PowerShell durante la fase WinPE de la secuencia de tareas, agregue este componente. Hay otros componentes que pueden ser necesarios para otros cmdlets de PowerShell.
- HTML (WinPE-HTA): si ejecuta aplicaciones HTML personalizadas durante la fase de WinPE de la secuencia de tareas, agregue este componente.
Para obtener más información, consulte Administración de imágenes de arranque: componentes opcionales.
| Type: | IResultObject[] |
| Aliases: | AddOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackgroundBitmapPath
Especifique la ruta de acceso del archivo de red de un archivo de imagen de fondo personalizado que se usará en Windows PE.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
Los clientes siempre pueden descargar una imagen de arranque desde un punto de distribución. Si establece este parámetro en $true, el sitio lo pone a disposición a través de un recurso compartido de red con nombre en puntos de distribución. Use CustomPackageShareName para especificar un nombre de recurso compartido personalizado.
Al habilitar esta opción, se requiere más espacio en los puntos de distribución. Se aplica a todos los puntos de distribución a los que se distribuye esta imagen de arranque.
| Type: | Boolean |
| Aliases: | CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomPackageShareName
Si habilita CopyToPackageShareOnDistributionPoint, puede usar este parámetro para personalizar el nombre del recurso compartido. La longitud máxima es de 127 caracteres y no puede incluir ninguno de los siguientes caracteres: " / [ ] : | < > + = ; , ? *. Puede especificar un nombre de recurso compartido y un nombre de carpeta, pero el máximo para cada uno es de 80 caracteres. Por ejemplo, ShareName\FolderName.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeployFromPxeDistributionPoint
Establezca este parámetro en $true para que esta imagen de arranque esté disponible desde un punto de distribución habilitado para PXE. Para obtener más información, consulte Uso de PXE para implementar Windows a través de la red.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifique una descripción opcional de una imagen de arranque para ayudarle a identificarla.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPoint
Esta opción está en desuso. Establece la propiedad ForcedDisconnectEnabled de la imagen de arranque.
| Type: | Boolean |
| Aliases: | DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
Esta opción está en desuso. Establece la propiedad ForcedDisconnectDelay de la imagen de arranque.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetryCount
Esta opción está en desuso. Establece la propiedad ForcedDisconnectNumRetries de la imagen de arranque.
| Type: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
Use este parámetro para actualizar los puntos de distribución según una programación. Para obtener un objeto de programación, use el cmdlet New-CMSchedule .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
Establezca este parámetro en $true para habilitar la replicación diferencial binaria (BDR). Para obtener más información, consulte Conceptos fundamentales para la administración de contenido en Configuration Manager.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableCommandSupport
En entornos de prueba que no son de producción, solo puede establecer este parámetro en $true para habilitar la compatibilidad con comandos. Cuando un dispositivo se inicia en esta imagen, puede presionar F8 para abrir un símbolo del sistema administrativo. Esta opción es útil para solucionar problemas al probar la implementación. No se recomienda usar esta configuración en una implementación de producción debido a problemas de seguridad.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnablePrestartCommand
Establezca este parámetro en $true para habilitar un comando de preinicio. Esta línea de comandos se ejecuta antes de que se inicie la secuencia de tareas.
Configure también los parámetros siguientes: IncludeFilesForPrestart, PrestartCommandLine, PrestartIncludeFilesDirectory.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Ejecute el comando sin pedir confirmación.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Especifique un identificador de imagen de arranque que se va a configurar. Este valor es un identificador de paquete estándar, por ejemplo: XYZ00002.
| Type: | String |
| Aliases: | PackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeFilesForPrestart
Si habilita EnablePrestartCommand, use este parámetro si el comando de preinicio requiere que se ejecuten otros archivos. A continuación, use el parámetro PrestartIncludeFilesDirectory para especificar la ubicación de los archivos que se van a incluir.
Por ejemplo, si desea ejecutar un script por lotes, use esta opción para incluir el archivo de script.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputLocale
Use este parámetro para configurar el diseño de teclado predeterminado para una imagen de arranque. Especifique la etiqueta de idioma. Por ejemplo, para establecer la configuración regional de entrada en Ruso (Rusia), especifique la cadena ru-ru. Para obtener más información, vea [MS-LCID]: Referencia del identificador de código de lenguaje (LCID) de Windows.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifique un objeto de imagen de arranque que se va a configurar. Para obtener este objeto, use el cmdlet Get-CMBootImage .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifique el nombre de una imagen de arranque que se va a configurar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Especifique un nuevo nombre para la imagen de arranque.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifique la ruta de acceso de red de la imagen de Windows PE que usa esta imagen de arranque. No se puede cambiar la ruta de acceso de las imágenes de arranque predeterminadas.
| Type: | String |
| Aliases: | ImagePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistContentInCache
Si no desea que el contenido de este paquete se agote de la memoria caché del cliente para dejar espacio a otro contenido, establezca este parámetro en $true conservarlo en la memoria caché del cliente.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestageBehavior
Especifique el comportamiento al habilitar un punto de distribución para el contenido preconfigurado:
ManualCopy: copie manualmente el contenido de este paquete en el punto de distribución.DownloadDelta: descargue solo los cambios de contenido en el punto de distribución.OnDemand: descarga automática del contenido cuando se asignan paquetes a puntos de distribución
Para obtener más información, consulte Uso de contenido preconfigurado.
| Type: | PrestageBehavior |
| Accepted values: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartCommandLine
Si habilita EnablePrestartCommand, use este parámetro para especificar la línea de comandos que se va a ejecutar. La longitud máxima es 4096 caracteres.
Si la línea de comandos requiere archivos que no están en Windows PE, use los parámetros IncludeFilesForPrestart y PrestartIncludeFilesDirectory .
| Type: | String |
| Aliases: | CommandLine |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestartIncludeFilesDirectory
Si habilita EnablePrestartCommand e IncludeFilesForPrestart, use este parámetro para especificar la ruta de acceso de red de los archivos que se van a incluir en la imagen de arranque.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
Especifique el orden en que el sitio envía el contenido a otros sitios y a los puntos de distribución de este sitio.
El sitio envía contenido de alta prioridad antes que los paquetes con prioridad media o baja. Los paquetes con la misma prioridad se envían en el orden en que se crean.
| Type: | Priority |
| Accepted values: | High, Medium, Low |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reload
Se aplica a la versión 2006 y posteriores. Si las versiones de los componentes de Windows ADK de la imagen de arranque están obsoletas, agregue este parámetro para volver a cargar la imagen de arranque con la versión actual de Windows PE desde Windows ADK. Para obtener más información, consulte Actualización de puntos de distribución con la imagen de arranque.
| Type: | SwitchParameter |
| Aliases: | ReloadImage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveOptionalComponent
Especifique una matriz de objetos de componente opcionales que se van a quitar de la imagen de arranque. Para obtener este objeto, use el cmdlet Get-CMWinPEOptionalComponentInfo .
No quite los siguientes componentes, necesarios para Configuration Manager:
- Scripting (WinPE-Scripting)
- Inicio (WinPE-SecureStartup)
- Red (WinPE-WDS-Tools)
- Scripting (WinPE-WMI)
| Type: | IResultObject[] |
| Aliases: | RemoveOptionalComponents |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScratchSpace
Configure el espacio temporal de Windows PE, que es el almacenamiento temporal (unidad RAM) que usa WinPE. Por ejemplo, cuando una aplicación se ejecuta en WinPE y necesita escribir archivos temporales, WinPE redirige los archivos al espacio temporal en la memoria para simular la presencia de un disco duro. De forma predeterminada, esta cantidad es de 512 MB para dispositivos con más de 1 GB de RAM; de lo contrario, el valor predeterminado es 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
Si desea habilitar la distribución de contenido a petición en puntos de distribución preferidos, establezca este parámetro en $true. Al habilitar esta configuración, si un cliente solicita el contenido del paquete y el contenido no está disponible en ningún punto de distribución, el punto de administración distribuye el contenido. Para obtener más información, consulte Distribución de contenido a petición.
| Type: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
Especifique la versión de la imagen de arranque. Este valor no es la versión del sistema operativo, sino una cadena que administra.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de