New-CMTSPartitionSetting

Módulo:

ConfigurationManager

Crie um objeto de partição de disco para utilizar com o passo de sequência de tarefas Formatar e Particionar Disco .

Sintaxe

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 para utilizar com o passo de sequência de tarefas Formatar e Particionar Disco . Utilize este cmdlet para definir as definições de partição e, em seguida, utilize esse objeto com o parâmetro -PartitionSetting dos cmdlets New-CMTSStepPartitionDisk ou Set-CMTSStepPartitionDisk .

Pode criar os seguintes tipos de objetos de definições de partição, com base no parâmetro de comutador que utiliza com este cmdlet:

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

Se não especificar um parâmetro de comutador de partição, o cmdlet cria um objeto de definições de partição primária.

Para obter mais informações, veja Format and Partition Disk: Volume (Formatar e Particionar Disco: Volume).

Exemplos

Exemplo 1: criar definições para uma partição EFI

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

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

Exemplo 2: criar definições para uma partição MSR

Este exemplo cria definições para uma partição MSR com 128 MB e guarda-a como a variável partMsr .

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

Exemplo 3: criar definições para uma partição primária do Windows

Este exemplo cria definições para uma partição primária do Windows e guarda-a 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 definições para uma partição de recuperação

Este exemplo cria definições para uma partição de Recuperação que corresponde a 100% do espaço em disco restante e guarda-o como a variável partMsr .

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

Exemplo 5: Ver os detalhes da definição da partição de um passo

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

Em seguida, para ver as primeiras definições de partição, faça referência à propriedade Partições , que é uma 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]

Pode utilizar este processo para copiar definições de partição entre passos ou sequências de tarefas. Guarde este objeto de definições de partição como uma variável e, em seguida, adicione-o a outro passo.

Parâmetros

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableDriveLetterAssignment

Defina este parâmetro como para true permitir que o Configuration Manager atribua uma letra de unidade à partição.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableQuickFormat

Defina este parâmetro como true para permitir que o Configuration Manager efetue um formato rápido da partição.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IsBootPartition

Defina este parâmetro como para true tornar esta partição na partição de arranque.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Name

Especifique um nome para a partição.

Tipo:	String
Aliases:	PartitionName, VolumeName
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionEfi

Adicione este parâmetro para criar o tipo de partição EFI.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionExtended

Adicione este parâmetro para tornar o tipo de partição Expandido.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionFileSystem

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

Tipo:	FileSystemType
Valores aceitos:	Ntfs, Fat32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionHidden

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionLogical

Adicione este parâmetro para tornar o tipo de partição Lógica.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionMsr

Adicione este parâmetro para criar o tipo de partição MSR.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionPrimary

Adicione este parâmetro para tornar o tipo de partição Principal.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PartitionRecovery

Adicione este parâmetro para tornar o tipo de partição Recuperação.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Size

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

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SizeUnit

Especifique o tipo de unidade para o tamanho. Utilize este parâmetro com o parâmetro -Size .

• Percent: utilize -Size para definir a partição para uma percentagem do espaço livre restante no disco.

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

Tipo:	SizeUnitType
Valores aceitos:	MB, GB, Percent
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Variable

Por predefinição, o Configuration Manager atribui a próxima letra de unidade disponível a esta partição. Para guardar esta letra de unidade para utilização futura, defina uma variável de sequência de tarefas personalizada com este parâmetro.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_PartitionSettings classe WMI de servidor.

Links Relacionados

• Get-CMTSStepPartitionDisk
• New-CMTSStepPartitionDisk
• Set-CMTSStepPartitionDisk
• Acerca dos passos de sequência de tarefas – Formatar e Particionar Disco
• Partições de disco rígido baseadas em UEFI/GPT
• Partições de disco rígido baseadas em BIOS/MBR