Class CIM_BIOSService
extends CIM_Service

A class derived from Service that provides the controls to manage the system BIOS configuration of a managed computer system or device. This service exposes functionality to retrieve BIOS configuration data or attributes, set BIOS attribute values, and restore a default configuration of attribute values for a given computer system.

Table of Contents
Hierarchy
Direct Known Subclasses
Class Qualifiers
Class Properties
Class Methods


Class Hierarchy

CIM_ManagedElement
   |
   +--CIM_ManagedSystemElement
   |
   +--CIM_LogicalElement
   |
   +--CIM_EnabledLogicalElement
   |
   +--CIM_Service
   |
   +--CIM_BIOSService

Direct Known Subclasses

Class Qualifiers

NameData TypeValue
DescriptionstringA class derived from Service that provides the controls to manage the system BIOS configuration of a managed computer system or device. This service exposes functionality to retrieve BIOS configuration data or attributes, set BIOS attribute values, and restore a default configuration of attribute values for a given computer system.
Experimentalbooleantrue
UMLPackagePathstringCIM::System::BIOS
Versionstring2.18.0

Class Properties

Inherited Properties

NameData TypeClass Origin
CaptionstringCIM_ManagedElement
CommunicationStatusuint16CIM_ManagedSystemElement
CreationClassNamestringCIM_Service
DescriptionstringCIM_ManagedElement
DetailedStatusuint16CIM_ManagedSystemElement
ElementNamestringCIM_ManagedElement
EnabledDefaultuint16CIM_EnabledLogicalElement
EnabledStateuint16CIM_EnabledLogicalElement
HealthStateuint16CIM_ManagedSystemElement
InstallDatedatetimeCIM_ManagedSystemElement
NamestringCIM_Service
OperatingStatusuint16CIM_ManagedSystemElement
OtherEnabledStatestringCIM_EnabledLogicalElement
PrimaryOwnerContactstringCIM_Service
PrimaryOwnerNamestringCIM_Service
PrimaryStatusuint16CIM_ManagedSystemElement
RequestedStateuint16CIM_EnabledLogicalElement
StartedbooleanCIM_Service
StartModestringCIM_Service
StatusstringCIM_ManagedSystemElement
SystemCreationClassNamestringCIM_Service
SystemNamestringCIM_Service
TimeOfLastStateChangedatetimeCIM_EnabledLogicalElement
TransitioningToStateuint16CIM_EnabledLogicalElement
AvailableRequestedStatesuint16[]CIM_EnabledLogicalElement
OperationalStatusuint16[]CIM_ManagedSystemElement
StatusDescriptionsstring[]CIM_ManagedSystemElement

Class Methods

Local Class Methods

SetBIOSAttribute (uint32)

Method Qualifiers (SetBIOSAttribute)

NameData TypeValue
DescriptionstringThis method is called to modify instances of BIOSAttribute associated with this BIOSService.
ValueMapstring0, 1, 2, 3..32767, 32768..65535
ValuesstringCompleted with No Error, Not Supported, Error, DMTF Reserved, Vendor Specified

Method Parameters (SetBIOSAttribute)

