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.17.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.
Experimentalbooleantrue
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, 7, 8..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.
Experimentalbooleantrue
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. "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, 7..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. "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, 7..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

Inherited Class Methods

NameReturn TypeClass Origin
ChangeAffectedElementsAssignedSequenceuint32CIM_Service
RequestStateChangeuint32CIM_EnabledLogicalElement
StartServiceuint32CIM_Service
StopServiceuint32CIM_Service