Get-StorageEnclosure

Get-StorageEnclosure

Gets storage enclosures.

Syntax

Parameter Set: ByUniqueId
Get-StorageEnclosure [-AsJob] [-CimSession <CimSession[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-ThrottleLimit <Int32> ] [-UniqueId <String[]> ] [ <CommonParameters>]

Parameter Set: ByFriendlyName
Get-StorageEnclosure [[-FriendlyName] <String[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByPhysicalDisk
Get-StorageEnclosure [-AsJob] [-CimSession <CimSession[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-PhysicalDisk <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByStorageNode
Get-StorageEnclosure [-AsJob] [-CimSession <CimSession[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-StorageNode <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: ByStorageSubSystem
Get-StorageEnclosure [-AsJob] [-CimSession <CimSession[]> ] [-HealthStatus <HealthStatus[]> ] [-Manufacturer <String[]> ] [-Model <String[]> ] [-StorageSubSystem <CimInstance> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Get-StorageEnclosure cmdlet gets storage enclosures that are visible to your computer.

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.

-FriendlyName<String[]>

Specifies an array of friendly names. The cmdlet gets storage enclosures that the names specify.

-HealthStatus<HealthStatus[]>

Specifies an array of health status values. Die folgenden Werte für diesen Parameter sind zulässig:

-- Healthy
-- Warning
-- Unhealthy
-- Unknown

Health status describes the health of an enclosure. This cmdlet gets the enclosures that have health statuses that this parameter specifies.

-Manufacturer<String[]>

Specifies the name of a manufacturer. This cmdlet gets enclosures for the manufacturers that this parameter identifies.

-Model<String[]>

Specifies an array of model IDs. This cmdlet gets enclosures that the model IDs specify.

-PhysicalDisk<CimInstance>

Specifies a physical disk as a CimInstance object. The cmdlet gets storage enclosures that contain the disk that the object specifies. To obtain a physical disk object, use the Get-PhysicalDisk cmdlet.

-StorageNode<CimInstance>

Specifies a storage node as a CimInstance object. The cmdlet gets storage enclosures connected to the storage node that the object specifies. To obtain a storage node object, use the Get-StorageNode cmdlet.

-StorageSubSystem<CimInstance>

Specifies a storage subsystem as a CimInstance object. This cmdlet gets storage enclosures that belong to the subsystem that the object specifies. To obtain a storage subsystem object, use the Get-StorageSubSystem cmdlet.

-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 array of IDs. This cmdlet gets the enclosures that the IDs specify.

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

Ausgaben

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

• MSFT_StorageEnclosure[]

  This cmdlet returns an array of StorageEnclosure objects.

Beispiele

Example 1: Get all enclosures

This command gets all the enclosures visible to your computer.

PS C:\> Get-StorageEnclosure

Example 2: Get an enclosure by using a friendly name

This command gets the enclosure named E1.

PS C:\> Get-StorageEnclosure -FriendlyName "E1"

Example 3: Get an enclosure by using an ID

This command gets the enclosure that has the specified UniqueId.

PS C:\> Get-StorageEnclosure -UniqueId "{b2c21800-b833-11e2-9981-806e6f6e6963}"

Example 4: Get unhealthy enclosures

This command gets enclosures that have the health status of Unhealthy.

PS C:\> Get-StorageEnclosure -HealthStatus "Unhealthy"

Example 5: Get enclosures from a manufacturer

This command gets enclosures from a specific manufacturer.

PS C:\> Get-StorageEnclosure -Manufacturer "Fabrikam"

Example 6: Get an enclosure that contains a specified disk

This command uses the Get-PhysicalDisk cmdlet to get the disk named PhysicalDisk35, and then passes that object to the current cmdlet by using the pipeline operator. The current cmdlet gets the enclosure that contains the disk named PhysicalDisk35.

PS C:\> Get-PhysicalDisk -FriendlyName "PhysicalDisk35" | Get-StorageEnclosure

Example 7: Get enclosures attached to a storage node

This command uses the Get-StorageNode cmdlet to get the storage node named Node14, and then passes that object to the current cmdlet by using the pipeline operator. The current cmdlet gets enclosures attached to the node named Node14.

PS C:\> Get-StorageNode -Name "Node14" | Get-StorageEnclosure

Example 8: Get enclosures on a subsystem

This command uses the Get-StorageSubSystem cmdlet to get the storage subsystem that has the specified friendly name, and then passes that object to the current cmdlet by using the pipeline operator. The current cmdlet gets enclosures on the specified subsystem.

PS C:\> Get-StorageSubSystem -FriendlyName "Clustered storage spaces on main cluster" | Get-StorageEnclosure

Verwandte Themen

Get-StorageEnclosureVendorData

Disable-StorageEnclosureIdentification

Enable-StorageEnclosureIdentification

Get-PhysicalDisk

Get-StorageNode

Get-StorageSubSystem