NameTypeQualifiers
NameData TypeValue
AttributeNamestring
DescriptionstringA reference to a BIOSAttribute specified by AttributeName of the BIOSAttribute to be modified.
INbooleantrue
Requiredbooleantrue
AuthorizationTokenstring
DescriptionstringWhen required, a token to modify BIOSAttribute values for this computer system. This is usually the BIOS administrator password. For example: the CIM_SharedCredential subclass may be utilized. In that case, the CIM_SharedCredential.Secret might be required and if is not specified this method would return 6 Invalid Parameter. The CIM_SharedCredential.Algorithm property might also be specified based on the propertyCIM_BIOSServiceCapabilities.SupportedPasswordAlgorithms.
EmbeddedInstancestringCIM_Credential
INbooleantrue
PasswordEncodinguint32
DescriptionstringPasswordEncoding specifies encoding tag used to denote the format the password string is being passed into the BIOS. "kbd" denotes a string in hexadecimal format containing keyboard scan code input. An example of a password structured in this format would be "321539191E1F1F11181320", which is the representation of "my password" in US English keyboard scan codes. "ascii" denotes clear text that shall comply with the ASCII character set. Character encodings from " " (decimal 32) to "~" (decimal 126) are supported. An example would be "my password"."pin" denotes that only numeric input in ASCII text is allowed for the password instance. An example would be "1234".
INbooleantrue
ValueMapstring2, 3, 4, 5, 6..32767, 32768..65535
Valuesstringascii, kbd, pin, UTF16, DMTF Reserved, Vendor Specified
SetResultuint32
DescriptionstringInvoking the SetBIOSAttribute may result in a set to CurrentValue property or the PendingValue property. SetResult returns the result of invoking the SetBIOSAttribute method when the method return code is 0 completed with no error.
INbooleanfalse
OUTbooleantrue
ValueMapstring2, 3, 4..32767, 32768..65535
ValuesstringSet CurrentValue property, Set PendingValue property, DMTF Reserved, Vendor Specified
AttributeValuestring[]
DescriptionstringA new value to assign to the specified BIOSAttribute. A value of NULL indicates the factory default value for the BIOSAttribute is requested. If this value is valid, it will be applied to the CurrentValue or PendingValue property of the specified BIOSAttribute depending on the system BIOS implementation and any requirements for a system restart.
INbooleantrue
Requiredbooleantrue
TargetBIOS REF CIM_BIOSElement
DescriptionstringIf supplied, TargetBIOS references the scoping instance of CIM_BIOSElement in which the operation is targeted. If TargetBIOS is not supplied, the target of the operation shall be the current instance of CIM_BIOSElement associated to the CIM_ComputerSystemhosting the service.
INbooleantrue

SetBIOSAttributeEmbeddedInstance (uint32)

Method Qualifiers (SetBIOSAttributeEmbeddedInstance)

NameData TypeValue
DescriptionstringThis method is called to modify instances of BIOSAttribute associated with this BIOSService using an embedded instance.
ValueMapstring0, 1, 2, 3..32767, 32768..65535
ValuesstringCompleted with No Error, Not Supported, Error, DMTF Reserved, Vendor Specified

Method Parameters (SetBIOSAttributeEmbeddedInstance)

NameTypeQualifiers
NameData TypeValue
AttributeConfigstring
DescriptionstringAttributeConfig is the input required to modify the value of a BIOSAttribute. The CIM_BIOSAttribute.AttributeName and the CIM_BIOSAttribute.CurrentValue properties are Required for this operation. If both properties are not specified the service shall return 6 Invalid Parameter.
EmbeddedInstancestringCIM_BIOSAttribute
INbooleantrue
Requiredbooleantrue
AuthorizationTokenstring
DescriptionstringWhen required, a token to modify BIOSAttribute values for this computer system. This is usually the BIOS administrator password. For example: the CIM_SharedCredential subclass may be utilized. In that case, the CIM_SharedCredential.Secret might be required and if is not specified this method would return 6 Invalid Parameter. The CIM_SharedCredential.Algorithm property might also be specified based on the propertyCIM_BIOSServiceCapabilities.SupportedPasswordAlgorithms.
EmbeddedInstancestringCIM_Credential
INbooleantrue
PasswordEncodinguint32
DescriptionstringPasswordEncoding specifies encoding tag used to denote the format the password string is being passed into the BIOS. This property is applicable if the AuthorizationToken parameter includes a password. "kbd" denotes a string in hexadecimal format containing keyboard scan code input. An example of a password structured in this format would be "321539191E1F1F11181320", which is the representation of "my password" in US English keyboard scan codes. "ascii" denotes clear text that shall comply with the ASCII character set. Character encodings from " " (decimal 32) to "~" (decimal 126) are supported. An example would be "my password"."pin" denotes that only numeric input in ASCII text is allowed for the password instance. An example would be "1234".
INbooleantrue
ValueMapstring2, 3, 4, 5, 6..32767, 32768..65535
Valuesstringascii, kbd, pin, UTF16, DMTF Reserved, Vendor Specified
SetResultuint32
DescriptionstringInvoking the SetBIOSAttributeEmbeddedInstance may result in a set to CurrentValue property or the PendingValue property. SetResult returns the result of invoking the SetBIOSAttributeEmbeddedInstance method when the method return code is 0 completed with no error.
INbooleanfalse
OUTbooleantrue
ValueMapstring2, 3, 4..32767, 32768..65535
ValuesstringSet CurrentValue property, Set PendingValue property, DMTF Reserved, Vendor Specified
TargetBIOS REF CIM_BIOSElement
DescriptionstringIf supplied, TargetBIOS references the scoping instance of CIM_BIOSElement in which the operation is targeted. If TargetBIOS is not supplied, the target of the operation shall be the current instance of CIM_BIOSElement associated to the CIM_ComputerSystemhosting the service.
INbooleantrue

