New-CMTSPartitionSetting
Cree un objeto de partición de disco para usarlo con el paso de secuencia de tareas Format y Partition Disk.
Syntax
New-CMTSPartitionSetting
[-EnableDriveLetterAssignment <Boolean>]
[-EnableQuickFormat <Boolean>]
[-IsBootPartition <Boolean>]
[-Name <String>]
[-PartitionFileSystem <FileSystemType>]
[-PartitionPrimary]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-Variable <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSPartitionSetting
[-Name <String>]
[-PartitionEfi]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSPartitionSetting
[-Name <String>]
[-PartitionExtended]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSPartitionSetting
[-Name <String>]
[-PartitionHidden]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSPartitionSetting
[-Name <String>]
[-PartitionLogical]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSPartitionSetting
[-Name <String>]
[-PartitionMsr]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSPartitionSetting
[-Name <String>]
[-PartitionRecovery]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet crea un objeto de partición de disco para usarlo con el paso de secuencia de tareas Format y Partition Disk. Use este cmdlet para definir la configuración de partición y, a continuación, use ese objeto con el parámetro -PartitionSetting de los cmdlets New-CMTSStepPartitionDisk o Set-CMTSStepPartitionDisk.
Puede crear los siguientes tipos de objetos de configuración de partición, en función del parámetro switch que use con este cmdlet:
- PartitionPrimary: Partición principal
- PartitionEfi Partición EFI
- PartitionExtended: Partición extendida
- PartitionHidden: Partición oculta
- PartitionLogical: partición lógica
- PartitionMsr: partición MSR
- PartitionRecovery: Partición de recuperación
Si no especifica un parámetro de modificador de partición, el cmdlet crea un objeto de configuración de partición principal.
Para obtener más información, vea Format and Partition Disk: Volume.
Ejemplos
Ejemplo 1: Crear configuración para una partición EFI
En este ejemplo se crea una configuración para una partición EFI de 500 MB y se guarda como variable partEfi.
$partEfi = New-CMTSPartitionSetting -Name "EFI" -PartitionEfi -Size 500 -SizeUnit MB
Ejemplo 2: Crear configuración para una partición MSR
En este ejemplo se crea una configuración para una partición MSR de 128 MB y se guarda como variable partMsr.
$partMsr = New-CMTSPartitionSetting -Name "MSR" -PartitionMsr -Size 128 -SizeUnit MB
Ejemplo 3: Crear configuración para una partición Windows principal
En este ejemplo se crea la configuración Windows partición principal y se guarda como la variable partWin.
$partWin = New-CMTSPartitionSetting -Name "Windows" -PartitionPrimary -Size 99 -SizeUnit Percent -EnableDriveLetterAssignment $true -EnableQuickFormat $true -PartitionFileSystem NTFS -IsBootPartition $true
Ejemplo 4: Crear configuración para una partición de recuperación
En este ejemplo **** se crea una configuración para una partición de recuperación que es el 100 % del espacio en disco restante y se guarda como la variable partMsr.
$partRec = New-CMTSPartitionSetting -Name "Recovery" -PartitionRecovery -Size 100 -SizeUnit Percent
Ejemplo 5: Ver los detalles de configuración de partición para un paso
En este ejemplo primero se obtiene un objeto de secuencia de tareas en la variable $tsOsd tarea. A continuación, pasa esa variable como el objeto de entrada para obtener el paso Format y Partition Disk.
A continuación, para ver la primera configuración de partición, haga referencia a la propiedad Partitions, que es una matriz de SMS_TaskSequence_PartitionSettings objetos.
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameFormatDisk = "Partition Disk 0 - UEFI"
$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk
$tsStepFormatDisk.Partitions[0]
Puede usar este proceso para copiar la configuración de partición entre pasos o secuencias de tareas. Guarde este objeto de configuración de partición como una variable y, a continuación, agrégrelo a otro paso.
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 |
-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 |
-EnableDriveLetterAssignment
Establezca este parámetro para true
permitir que Configuration Manager asigne una letra de unidad a la partición.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableQuickFormat
Establezca este parámetro para true
permitir que Configuration Manager realice un formato rápido de la partición.
Type: | Boolean |
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 |
-IsBootPartition
Establezca este parámetro para true
que esta partición sea la partición de arranque.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique un nombre para la partición.
Type: | String |
Aliases: | PartitionName, VolumeName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionEfi
Agregue este parámetro para que el tipo de partición EFI.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionExtended
Agregue este parámetro para que el tipo de partición Extended.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionFileSystem
Especifique el sistema de archivos para dar formato a la partición.
Type: | FileSystemType |
Accepted values: | Ntfs, Fat32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionHidden
Agregue este parámetro para que el tipo de partición Hidden.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionLogical
Agregue este parámetro para que el tipo de partición Logical.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionMsr
Agregue este parámetro para que el tipo de partición MSR.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionPrimary
Agregue este parámetro para crear el tipo de partición Primary.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionRecovery
Agregue este parámetro para que el tipo de partición Recovery.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Size
Especifique un valor entero para el tamaño de la partición. Use este parámetro con el parámetro -SizeUnit. Si -SizeUnit es Percent
, especifique un número entre 1 y 100 para este parámetro. Si -SizeUnit es MB
o , especifique un número para el tamaño de partición GB
específico.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SizeUnit
Especifique el tipo de unidad para el tamaño. Use este parámetro con el parámetro -Size.
Percent
: Use -Size para establecer la partición en un porcentaje del espacio libre restante en el disco.MB
oGB
: Use -Size para establecer un tamaño específico para la partición.
Type: | SizeUnitType |
Accepted values: | MB, GB, Percent |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Variable
De forma predeterminada, Configuration Manager asigna la siguiente letra de unidad disponible a esta partición. Para guardar esta letra de unidad para su uso futuro, establezca una variable de secuencia de tareas personalizada con este parámetro.
Type: | String |
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_PartitionSettings server WMI class.