New-CMTSStepApplyOperatingSystem
Cree un paso Aplicar imagen del sistema operativo, que puede agregar a una secuencia de tareas.
Syntax
New-CMTSStepApplyOperatingSystem
[-ConfigFileName <String>]
[-ConfigFilePackage <IResultObject>]
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-LayeredDriver <OsdLayeredDriver>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
[-ImagePackage <IResultObject>]
[-ImagePackageIndex <Int32>]
[-InstallPackage <IResultObject>]
[-InstallPackageIndex <Int32>]
[-RunFromNet <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet crea un nuevo objeto de paso Aplicar imagen del sistema operativo. A continuación, use el cmdlet Add-CMTaskSequenceStep para agregar el paso a una secuencia de tareas. Para obtener más información sobre este paso, vea About task sequence steps: Apply OS Image.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1
En este ejemplo se usa primero el cmdlet Get-CMOperatingSystemImage para obtener un objeto para el paquete de imagen del sistema operativo. Guarda este objeto en la $osImgPkg variable. El siguiente paso crea un objeto para el paso Aplicar imagen del sistema operativo, usando el $osImgPkg como el paquete de imagen.
A continuación, obtiene un objeto de secuencia de tareas y agrega este nuevo paso a la secuencia de tareas en el índice 11.
$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
Especifique un objeto de condición que se usará con este paso. Para obtener este objeto, use uno de los cmdlets de condición de secuencia de tareas. Por ejemplo, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFileName
Especifique el nombre de archivo de un archivo de respuesta desatendido o sysprep que se usará para una instalación personalizada. Use este parámetro con el parámetro ConfigFilePackage.
Type: | String |
Aliases: | AnswerFileName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFilePackage
Especifique un objeto de paquete que incluya el archivo de respuesta desatendido o Sysprep que se usará para una instalación personalizada. Para obtener este objeto, use el cmdlet Get-CMPackage. Use este parámetro con el parámetro ConfigFileName.
Type: | IResultObject |
Aliases: | AnswerFilePackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Agregue este parámetro para habilitar la opción de paso Continuar con el error. Al habilitar esta opción, si se produce un error en el paso, la secuencia de tareas continúa.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique una descripción opcional para este paso de secuencia de tareas.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Destination
Especifique la ubicación en la que desea aplicar este sistema operativo. Si no especifica este parámetro, el valor predeterminado es NextAvailableFormattedPartition
.
NextAvailableFormattedPartition
: use la siguiente partición secuencial que aún no está dirigida por un paso Aplicar sistema operativo o Aplicar imagen de datos en esta secuencia de tareas.SpecificDiskAndPartition
: especifique el número de disco con el parámetro DestinationDisk y el número de partición con el parámetro DestinationPartition.SpecificLogicalDriverLetter
: use el parámetro DestinationDriveLetter para especificar la letra de unidad lógica asignada a la partición Windows PE. Esta letra de unidad puede ser diferente de la letra de unidad asignada por el sistema operativo recién implementado.LogicalDriverLetterInVariable
: use el parámetro DestinationVariable para especificar la variable de secuencia de tareas que contiene la letra de unidad asignada a la partición por Windows PE. Esta variable normalmente se establece con el parámetro DiskNumberVariable de los cmdlets Set-CMTSStepPartitionDisk o New-CMTSStepPartitionDisk para el paso de secuencia de tareas Format y Partition Disk.
Type: | DestinationType |
Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDisk
Cuando use -Destination SpecificDiskAndPartition
, use este parámetro para especificar el número de disco. Especifique un número entero de 0
a 99
. También use el parámetro DestinationPartition.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDriveLetter
Cuando use -Destination SpecificLogicalDriverLetter
, use este parámetro para especificar la letra de unidad lógica. Especifique una letra de unidad de C
Z
a .
Type: | String |
Aliases: | DestinationLogicalDrive |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationPartition
Cuando use -Destination SpecificDiskAndPartition
, use este parámetro para especificar el número de partición. Especifique un número entero de 1
a 99
. También use el parámetro DestinationDisk.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationVariable
Cuando use -Destination LogicalDriverLetterInVariable
, use este parámetro para especificar la variable de secuencia de tareas con la letra de unidad lógica. El nombre de variable debe ser alfanumérico sin espacios y con menos de 256 caracteres.
Type: | String |
Aliases: | DestinationVariableName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Agregue este parámetro para deshabilitar este paso de secuencia de tareas.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
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 |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackage
Especifique un objeto de paquete de imagen del sistema operativo. El paso aplica el sistema operativo desde esta imagen. Use el parámetro ImagePackageIndex para establecer el índice de imagen.
Para obtener este objeto, use el cmdlet Get-CMOperatingSystemImage.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackageIndex
Especifique un valor entero del índice de imagen. Use este parámetro con el parámetro ImagePackage.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackage
Especifique un objeto de paquete de actualización del sistema operativo. El paso aplica el sistema operativo desde este origen de instalación original. Use el parámetro InstallPackageIndex para establecer la edición.
Para obtener este objeto, use el cmdlet Get-CMOperatingSystemInstaller.
Type: | IResultObject |
Aliases: | UpgradePackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackageIndex
Especifique un valor entero de la edición del paquete de actualización del sistema operativo. Use este parámetro con el parámetro InstallPackage.
Type: | Int32 |
Aliases: | UpgradePackageIndex |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LayeredDriver
A partir de la versión 2107, use este parámetro para seleccionar otros tipos de teclados que son comunes con los idiomas japonés y coreano. Especifique un valor entero para que el controlador en capas se instale con Windows. Use los mismos valores que la variable de secuencia de tareas OsdLayeredDriver.
Type: | OsdLayeredDriver |
Aliases: | KeyboardDriver |
Accepted values: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique un nombre para este paso para identificarlo en la secuencia de tareas.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunFromNet
Establezca este parámetro para $true
permitir que la secuencia de tareas aplique la imagen del sistema operativo directamente desde el punto de distribución.
Para mayor seguridad, se recomienda no habilitar esta configuración. Esta opción está diseñada para su uso en dispositivos con capacidad de almacenamiento limitada. Para obtener más información, vea Access content directly from the distribution point.
Type: | Boolean |
Aliases: | AllowAccessFromDistributionPoint |
Position: | Named |
Default value: | None |
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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Ninguno
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_ApplyOperatingSystemAction server WMI class.