RestoreBIOSDefaults (uint32)

Method Qualifiers (RestoreBIOSDefaults)

NameData TypeValue
DescriptionstringThis method is called to restore factory default values to all BIOSAttribute instances associated with this BIOSService.
Experimentalbooleantrue
ValueMapstring0, 1, 2, 3..32767, 32768..65535
ValuesstringCompleted with No Error, Not Supported, Error, DMTF Reserved, Vendor Specified

Method Parameters (RestoreBIOSDefaults)

NameTypeQualifiers
NameData TypeValue
AuthorizationTokenstring
DescriptionstringWhen required, a token to modify BIOSAttribute values for this computer system. This is usually the BIOS administrator password. For example: the CIM_SharedCredential subclass may be utilized. In that case, the CIM_SharedCredential.Secret might be required and if is not specified this method would return 6 Invalid Parameter. The CIM_SharedCredential.Algorithm property might also be specified based on the propertyCIM_BIOSServiceCapabilities.SupportedPasswordAlgorithms.
EmbeddedInstancestringCIM_Credential
INbooleantrue
PasswordEncodinguint32
DescriptionstringPasswordEncoding specifies encoding tag used to denote the format the password string is being passed into the BIOS. This property is applicable if the AuthorizationToken parameter includes a password. "kbd" denotes a string in hexadecimal format containing keyboard scan code input. An example of a password structured in this format would be "321539191E1F1F11181320", which is the representation of "my password" in US English keyboard scan codes. "ascii" denotes clear text that shall comply with the ASCII character set. Character encodings from " " (decimal 32) to "~" (decimal 126) are supported. An example would be "my password"."pin" denotes that only numeric input in ASCII text is allowed for the password instance. An example would be "1234".
INbooleantrue
ValueMapstring2, 3, 4, 5, 6..32767, 32768..65535
Valuesstringascii, kbd, pin, UTF16, DMTF Reserved, Vendor Specified
TargetBIOS REF CIM_BIOSElement
DescriptionstringIf supplied, TargetBIOS references the scoping instance of CIM_BIOSElement in which the operation is targeted. If TargetBIOS is not supplied, the target of the operation shall be the current instance of CIM_BIOSElement associated to the CIM_ComputerSystemhosting the service.
INbooleantrue

ReadRawBIOSData (uint32)

Method Qualifiers (ReadRawBIOSData)

NameData TypeValue
DescriptionstringThis method provides the ability to perform raw reads of BIOS configuration storage area. The method will return the lesser of the number of bytes specified by the NumberOfBytes parameter and the actual number of bytes available between Offset and the end of the BIOS area, starting at specified by the Offset parameter arereturned in the Data parameter.
ValueMapstring0, 1, 2, 3..65535, 65536..4294967295
ValuesstringCompleted with No Error, Not Supported, Unknown/Unspecified Error, DMTF Reserved, Vendor Specified

Method Parameters (ReadRawBIOSData)

