Set-PhysicalDisk

Set-PhysicalDisk

Sets attributes on a specific physical disk.

Syntax

Parameter Set: ByUniqueId
Set-PhysicalDisk -UniqueId <String> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-MediaType <MediaType> ] [-NewFriendlyName <String> ] [-ThrottleLimit <Int32> ] [-Usage <Usage> ] [ <CommonParameters>]

Parameter Set: ByFriendlyName
Set-PhysicalDisk [-FriendlyName] <String> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-MediaType <MediaType> ] [-NewFriendlyName <String> ] [-ThrottleLimit <Int32> ] [-Usage <Usage> ] [ <CommonParameters>]

Parameter Set: ByObject
Set-PhysicalDisk -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-MediaType <MediaType> ] [-NewFriendlyName <String> ] [-ThrottleLimit <Int32> ] [-Usage <Usage> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Set-PhysicalDisk cmdlet sets attributes on a specific physical disk in a storage pool, other than the primordial pool when using Storage Spaces.

When using the Storage Spaces subsystem, this cmdlet only works on physical disks that have been added to a storage pool.

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.

-Description<String>

Sets the description of the specified physical disk.

-FriendlyName<String>

Specifies the friendly name of the physical disk on which to set attributes.

-InputObject<CimInstance[]>

Accepts a physical disk object from the pipeline as input.

-MediaType<MediaType>

Specifies a media type. The cmdlet changes the media type that is associated with physical disk to the media type that you specify. Die folgenden Werte für diesen Parameter sind zulässig:

-- SSD
-- HDD

-NewFriendlyName<String>

Specifies the new friendly name of the physical disk.

-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.

-UniqueId<String>

Specifies the UniqueID of the physical disk on which to set attributes.

-Usage<Usage>

Specifies the allocation method (usage) for the disk. Valid values are AutoSelect, HotSpare, Journal, ManualSelect, Retired, and Unknown.

<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_PhysicalDisk

  You can use the pipeline operator to pass an MSFT_PhysicalDisk object to the InputObject parameter.

Ausgaben

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

• None

Hinweise

• When using the Storage Spaces subsystem, this cmdlet works only on physical disks that have been added to a storage pool.

• 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: Change the friendly name of a physical disk

This example changes the friendly name of PhysicalDisk4 to PhysicalDiskInSlot5.

PS C:\> Set-PhysicalDisk -FriendlyName "PhysicalDisk4" -NewFriendlyName "PhysicalDiskInSlot5"

Example 2: Change the Usage of a physical disk

This example changes the Usage property of PhysicalDisk2 to AutoSelect.

PS C:\> Set-PhysicalDisk -FriendlyName PhysicalDisk2 -Usage AutoSelect

Verwandte Themen

Add-PhysicalDisk

Get-PhysicalDisk

Remove-PhysicalDisk

Reset-PhysicalDisk