Export (0) Print
Expand All

Test-SpacesConfiguration

Published: February 6, 2013

Updated: February 6, 2013

Applies To: Windows 8, Windows Server 2012

Test-SpacesConfiguration

Tests for unhealthy resources associated with a Storage Spaces storage pool.

Syntax

Parameter Set: ByName
Test-SpacesConfiguration [-StoragePoolFriendlyName] <String> [[-Passthru]] [ <CommonParameters>]

Parameter Set: ByPool
Test-SpacesConfiguration [-StoragePool] <CimInstance> [[-Passthru]] [ <CommonParameters>]




Detailed Description

The Test-SpacesConfiguration cmdlet tests for unhealthy Storage Spaces resources. It performs the following operations, and returns a True code if Storage Spaces is healthy:

Enumerate storage pools that unhealthy

Enumerate storage spaces that are unhealthy

Enumerate physical disks that are unhealthy

Parameters

-Passthru

Specifies that if the storage pool is unhealthy, the cmdlet should output an object that represents the unhealthy pool.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-StoragePool<CimInstance>

Specifies the StoragePool object to test.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-StoragePoolFriendlyName<String>

Specifies the friendly name of the storage pool to test.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

true

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StoragePool

    You can pipe a StoragePool object to the StoragePool parameter.


Outputs

The output type is the type of the objects that the cmdlet emits.

  • System.Boolean

    This cmdlet outputs a Boolean object that represents whether Storage Spaces is healthy (True) or unhealthy (False).


  • System.Object

    If you specify the Passthru parameter and the storage pool is unhealthy, this cmdlet outputs an object that represents the unhealthy storage pool.


Notes

  • The StorageSpaces module is a downloadable module available for use with Windows Server 2012 and Windows 8. You can download the module from the Script Center.

Examples

Example 1 – Test a storage pool

This example tests a storage pool.


PS C:\> Test-SpacesConfiguration -StoragePoolFriendlyName Internal
This Storage Pool, the Storage Spaces created from this pool, and the Physical Disks in the Storage Pool are all currently healthy. 
True

Example 2 – Test a storage pool with verbose output

This example tests a storage pool and specifies for verbose output.


PS C:\> Test-SpacesConfiguration -StoragePoolFriendlyName Internal -Verbose

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft