New-CMPrestageMedia

Referencia

Módulo:: ConfigurationManager

Cree un archivo multimedia preconfigurado de implementación del sistema operativo.

Sintaxis

New-CMPrestageMedia
   [-Application <IResultObject[]>]
   [-Comment <String>]
   [-CreatedBy <String>]
   [-DriverPackage <IResultObject[]>]
   [-IncludeApplicationDependency]
   -OperatingSystemImage <IResultObject>
   [-OperatingSystemImageIndex <Int32>]
   [-Package <IResultObject[]>]
   -TaskSequence <IResultObject>
   [-Version <String>]
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-CMPrestageMedia crea un archivo para preconfigurar una imagen del sistema operativo en una nueva unidad de disco duro. Para obtener más información, vea Planear medios preconfigurados.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Creación de medios preconfigurados

El primer comando obtiene el objeto de punto de administración del servidor de sistema de sitio denominado mp01.contoso.com en el código de sitio CM1 y almacena el objeto en la variable $ManagementPoint .

El segundo comando obtiene el objeto de imagen de arranque denominado BootImage01 y almacena el objeto en la variable $BootImage .

El tercer comando obtiene el objeto de punto de distribución para el servidor de sistema de sitio denominado dist01.contoso.com en el código de sitio CM1 y almacena el objeto en la variable $DistributionPoint .

El cuarto comando obtiene el objeto de imagen del sistema operativo denominado OSImagePkg01 y almacena el objeto en la variable $OSImage .

El último comando crea un archivo multimedia preconfigurado dinámico denominado PrestagedMedia.wim con la imagen de arranque almacenada en $BootImage, el punto de distribución almacenado en $DistributionPoint, el punto de administración almacenado en $ManagementPoint y la imagen del sistema operativo almacenada en $OSImage.

$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"

New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImage

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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Application

Especifique una matriz de objetos de aplicación que se incluirán como parte del archivo multimedia. Si la secuencia de tareas hace referencia a este contenido, primero busca localmente el contenido. Si el contenido no está en los medios, la secuencia de tareas intenta descargarlo de la red de la forma normal. Para obtener un objeto de aplicación, use el cmdlet Get-CMApplication .

Tipo:	IResultObject[]
Alias:	Applications
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BootImage

Especifique un objeto de imagen de arranque. Para obtener este objeto, use el cmdlet Get-CMBootImage .

Tipo:	IResultObject
Alias:	BootImagePackage
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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)

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SecureString
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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)

Tipo:	DateTime
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Comment

Cadena opcional para proporcionar más detalles sobre los medios. Es útil describir cómo ha configurado o cómo va a usar este medio. La longitud máxima es de 127 caracteres.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CreatedBy

Cadena opcional para especificar quién creó este medio, lo que resulta útil con fines de seguimiento. La longitud máxima es de 50 caracteres.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DistributionPoint

Especifique uno o varios objetos de punto de distribución a los que distribuyó el contenido de este medio. Para obtener este objeto, use el cmdlet Get-CMDistributionPoint .

Tipo:	IResultObject[]
Alias:	DistributionPoints
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DriverPackage

Especifique una matriz de objetos de paquete de controladores que se incluirán como parte del archivo multimedia. Si la secuencia de tareas hace referencia a este contenido, busca localmente el contenido. Si el contenido no está en los medios, la secuencia de tareas intenta descargarlo de la red de la forma normal. Para obtener este objeto, use el cmdlet Get-CMDriverPackage .

Tipo:	IResultObject[]
Alias:	DriverPackages, PackageDriver, PackageDrivers
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

Ejecute el comando sin pedir confirmación.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IncludeApplicationDependency

Agregue este parámetro para detectar las dependencias de la aplicación asociadas y agregarlas a este medio.

Tipo:	SwitchParameter
Alias:	IncludeApplicationDependencies
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 .

Tipo:	IResultObject[]
Alias:	ManagementPoints
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 .

Tipo:	MediaMode
Valores aceptados:	Dynamic, SiteBased
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SecureString
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OperatingSystemImage

Especifique un objeto de paquete de imagen del sistema operativo que se va a incluir para este medio. Use el parámetro OperatingSystemImageIndex para especificar el índice de imagen en el paquete de imagen. Para obtener este objeto, use el cmdlet Get-CMOperatingSystemImage .

Tipo:	IResultObject
Alias:	OperatingSystemImagePackage
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OperatingSystemImageIndex

Especifique el índice de imagen en el paquete de imagen desde el parámetro OperatingSystemImage .

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Package

Especifique una matriz de objetos de paquete que se incluirán en el archivo multimedia. Si la secuencia de tareas hace referencia a este contenido, busca localmente el contenido. Si el contenido no está en los medios, la secuencia de tareas intenta descargarlo de la red de la forma normal. Para obtener este objeto, use el cmdlet Get-CMPackage .

Tipo:	IResultObject[]
Alias:	Packages
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path

Ruta de acceso al archivo multimedia que se va a crear. El formato es una ruta de acceso de unidad o directorio o una ruta de acceso de red válida. Por ejemplo:

C:\media\prestaged1.wim
\\server\share\prestaged1.wim

Tipo:	String
Alias:	MediaPath, OutputPath, DriveName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PrestartCommand

Especifique una línea de comandos que se ejecutará antes de que se inicie la secuencia de tareas. Para obtener más información, vea Comandos de Preinicio para medios de secuencia de tareas.

Tipo:	String
Alias:	PreExecCommandLine
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PrestartPackage

Si especifica un elemento PrestartCommand, use este parámetro para especificar un paquete para el contenido de preinicio si es necesario.

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TaskSequence

Especifique un objeto de secuencia de tareas para que se ejecute este medio. Para obtener este objeto, use el cmdlet Get-CMTaskSequence .

Tipo:	IResultObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Alias:	TemporaryDirectory, StagingArea
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	UserDeviceAffinityType
Valores aceptados:	DoNotAllow, AdministratorApproval, AutoApproval
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Variable

Especifique una tabla hash de variables de secuencia de tareas que se usarán durante la implementación de secuencia de tareas desde este medio.

Tipo:	Hashtable
Alias:	TaskSequenceVariables, Variables
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Version

Valor de cadena opcional para especificar una versión para este medio, lo que resulta útil con fines de seguimiento y revisión. La longitud máxima es de 32 caracteres.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

System.Object

Notas

Alias de cmdlet: New-CMPrestagedMedia

Compartir a través de