Ler em inglês

Compartilhar via


Get-Partition

Get-Partition

Returns a list of all partition objects visible on all disks, or optionally a filtered list using specified parameters.

Sintaxe

Parameter Set: ByNumber
Get-Partition [[-DiskNumber] <UInt32[]> ] [[-PartitionNumber] <UInt32[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByDisk
Get-Partition [-AsJob] [-CimSession <CimSession[]> ] [-Disk <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByDriveLetter
Get-Partition [-AsJob] [-CimSession <CimSession[]> ] [-DriveLetter <Char[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ById
Get-Partition [-AsJob] [-CimSession <CimSession[]> ] [-DiskId <String[]> ] [-Offset <UInt64[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByVolume
Get-Partition [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [-Volume <CimInstance> ] [ <CommonParameters>]

Descrição detalhada

The Get-Partition cmdlet returns one or more Partition objects depending on the specified criteria. This cmdlet will return a Volume object or a set of Volume objects given parameters to be used to uniquely identify a volume, or parameters to identify a set of volumes that meet the given set of criteria.

Parâmetros

-AsJob

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-CimSession<CimSession[]>

Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome do computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession. O padrão é a sessão atual do computador local.

Aliases

Session

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Disk<CimInstance>

Accepts a Disk object as input. The Disk CIM object is exposed by the Get-Disk cmdlet.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByValue)

Aceitar caracteres curinga?

false

-DiskId<String[]>

Specifies an ID used to identify a disk in the system.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByPropertyName)

Aceitar caracteres curinga?

false

-DiskNumber<UInt32[]>

Specifies the number of the disk.

Aliases

nenhuma

Necessário?

false

Posição?

1

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByPropertyName)

Aceitar caracteres curinga?

false

-DriveLetter<Char[]>

Specifies a letter used to identify a drive or volume in the system. Specifically the drive on which the partition resides.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByPropertyName)

Aceitar caracteres curinga?

false

-Offset<UInt64[]>

Specifies the starting offset, in bytes.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByPropertyName)

Aceitar caracteres curinga?

false

-PartitionNumber<UInt32[]>

Specifies the number of the partition.

Aliases

Number

Necessário?

false

Posição?

2

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByPropertyName)

Aceitar caracteres curinga?

false

-ThrottleLimit<Int32>

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet. Se esse parâmetro for omitido ou um valor de 0 for inserido, o Windows PowerShell® calculará o limite ideal de restrição para o cmdlet com base no número de cmdlets do CIM que estão em execução no computador. O limite de restrição se aplica somente ao cmdlet atual, e não à sessão ou ao computador.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Volume<CimInstance>

Accepts a Volume object as input. The Volume CIM object is exposed by the Get-Volume cmdlet.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByValue)

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet dá suporte a parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet.

Saídas

O tipo de saída é o tipo de objeto emitido pelo cmdlet.

Exemplos

EXAMPLE 1

This example return all partitions, on all disks.

PS C:\> Get-Partition

EXAMPLE 2

This example return all partitions on disk 5.

PS C:\> Get-Partition -DiskNumber 5

EXAMPLE 3

This example partition associated with the volume for drive letter C.

PS C:\> Get-Partition -DriveLetter C

EXAMPLE 4

This example returns only the basic partitions on all disks.

PS C:\> Get-Partition | Where-Object –FilterScript {$_.Type -Eq "Basic"}

Tópicos relacionados

Get-Disk

Get-Volume

Where-Object