NameTypeQualifiers
NameData TypeValue
NumberOfBytesuint32
DescriptionstringOn input, specifies the number of bytes to read. On output, specifies the number of bytes read.
INbooleantrue
OUTbooleantrue
Requiredbooleantrue
Offsetuint32
DescriptionstringSpecifies initial offset to start reading from.
INbooleantrue
Requiredbooleantrue
Datauint8[]
DescriptionstringBuffer to contain read data.
INbooleanfalse
OctetStringbooleantrue
OUTbooleantrue
TargetBIOS REF CIM_BIOSElement
DescriptionstringIf supplied, TargetBIOS references the scoping instance of CIM_BIOSElement in which the operation is targeted. If TargetBIOS is not supplied, the target of the operation shall be the current instance of CIM_BIOSElement associated to the CIM_ComputerSystem hosting the service.
INbooleantrue

WriteRawBIOSData (uint32)

Method Qualifiers (WriteRawBIOSData)

NameData TypeValue
DescriptionstringThis method provides the ability to perform raw writes of BIOS configuration storage area. The number of bytes specified by the Length parameter will be written from the Data parameter specified by the Offset parameter. If the number of bytes to write as indicated by the NumberOfBytes parameter exceeds the number of bytes from Offset to the end of the BIOS area, the method shall return 2.
ValueMapstring0, 1, 2, 3..65535, 65536..4294967295
ValuesstringCompleted with No Error, Not Supported, Unknown/Unspecified Error, DMTF Reserved, Vendor Specified

Method Parameters (WriteRawBIOSData)

NameTypeQualifiers
NameData TypeValue
AuthorizationTokenstring
DescriptionstringA token required to modify BIOSAttribute values for this computer system. This is usually the BIOS administrator password. For example: the CIM_SharedCredential subclass may be utilized. In that case, the CIM_SharedCredential.Secret might be required and if is not specified this method would return 6 Invalid Parameter. The CIM_SharedCredential.Algorithm property might also be specified based on the propertyCIM_BIOSServiceCapabilities.SupportedPasswordAlgorithms.
EmbeddedInstancestringCIM_Credential
INbooleantrue
NumberOfBytesuint32
DescriptionstringOn input, specifies the number of bytes of data to write. On output, specifies the number of bytes written.
INbooleantrue
OUTbooleantrue
Requiredbooleantrue
Offsetuint32
DescriptionstringSpecifies initial offset to start reading from.
INbooleantrue
Requiredbooleantrue
PasswordEncodinguint32
DescriptionstringPasswordEncoding specifies encoding tag used to denote the format the password string is being passed into the BIOS. This property is applicable if the AuthorizationToken parameter includes a password. "kbd" denotes a string in hexadecimal format containing keyboard scan code input. An example of a password structured in this format would be "321539191E1F1F11181320", which is the representation of "my password" in US English keyboard scan codes. "ascii" denotes clear text that shall comply with the ASCII character set. Character encodings from " " (decimal 32) to "~" (decimal 126) are supported. An example would be "my password"."pin" denotes that only numeric input in ASCII text is allowed for the password instance. An example would be "1234".
INbooleantrue
ValueMapstring2, 3, 4, 5, 6..65535, 65536..65535
Valuesstringascii, kbd, pin, UTF16, DMTF Reserved, Vendor Specified
Datauint8[]
DescriptionstringBuffer containing data to write.
INbooleantrue
OctetStringbooleantrue
TargetBIOS REF CIM_BIOSElement
DescriptionstringIf supplied, TargetBIOS references the scoping instance of CIM_BIOSElement in which the operation is targeted. If TargetBIOS is not supplied, the target of the operation shall be the current instance of CIM_BIOSElement associated to the CIM_ComputerSystem hosting the service.
INbooleantrue

Inherited Class Methods

NameReturn TypeClass Origin
ChangeAffectedElementsAssignedSequenceuint32CIM_Service
RequestStateChangeuint32CIM_EnabledLogicalElement
StartServiceuint32CIM_Service
StopServiceuint32CIM_Service