Set-Disk

Set-Disk

Takes a Disk object or unique disk identifiers and a set of attributes, and updates the physical disk on the system.

Syntax

Parameter Set: ByNumberAttributes
Set-Disk [-Number] <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-Guid <String> ] [-IsReadOnly <Boolean> ] [-Signature <UInt32> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ById
Set-Disk -UniqueId <String> [-AsJob] [-CimSession <CimSession[]> ] [-IsOffline <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByIdAttributes
Set-Disk -UniqueId <String> [-AsJob] [-CimSession <CimSession[]> ] [-Guid <String> ] [-IsReadOnly <Boolean> ] [-Signature <UInt32> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByIdConvertStyle
Set-Disk -UniqueId <String> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByNumber
Set-Disk [-Number] <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-IsOffline <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByNumberConvertStyle
Set-Disk [-Number] <UInt32> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

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

Parameter Set: ByObjectAttributes
Set-Disk -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-Guid <String> ] [-IsReadOnly <Boolean> ] [-Signature <UInt32> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByObjectConvertStyle
Set-Disk -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByPath
Set-Disk -Path <String> [-AsJob] [-CimSession <CimSession[]> ] [-IsOffline <Boolean> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByPathAttributes
Set-Disk -Path <String> [-AsJob] [-CimSession <CimSession[]> ] [-Guid <String> ] [-IsReadOnly <Boolean> ] [-Signature <UInt32> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByPathConvertStyle
Set-Disk -Path <String> [-AsJob] [-CimSession <CimSession[]> ] [-PartitionStyle <PartitionStyle> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Set-Disk cmdlet takes a Disk object or unique disk identifiers and a set of attributes, and updates the physical disk on the system.

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.

-Guid<String>

Contains a globally unique ID (GUID).

-InputObject<CimInstance[]>

Accepts an object from the pipeline as input.

-IsOffline<Boolean>

Specifies that the disk is offline.

-IsReadOnly<Boolean>

Sets the disk to be read-only, or read-write (read-only = false). Note: If the disk is set to read-only, then the disk must be set to read-only = false before using this cmdlet to set the PartitionStyle parameter.

-Number<UInt32>

Specifies a disk number on which the cmdlet acts.

-PartitionStyle<PartitionStyle>

Specifies the type of the partition. The acceptable values for this parameter are: MBR or GPT. The disk must be initialized (such as using theInitialize-Disk cmdlet) and set to read-write (IsReadOnly $false) before this cmdlet will work. The disk must be set to read-only = false before this cmdlet will work.

-Path<String>

Contains the device instance path.

-Signature<UInt32>

Contains the signature of the 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 an ID used to uniquely identify a Disk object in the system. The ID persists through restarts.

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

  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.

Ausgaben

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

• None

Beispiele

EXAMPLE 1

This example takes a disk that is offline and makes it online.

PS C:\> Set-Disk -Number 5 -IsOffline $False

EXAMPLE 2

This example takes a disk that is read-only and makes it writeable.

PS C:\> Set-Disk –Number 5 -IsReadonly $False

Verwandte Themen

Clear-Disk

Get-Disk

Initialize-Disk

Update-Disk