New-CMTSPartitionSetting

Módulo:

ConfigurationManager

Cree un objeto de partición de disco para usarlo con el paso de secuencia de tareas Formato y Disco de partición .

Sintaxis

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 Formato y Disco de partición . 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 conmutador de partición, el cmdlet crea un objeto de configuración de partición principal.

Para obtener más información, vea Formato y partición de disco: volumen.

Ejemplos

Ejemplo 1: Creación de una configuración para una partición EFI

En este ejemplo se crea la configuración de una partición EFI de 500 MB y se guarda como la variable partEfi .

$partEfi = New-CMTSPartitionSetting -Name "EFI" -PartitionEfi -Size 500 -SizeUnit MB

Ejemplo 2: Creación de una configuración para una partición MSR

En este ejemplo se crea la configuración de una partición MSR de 128 MB y se guarda como la variable partMsr .

$partMsr = New-CMTSPartitionSetting -Name "MSR" -PartitionMsr -Size 128 -SizeUnit MB

Ejemplo 3: Creación de una configuración para una partición principal de Windows

En este ejemplo se crea la configuración de una partición principal de Windows 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: Creación de una configuración para una partición de recuperación

En este ejemplo se crea la configuración de 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: Visualización de los detalles de la configuración de la partición para un paso

En este ejemplo se obtiene primero un objeto de secuencia de tareas en la variable $tsOsd . A continuación, pasa esa variable como el objeto de entrada para obtener el paso Formato y Disco de partición .

A continuación, para ver la primera configuración de partición, haga referencia a la propiedad Partitions , que es una matriz de objetos SMS_TaskSequence_PartitionSettings .

$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 variable y agréguelo a otro paso.

Parámetros

-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

-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

-EnableDriveLetterAssignment

Establezca este parámetro true en para permitir que Configuration Manager asigne una letra de unidad a la partición.

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

-EnableQuickFormat

Establezca este parámetro true en para permitir que Configuration Manager realice un formato rápido de la partición.

Tipo:	Boolean
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

-IsBootPartition

Establezca este parámetro true en para que esta partición sea la partición de arranque.

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

-Name

Especifique un nombre para la partición.

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

-PartitionEfi

Agregue este parámetro para que el tipo de partición EFI.

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

-PartitionExtended

Agregue este parámetro para que el tipo de partición Sea Extendido.

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

-PartitionFileSystem

Especifique el sistema de archivos para dar formato a la partición.

Tipo:	FileSystemType
Valores aceptados:	Ntfs, Fat32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PartitionHidden

Agregue este parámetro para que el tipo de partición sea Oculto.

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

-PartitionLogical

Agregue este parámetro para que el tipo de partición sea lógico.

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

-PartitionMsr

Agregue este parámetro para hacer que el tipo de partición MSR.

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

-PartitionPrimary

Agregue este parámetro para que el tipo de partición sea Principal.

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

-PartitionRecovery

Agregue este parámetro para crear el tipo de partición Recovery.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 GB, especifique un número para el tamaño de partición específico.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 o GB: use -Size para establecer un tamaño específico para la partición.

Tipo:	SizeUnitType
Valores aceptados:	MB, GB, Percent
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

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

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_PartitionSettings clase WMI de servidor.

Vínculos relacionados

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• Acerca de los pasos de secuencia de tareas: formato y disco de partición
• Particiones de disco duro basadas en UEFI/GPT
• Particiones de disco duro basadas en BIOS/MBR