New-CMTSPartitionSetting

Referencia

Módulo:: ConfigurationManager

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 o GB : 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.