Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MSISCSITARGET_StorageCapabilities class

Defines the capabilities of a storage service or MSISCSITARGET_StoragePool. For example, an instance of MSISCSITARGET_StorageCapabilities could be associated with either a MSISCSITARGET_StorageConfigurationService or MSISCSITARGET_StoragePool by using MSISCSITARGET_ElementCapabilities.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

class MSISCSITARGET_StorageCapabilities : CIM_StorageCapabilities
{
  uint16  ElementType;
  boolean NoSinglePointOfFailure;
  boolean NoSinglePointOfFailureDefault;
  uint16  DataRedundancyMax;
  uint16  DataRedundancyMin;
  uint16  DataRedundancyDefault;
  uint16  PackageRedundancyMax;
  uint16  PackageRedundancyMin;
  uint16  PackageRedundancyDefault;
  uint16  DeltaReservationMax;
  uint16  DeltaReservationMin;
  uint16  DeltaReservationDefault;
  uint16  ExtentStripeLengthDefault;
  uint16  ParityLayoutDefault;
  uint64  UserDataStripeDepthDefault;
  string  InstanceID;
  string  ElementName;
  string  Caption;
  string  Description;
};

Members

The MSISCSITARGET_StorageCapabilities class has these types of members:

Methods

The MSISCSITARGET_StorageCapabilities class has these methods.

MethodDescription
CreateSetting

Creates and populates a MSISCSITARGET_StorageSetting instance from a MSISCSITARGET_StorageCapabilities instance.

This method is inherited from the CIM_StorageCapabilities class.

GetSupportedParityLayouts

Retrieves the supported parity layouts for systems that support parity-based storage organizations for volume or pool creation.

This method is inherited from the CIM_StorageCapabilities class.

GetSupportedStripeDepthRange

Retrieves the supported stripe depth range for systems that support a range of user data stripe depths.

This method is inherited from the CIM_StorageCapabilities class.

GetSupportedStripeDepths

Retrieves a list of supported values for systems that support discrete user data stripe depths.

This method is inherited from the CIM_StorageCapabilities class.

GetSupportedStripeLengthRange

Retrieves the supported range of extent stripe lengths for systems that support a range of lengths.

This method is inherited from the CIM_StorageCapabilities class.

GetSupportedStripeLengths

Retrieves a list of supported extent stripe lengths for systems that support discrete lengths.

This method is inherited from the CIM_StorageCapabilities class.

 

Properties

The MSISCSITARGET_StorageCapabilities class has these properties.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

Provides a short textual description of the object.

This property is inherited from the CIM_ManagedElement class.

DataRedundancyDefault
Data type: uint16
Access type: Read-only
Qualifiers: MinValue (1)

Indicates the default number of complete copies of data that can be maintained. The DataRedundancyMax and DataRedundancyMin properties set the upper and lower bounds.

This property is inherited from the CIM_StorageCapabilities class.

DataRedundancyMax
Data type: uint16
Access type: Read-only
Qualifiers: MinValue (1)

Indicates the maximum number of complete copies of data that can be maintained.

This property is inherited from the CIM_StorageCapabilities class.

DataRedundancyMin
Data type: uint16
Access type: Read-only
Qualifiers: MinValue (1)

Indicates the minimum number of complete copies of data that can be maintained.

This property is inherited from the CIM_StorageCapabilities class.

DeltaReservationDefault
Data type: uint16
Access type: Read-only
Qualifiers: MinValue (0) , MaxValue (100) , Units ("Percentage")

Indicates the default amount of space that is reserved in a replica to cache changes. The DeltaReservationMax and DeltaReservationMin properties set the upper and lower bounds.

This property is inherited from the CIM_StorageCapabilities class.

DeltaReservationMax
Data type: uint16
Access type: Read-only
Qualifiers: MinValue (0) , MaxValue (100) , Units ("Percentage")

Indicates the maximum amount of space that is reserved in a replica to cache changes.

This property is inherited from the CIM_StorageCapabilities class.

DeltaReservationMin
Data type: uint16
Access type: Read-only
Qualifiers: MinValue (0) , MaxValue (100) , Units ("Percentage")

Indicates the minimum amount of space that is reserved in a replica to cache changes.

This property is inherited from the CIM_StorageCapabilities class.

Description
Data type: string
Access type: Read-only

Provides a textual description of the object.

This property is inherited from the CIM_ManagedElement class.

ElementName
Data type: string
Access type: Read-only
Qualifiers: Required

Contains a user-friendly name for the object. This property enables each instance to define a user-friendly name in addition to its key properties, identity data, and description information.

This property is inherited from the CIM_Capabilities class.

ElementType
Data type: uint16
Access type: Read-only

Indicates the type of element to which this MSISCSITARGET_StorageCapabilities instance applies.

The possible values are.

Unknown (0)
Reserved (1)
Any Type (2)
StorageVolume (3)
StorageExtent (4)
StoragePool (5)
StorageConfigurationService (6)
LogicalDisk (7)

This property is inherited from the CIM_StorageCapabilities class.

ExtentStripeLengthDefault
Data type: uint16
Access type: Read-only
Qualifiers: MinValue (1)

Indicates the number of underlying MSISCSITARGET_StorageVolume instances across which data is striped in the common striping-based storage organizations. This can also be referred to as the number of members or columns. A NULL value indicates that the system does not support specifying stripe length.

If specifying stripe length is supported, and this MSISCSITARGET_StorageCapabilities instance is associated with a pool that was created with a range of QoS, then the ExtentStripeLengthDefault represents the default value. Other available values, such as min, max, and discrete values, can be retrieved by using the GetSupportedStripeLengths and GetSupportedStripeLengthRange methods.

