Resize-Partition

Resize-Partition

Resizes a partition and the underlying file system.

Syntaxe

Parameter Set: ByDriveLetter
Resize-Partition [-Size] <UInt64> -DriveLetter <Char[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ById
Resize-Partition [-Size] <UInt64> -DiskId <String[]> -Offset <UInt64[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByNumber
Resize-Partition [-DiskNumber] <UInt32[]> [-PartitionNumber] <UInt32[]> [-Size] <UInt64> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Resize-Partition [-Size] <UInt64> -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Description détaillée

The Resize-Partition cmdlet resizes a partition and the underlying file system.

Paramètres

-AsJob

-CimSession<CimSession[]>

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, comme la sortie d’une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.

-DiskId<String[]>

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

-DiskNumber<UInt32[]>

Specifies the number of the disk.

-DriveLetter<Char[]>

Specifies a letter used to identify a drive or volume in the system.

-InputObject<CimInstance[]>

Accepts an object from the pipeline as input.

-Offset<UInt64[]>

Specifies the starting offset, in bytes.

-PartitionNumber<UInt32[]>

Specifies the number of the partition. The number of the partition to be resized.

-PassThru

Sends items from the interactive window down the pipeline as input to other cmdlets. By default, this cmdlet does not generate any output.
To send items from the interactive window down the pipeline, click to select the items and then click OK. Shift-click and Ctrl-click are supported.

-Size<UInt64>

Specifies the size of the partition to create. If not specified, then the number will default to Bytes. The acceptable values for this parameter are: Bytes, KB, MB, GB, or TB. The size may be defined by a user.

-ThrottleLimit<Int32>

Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter cette applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell ® calcule une limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limitation s’applique seulement à l’applet de commande actuelle, et non pas à la session ni à l’ordinateur.

-Confirm

Votre confirmation sera requise avant l’exécution de l’applet de commande.

-WhatIf

Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_Partition

  L’objet Microsoft.Management.Infrastructure.CimInstance est une classe wrapper qui affiche des objets WMI (Windows Management Instrumentation). Le chemin d’accès situé après le symbole dièse (#) fournit l’espace de noms et le nom de classe de l’objet WMI sous-jacent.

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_Partition

  L’objet Microsoft.Management.Infrastructure.CimInstance est une classe wrapper qui affiche des objets WMI (Windows Management Instrumentation). Le chemin d’accès situé après le symbole dièse (#) fournit l’espace de noms et le nom de classe de l’objet WMI sous-jacent.

Exemples

EXAMPLE 1

This example starts with a 931.39 GB partition.

PS C:\> Get-Partition -DiskNumber 3 -PartitionNumber 2

Resize the partition to 900GB.

PS C:\> Resize-Partition -DiskNumber 3 -PartitionNumber 2 -Size (900GB)

The partition is now 900GB.

PS C:\> Get-Partition -DiskNumber 3 -PartitionNumber 2

Get the partition sizes.

PS C:\> $size = (Get-PartitionSupportedSize –DiskNumber 3 –PartitionNumber 2)

Resize to the maximum size.

PS C:\> Resize-Partition -DiskNumber 3 –PartitionNumber 2 -Size $size.SizeMax

Rubriques connexes

Get-Partition

Get-PartitionSupportedSize