New-CMBootableMedia
Cree medios de arranque.
Syntax
New-CMBootableMedia
[-AllowUacPrompt]
[-AllowUnattended]
[-AllowUnknownMachine]
-BootImage <IResultObject>
[-CertificateExpireTime <DateTime>]
[-CertificatePassword <SecureString>]
[-CertificatePath <String>]
[-CertificateStartTime <DateTime>]
-DistributionPoint <IResultObject[]>
[-Force]
[-FormatMedia]
-ManagementPoint <IResultObject[]>
[-SiteCode <String>]
-MediaMode <MediaMode>
[-MediaPassword <SecureString>]
-MediaType <MediaInputType>
[-NoAutoRun]
-Path <String>
[-PrestartCommand <String>]
[-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet crea medios usados para implementar un sistema operativo. Los medios de arranque contienen la imagen de arranque, los comandos de preinicio opcionales y los archivos asociados, y los archivos Configuration Manager. Use medios de arranque para instalar una nueva versión de Windows en un equipo nuevo (sin sistema operativo) o para reemplazar un equipo existente y transferir la configuración.
Nota:
Este cmdlet requiere permisos elevados para ejecutarse.
Para obtener más información, consulte Introducción a los medios de secuencia de tareas.
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: Creación de medios de arranque
El primer comando obtiene el objeto de imagen de arranque denominado Imagen de arranque (x64) y lo almacena en la variable $BootImage . El segundo comando obtiene el rol de punto de distribución para SiteServer01.Contoso.com y lo almacena en la variable $DistributionPoint . El tercer comando obtiene el rol de punto de administración para SiteServer02.Contoso.com y lo almacena en la variable $ManagementPoint . El último comando crea medios de arranque en modo dinámico. Usa los objetos almacenados en las variables anteriores.
$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"
New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint
Parámetros
-AllowUacPrompt
Agregue este parámetro para permitir que Windows le pida que eleve los permisos de administrador con el Control de cuentas de usuario (UAC). Este cmdlet requiere permisos elevados para ejecutarse.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUnattended
Agregue este parámetro para permitir una implementación del sistema operativo desatendida. Una implementación deSatendida del sistema operativo no solicita la configuración de red ni secuencias de tareas opcionales.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUnknownMachine
Agregue este parámetro para permitir que Configuration Manager aprovisione equipos desconocidos. Un equipo desconocido es un equipo que el sitio aún no ha descubierto.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BootImage
Especifique un objeto de imagen de arranque. Para obtener este objeto, use el cmdlet Get-CMBootImage .
Type: | IResultObject |
Aliases: | BootImagePackage |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateExpireTime
Si crea un certificado multimedia autofirmado para la comunicación HTTP, este parámetro especifica la fecha y hora de expiración del certificado. Especifique una fecha y hora lo suficiente en el futuro. Cuando este certificado expira, no puede usar los medios de arranque. Use el parámetro -CertificateStartTime para establecer la fecha de inicio.
Por ejemplo:
$date = [datetime]::p arseexact("11/16/2021", "MM/dd/aaaa", $null)
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificatePassword
Si usa el parámetro -CertificatePath para importar un certificado PKI para la comunicación HTTPS, use este parámetro para especificar la contraseña del archivo de certificado.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificatePath
Especifique la ruta de acceso a un certificado PKI que se va a importar. Use el parámetro -CertificatePassword para especificar la contraseña de este archivo de certificado. Use estos parámetros si configura el sitio para la comunicación de cliente HTTPS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateStartTime
Para crear un certificado autofirmado para la comunicación HTTP, este parámetro especifica la fecha y hora de inicio del certificado. Use el parámetro -CertificateExpireTime para establecer la fecha de expiración. No puede usar el medio de arranque hasta esta fecha.
Por ejemplo:
$date = [datetime]::p arseexact("11/16/2020", "MM/dd/aaaa", $null)
Type: | DateTime |
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 |
-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 |
-DistributionPoint
Especifique uno o varios objetos de punto de distribución a los que distribuyó la imagen de arranque. Para obtener este objeto, use el cmdlet Get-CMDistributionPoint .
Type: | IResultObject[] |
Aliases: | DistributionPoints |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-FormatMedia
Si MediaType es Usb
, puede agregar este parámetro para dar formato a la unidad USB extraíble como FAT32 y hacer que se pueda arrancar.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagementPoint
Especifique uno o varios objetos de punto de administración que el medio usa en la comunicación inicial. Use el parámetro -MediaMode para determinar cómo se comunica el medio cuando se ejecuta. Para obtener este objeto, use el cmdlet Get-CMManagementPoint .
Type: | IResultObject[] |
Aliases: | ManagementPoints |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaMode
Especifique cómo el cliente encuentra un punto de administración para obtener información de implementación:
Dynamic
: el medio se pone en contacto con un punto de administración, que redirige al cliente a un punto de administración diferente en función de la ubicación del cliente en los límites del sitio.SiteBased
: el medio comunica el punto de administración especificado con el parámetro -ManagementPoint .
Type: | MediaMode |
Accepted values: | Dynamic, SiteBased |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaPassword
Especifique una contraseña de cadena segura para proteger el medio de secuencia de tareas. Al arrancar un dispositivo con este medio, debe escribir la contraseña para continuar.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaType
Especifique si el medio es un conjunto de CD/DVD o una unidad USB extraíble.
Type: | MediaInputType |
Accepted values: | Usb, CdDvd |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoAutoRun
Agregue este parámetro para incluir el archivo autorun.inf en el medio. Configuration Manager no lo agrega de forma predeterminada. Los productos antimalware suelen bloquear este archivo. Para obtener más información sobre la característica de ejecución automática de Windows, consulte Creación de una aplicación de CD-ROM habilitada para la ejecución automática. Si sigue siendo necesario para el escenario, agregue este parámetro para incluir el archivo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Si MediaType es CdDvd
, especifique el nombre y la ruta de acceso donde Configuration Manager escribe los archivos de salida. Por ejemplo, C:\output\boot.iso
.
Type: | String |
Aliases: | MediaPath, OutputPath, DriveName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrestartCommand
Especifique un comando de preinicio que se ejecute antes de la secuencia de tareas. Un comando de preinicio es un script o un ejecutable que puede interactuar con el usuario en Windows PE antes de que se ejecute la secuencia de tareas para instalar el sistema operativo. Si el comando no es nativo de Windows PE, use PrestartPackage para incluir archivos para el comando.
Type: | String |
Aliases: | PreExecCommandLine |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrestartPackage
Si usa el parámetro PrestartCommand , use este parámetro para especificar un paquete que contenga archivos para el comando de preinicio. Para obtener el objeto de paquete, use el cmdlet Get-CMPackage .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Se aplica a la versión 2010 y versiones posteriores. Use este parámetro con el parámetro ManagementPoint para especificar el código del sitio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemporaryFolder
El proceso de creación de medios puede requerir mucho espacio de unidad temporal. De forma predeterminada, Configuration Manager usa el directorio temporal del usuario actual: $env:temp
. Por ejemplo, C:\Users\jqpublic\AppData\Local\Temp\
. Para proporcionar una mayor flexibilidad con el lugar donde almacenar estos archivos temporales, especifique una ubicación personalizada para almacenar datos temporales de almacenamiento provisional.
Type: | String |
Aliases: | TemporaryDirectory, StagingArea |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserDeviceAffinity
Para admitir la administración centrada en el usuario en Configuration Manager, especifique cómo desea que los medios asocien a los usuarios con el equipo de destino. Para obtener más información sobre cómo la implementación del sistema operativo admite la afinidad de dispositivo de usuario, consulte Asociar usuarios con un equipo de destino.
DoNotAllow
: no permita la afinidad de dispositivo de usuario. Los medios no asocian usuarios al equipo de destino. En este escenario, la secuencia de tareas no asocia usuarios al equipo de destino cuando implementa el sistema operativo.AdministratorApproval
: permite la afinidad de dispositivo de usuario pendiente de aprobación del administrador. El medio asocia a los usuarios con el equipo de destino después de conceder la aprobación. Esta funcionalidad se basa en el ámbito de la secuencia de tareas que implementa el sistema operativo. En este escenario, la secuencia de tareas crea una relación entre los usuarios especificados y el equipo de destino. A continuación, espera la aprobación de un usuario administrativo antes de implementar el sistema operativo.AutoApproval
: permite la afinidad de dispositivo de usuario con aprobación automática. El medio asocia automáticamente a los usuarios con el equipo de destino. Esta funcionalidad se basa en las acciones de la secuencia de tareas que implementa el sistema operativo. En este escenario, la secuencia de tareas crea una relación entre los usuarios especificados y el equipo de destino cuando implementa el sistema operativo en el equipo de destino.
Type: | UserDeviceAffinityType |
Accepted values: | DoNotAllow, AdministratorApproval, AutoApproval |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Variable
Especifique una o varias variables y valores de secuencia de tareas en una tabla hash. Una variable de secuencia de tareas es un par nombre-valor que se usa durante la implementación de la secuencia de tareas.
Type: | Hashtable |
Aliases: | TaskSequenceVariables, Variables |
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
None
Salidas
System.Object
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
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:Enviar y ver comentarios de