Set-PhysicalDisk

Set-PhysicalDisk

Sets attributes on a specific physical disk.

Sintaxis

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

Descripción detallada

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.

Parámetros

-AsJob

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

-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. Los valores aceptables para este parámetro son los siguientes:

-- SSD
-- HDD

-NewFriendlyName<String>

Specifies the new friendly name of the physical disk.

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o es especifica un valor de 0, Windows PowerShell ® calcula un límite óptimo para el cmdlet en función del número de cmdlets de CIM que se estén ejecutando en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.

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

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

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

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

• None

Notas

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

• El objeto Microsoft.Management.Infrastructure.CimInstance es una clase contenedora que muestra objetos de Instrumental de administración de Windows (WMI). La ruta de acceso después del signo de número (#) proporciona el espacio de nombres y el nombre de clase del objeto WMI subyacente.

Ejemplos

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

Temas relacionados

Add-PhysicalDisk

Get-PhysicalDisk

Remove-PhysicalDisk

Reset-PhysicalDisk