Set-Partition

Set-Partition

Sets attributes of a partition, such as active, read-only, and offline states.

Syntax

Parameter Set: ByNumberAttributes
Set-Partition [-DiskNumber] <UInt32> [-PartitionNumber] <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-IsActive <Boolean> ] [-IsHidden <Boolean> ] [-IsReadOnly <Boolean> ] [-NoDefaultDriveLetter <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

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

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

Parameter Set: ByDriveLetterAttributes
Set-Partition -DriveLetter <Char> [-AsJob] [-CimSession <CimSession[]> ] [-IsActive <Boolean> ] [-IsHidden <Boolean> ] [-IsReadOnly <Boolean> ] [-NoDefaultDriveLetter <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

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

Parameter Set: ByIdAccessPath
Set-Partition -DiskId <String> -Offset <UInt64> [-AsJob] [-CimSession <CimSession[]> ] [-NewDriveLetter <Char> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByIdAttributes
Set-Partition -DiskId <String> -Offset <UInt64> [-AsJob] [-CimSession <CimSession[]> ] [-IsActive <Boolean> ] [-IsHidden <Boolean> ] [-IsReadOnly <Boolean> ] [-NoDefaultDriveLetter <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

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

Parameter Set: ByNumberAccessPath
Set-Partition [-DiskNumber] <UInt32> [-PartitionNumber] <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-NewDriveLetter <Char> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByObject
Set-Partition -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-IsOffline <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByObjectAccessPath
Set-Partition -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-NewDriveLetter <Char> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByObjectAttributes
Set-Partition -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-IsActive <Boolean> ] [-IsHidden <Boolean> ] [-IsReadOnly <Boolean> ] [-NoDefaultDriveLetter <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Set-Partition cmdlet sets the attributes of a partition, including active, read-only, hidden, offline, and the drive letter.

Parameter

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-DiskId<String>

Specifies the disk ID of the partition to modify.

-DiskNumber<UInt32>

Specifies the disk number of the partition to modify.

-DriveLetter<Char>

Specifies the drive letter of the partition to modify.

-InputObject<CimInstance[]>

Specifies the Partition object to modify. Enter a Partition CIM object. The Partition object is exposed by the Get-Partition cmdlet.

-IsActive<Boolean>

Specifies that the partition is marked as active and can be used to start the system. This parameter is only relevant for MBR disks.

-IsHidden<Boolean>

Specifies that the partition is hidden. As a result, the partition does not receive a drive letter, does not receive a volume GUID path, and does not host volume mount points. This ensures that applications such as disk defragmenter do not access the partition.

-IsOffline<Boolean>

Takes the partition offline until explicitly brought back online, or until an access path is added to the partition.

-IsReadOnly<Boolean>

Sets the partition to be read-only (IsReadOnly $true) or read-write (IsReadOnly $false).

-NewDriveLetter<Char>

Specifies the new drive letter for the partition.

-NoDefaultDriveLetter<Boolean>

Specifies that the automatic assignment of a drive letter is disabled. This is only honored for GPT disks. This attribute is useful in storage area network (SAN) environments.

-Offset<UInt64>

Specifies the partition's offset from the beginning of the disk, measured in bytes.

-PartitionNumber<UInt32>

Specifies the number of the partition.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

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

  You can pipe a Partition object to the InputObject parameter to specify the partition you want to modify by Partition object.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• None

Hinweise

• Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Objekte der Windows-Verwaltungsinstrumentation (WMI) anzeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts bereit.

Beispiele

Example 1: Set the partition to read-only

This example makes partition Y read-only.

PS C:\> Set-Partition -DriveLetter Y -IsReadOnly $True

Example 2: Set an MBR partition to active

This example makes the MBR partition Y active.

PS C:\> Set-Partition -DriveLetter Y -IsActive $True

Example 3: Hide the partition

This example hides partition Y.

PS C:\> Set-Partition -DriveLetter Y -IsHidden $True

Example 4: Take the partition offline

This example takes the partition and volume offline.

PS C:\> Set-Partition -DriveLetter Y -IsOffline $True

Example 5: Change the drive letter

This example changes the drive letter from Y to Z.

PS C:\> Set-Partition -DriveLetter Y -NewDriveLetter Z

Verwandte Themen

Get-Partition

New-Partition