New-CMTSPartitionSetting

Módulo:

ConfigurationManager

Crie um objeto de partição de disco a ser usado com a etapa de sequência de tarefas Format and 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 cria um objeto de partição de disco a ser usado com a etapa de sequência de tarefas Format and Partition Disk. Use este cmdlet para definir as configurações de partição e use esse objeto com o parâmetro -PartitionSetting dos cmdlets New-CMTSStepPartitionDisk ou Set-CMTSStepPartitionDisk.

Você pode criar os seguintes tipos de objetos de configurações de partição, com base no parâmetro switch que você usa com este cmdlet:

• PartitionPrimary: Partição primária
• PartitionEfi Partição EFI
• PartitionExtended: Partição estendida
• PartitionHidden: Partição oculta
• PartitionLogical: Partição lógica
• PartiçãoMsr: partição MSR
• PartitionRecovery: Partição de recuperação

Se você não especificar um parâmetro de opção de partição, o cmdlet criará um objeto de configurações de partição principal.

Para obter mais informações, consulte Format and Partition Disk: Volume.

Exemplos

Exemplo 1: Criar configurações para uma partição EFI

Este exemplo cria configurações para uma partição EFI de 500 MB e salva-a como a variável partEfi.

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

Exemplo 2: Criar configurações para uma partição MSR

Este exemplo cria configurações para uma partição MSR de 128 MB e salva-a como a variável partMsr.

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

Exemplo 3: Criar configurações para uma partição Windows principal

Este exemplo cria configurações para uma Windows partição primária e a salva como a variável partWin.

$partWin = New-CMTSPartitionSetting -Name "Windows" -PartitionPrimary -Size 99 -SizeUnit Percent -EnableDriveLetterAssignment $true -EnableQuickFormat $true -PartitionFileSystem NTFS -IsBootPartition $true

Exemplo 4: Criar configurações para uma partição de recuperação

Este exemplo cria configurações para uma partição De recuperação que é 100% do espaço em disco restante e o salva como a variável partMsr.

$partRec = New-CMTSPartitionSetting -Name "Recovery" -PartitionRecovery -Size 100 -SizeUnit Percent

Exemplo 5: Exibir os detalhes da configuração de partição para uma etapa

Este exemplo obtém primeiro um objeto de sequência de tarefas na $tsOsd variável. Em seguida, ele passa essa variável como o objeto de entrada para obter a etapa Formato e Disco de Partição.

Em seguida, para exibir as primeiras configurações de partição, consulte a propriedade Partitions, que é uma 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]

Você pode usar esse processo para copiar configurações de partição entre etapas ou sequências de tarefas. Salve este objeto de configurações de partição como uma variável e adicione-o a outra etapa.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableDriveLetterAssignment

De definir esse parâmetro true para permitir que o Configuration Manager atribua uma letra de unidade à partição.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableQuickFormat

De definir esse parâmetro true para permitir que o Configuration Manager faça um formato rápido da partição.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsBootPartition

De definir esse parâmetro true como para tornar essa partição a partição de inicialização.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifique um nome para a partição.

Type:	String
Aliases:	PartitionName, VolumeName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionEfi

Adicione esse parâmetro para tornar o tipo de partição EFI.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionExtended

Adicione esse parâmetro para tornar o tipo de partição Estendido.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionFileSystem

Especifique o sistema de arquivos para formatar a partição.

Type:	FileSystemType
Accepted values:	Ntfs, Fat32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionHidden

Adicione esse parâmetro para tornar o tipo de partição Oculto.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionLogical

Adicione esse parâmetro para tornar o tipo de partição Lógico.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionMsr

Adicione esse parâmetro para tornar o tipo de partição MSR.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionPrimary

Adicione esse parâmetro para tornar o tipo de partição principal.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionRecovery

Adicione esse parâmetro para tornar o tipo de partição Recovery.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Size

Especifique um valor inteiro para o tamanho da partição. Use esse parâmetro com o parâmetro -SizeUnit. Se -SizeUnit for Percent , especifique um número entre 1-100 para esse parâmetro. Se -SizeUnit MB for ou , GB especifique um número para o tamanho de partição específico.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SizeUnit

Especifique o tipo de unidade para o tamanho. Use esse parâmetro com o parâmetro -Size.

• Percent: Use -Size para definir a partição como uma porcentagem de espaço livre restante no disco.

• MB ou GB : Use -Size para definir um tamanho específico para a partição.

Type:	SizeUnitType
Accepted values:	MB, GB, Percent
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Variable

Por padrão, o Configuration Manager atribui a próxima letra de unidade disponível a essa partição. Para salvar essa letra de unidade para uso futuro, de definir uma variável de sequência de tarefas personalizada com esse parâmetro.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Nenhum

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_PartitionSettings classe WMI do servidor.

Links Relacionados

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• Sobre etapas de sequência de tarefas - Formato e Disco de Partição
• Partições de disco rígido baseadas em UEFI/GPT
• Partições de disco rígido baseadas em BIOS/MBR