If specifying stripe length is supported and the pool was created with a single specific QoS, then this property represents the current fixed value for the pool, and specifying stripe length is not supported when you create subelements from this pool. In that case, you cannot use the GetSupportedStripeLengthRange and GetSupportedStripeLengths methods, and when you create or modify a child element, the ExtentStripeLengthGoal, ExtentStripeLengthMin, and ExtentStripeLengthMax properties must be set to NULL in the MSISCSITARGET_StorageSetting instance that you use as a goal.

For more information about QoS settings, see MSISCSITARGET_StorageSetting.

This property is inherited from the CIM_StorageCapabilities class.

InstanceID
Data type: string
Access type: Read-only
Qualifiers: Key

Uniquely and opaquely identifies an instance of this class within the scope of the containing namespace.

Important  In order to ensure uniqueness within the namespace, the value of the InstanceID property should be constructed in the following pattern:

OrgID:LocalID

OrgID must include a copyrighted, trademarked, or otherwise unique name that is owned by the business entity that defines the InstanceID, or must be a registered ID that is assigned by a recognized global authority. This pattern is similar to the structure of schema class names. In addition, to ensure uniqueness, the first colon in InstanceID must be between the OrgID andLocalID. Therefore the OrgID name must not contain a colon (':').

LocalID is chosen by the business entity and should not be re-used to identify different underlying real-world elements.

If the preceding pattern is not used, the defining entity must ensure that the resultant InstanceID is not re-used across any InstanceID properties that are produced by this or other providers for this namespace.

For Distributed Management Task Force (DMTF) defined instances, the pattern must be used with the OrgID set to CIM.

This property is inherited from the CIM_Capabilities class.

NoSinglePointOfFailure
Data type: boolean
Access type: Read-only

Indicates whether the associated element supports no single point of failure. Set to true if the element supports no single point of failure; otherwise false.

This property is inherited from the CIM_StorageCapabilities class.

NoSinglePointOfFailureDefault
Data type: boolean
Access type: Read-only

Indicates the default value for the NoSinglePointOfFailure property.

This property is inherited from the CIM_StorageCapabilities class.

PackageRedundancyDefault
Data type: uint16
Access type: Read-only

Indicates the default number of redundant packages to use. For example, in the case of storage, package redundancy indicates how many disk spindles can fail without data loss that include, at most, one spare. A RAID5 system with a spare disk would have a Package Redundancy property of 2. The PackageRedundancyMax and PackageRedundancyMin properties set the upper and lower bounds.

Possible values are.

Range: 0 ≤ value

This property is inherited from the CIM_StorageCapabilities class.

PackageRedundancyMax
Data type: uint16
Access type: Read-only

Indicates the maximum number of redundant packages that can be used.

Possible values are.

Range: 0 ≤ value

This property is inherited from the CIM_StorageCapabilities class.

PackageRedundancyMin
Data type: uint16
Access type: Read-only

Indicates the minimum number of redundant packages that can be used.

Possible values are.

Range: 0 ≤ value

This property is inherited from the CIM_StorageCapabilities class.

ParityLayoutDefault
Data type: uint16
Access type: Read-only

Indicates whether a parity-based storage organization is using rotated or non-rotated parity. A NULL value indicates that the system does not support specifying parity layout.

The possible values are.

Non-Rotated Parity (2)
Rotated Parity (3)

If this MSISCSITARGET_StorageCapabilities instance is associated with a pool that was created with a range of QoS, then ParityLayoutDefault represents the default value. Other available values can be determined by using the GetSupportedParityLayouts method.

If the pool was created with a single specific QoS, this property represents the current fixed value for the pool, and you cannot specify the parity layout when you create elements from this pool. In this case, you cannot use the GetSupportedParityLayouts method, and when you create or modify a child element, the ParityLayoutGoal property must be set to NULL in the MSISCSITARGET_StorageSetting instance that you use as a goal.

For more information about QoS settings, see MSISCSITARGET_StorageSetting.

This property is inherited from the CIM_StorageCapabilities class.

UserDataStripeDepthDefault
Data type: uint64
Access type: Read-only
Qualifiers: MinValue (1) , Units ("Bytes")

Indicates the number of bytes that form a strip in common striping-based storage organizations. The strip is defined as the size of the portion of a stripe that lies on one extent. A NULL value indicates that the system does not support specifying stripe depth.

If specifying stripe depth is supported, and this MSISCSITARGET_StorageCapabilities instance is associated with a pool that was created with a range of QoS, then the UserDataStripeDepthDefault represents the default value. Other available values, such as min, max, and discrete values, can be retrieved by using the GetSupportedStripeDepths and GetSupportedStripeDepthRange methods.

If specifying stripe depth is supported and the pool was created with a single specific QoS, then this property represents the current fixed value for the pool, and specifying stripe depth is not supported when you create subelements from this pool. In that case, you cannot use the GetSupportedStripeDepths and GetSupportedStripeDepthRange methods, and when you create or modify a child element, the UserDataStripeDepthGoal, UserDataStripeDepthMin, and UserDataStripeDepthMax properties must be set to NULL in the MSISCSITARGET_StorageSetting instance that you use as a goal.

For more information about QoS settings, see MSISCSITARGET_StorageSetting.

This property is inherited from the CIM_StorageCapabilities class.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2012 R2

Namespace

\\.\root\cimv2\storage\iscsitarget

MOF

SmIscsiTarget.mof

See also

iSCSI Target Server Reference
MSISCSITARGET_StoragePool
MSISCSITARGET_StorageSetting

 

 

Show:
© 2014 Microsoft