The Set-PhysicalDisk command in Windows PowerShell is a powerful tool for managing physical disks on a computer. It can be used to configure disk settings, such as the disk type, size, and partition style. It can also be used to create, delete, and modify partitions, as well as to format and mount disks. In this article, we will explore the syntax, parameters, inputs, outputs, examples, and tips for using the Set-PhysicalDisk command.
Syntax
The syntax for the Set-PhysicalDisk command is as follows:
Set-PhysicalDisk [-InputObject] <CimInstance> [-FriendlyName <String>] [-IsReadOnly <Boolean>] [-IsSystem <Boolean>] [-MediaType <MediaType>] [-PartitionStyle <PartitionStyle>] [-Size <UInt64>] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameters
The Set-PhysicalDisk command has the following parameters:
Parameter | Description |
---|---|
-InputObject |
Specifies the physical disk object to configure. |
-FriendlyName |
Specifies the friendly name for the disk. |
-IsReadOnly |
Specifies whether the disk is read-only. |
-IsSystem |
Specifies whether the disk is a system disk. |
-MediaType |
Specifies the type of media on the disk. |
-PartitionStyle |
Specifies the partition style of the disk. |
-Size |
Specifies the size of the disk. |
-ThrottleLimit |
Specifies the maximum number of concurrent operations that can be established to run the cmdlet. |
-Confirm |
Prompts you for confirmation before running the cmdlet. |
-WhatIf |
Shows what would happen if the cmdlet runs. The cmdlet is not run. |
Inputs
The Set-PhysicalDisk command takes the following inputs:
- The physical disk object to configure.
- The friendly name for the disk.
- Whether the disk is read-only.
- Whether the disk is a system disk.
- The type of media on the disk.
- The partition style of the disk.
- The size of the disk.
- The maximum number of concurrent operations that can be established to run the cmdlet.
Outputs
The Set-PhysicalDisk command does not return any output.
Examples
The following examples show how to use the Set-PhysicalDisk command:
-
To set the friendly name of a disk to “MyDisk”, use the following command:
Set-PhysicalDisk -InputObject <CimInstance> -FriendlyName "MyDisk"
-
To set the partition style of a disk to MBR, use the following command:
Set-PhysicalDisk -InputObject <CimInstance> -PartitionStyle MBR
-
To set the size of a disk to 500 GB, use the following command:
Set-PhysicalDisk -InputObject <CimInstance> -Size 500GB
Tips
When using the Set-PhysicalDisk command, keep the following tips in mind:
- Make sure you have the necessary permissions to run the command.
- Be careful when changing the partition style of a disk, as this can cause data loss.
- Make sure you have a backup of your data before running the command.
- You can use the
Get-PhysicalDisk
command to get a list of physical disks on the system. - You can use the
Format-Volume
command to format a disk after it has been partitioned. - You can use the
Mount-DiskImage
command to mount a disk image.
Conclusion
The Set-PhysicalDisk command in Windows PowerShell is a powerful tool for managing physical disks on a computer. It can be used to configure disk settings, such as the disk type, size, and partition style. It can also be used to create, delete, and modify partitions, as well as to format and mount disks. In this article, we explored the syntax, parameters, inputs, outputs, examples, and tips for using the Set-PhysicalDisk command.