Class CIM_WiFiPortConfigurationService
extends CIM_NetworkPortConfigurationService

Provides methods for configuring parameters of Wi-Fi ports and the Wi-Fi protocol endpoints associated with them.

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_NetworkPortConfigurationService
   |
   +--CIM_WiFiPortConfigurationService

Direct Known Subclasses

Class Qualifiers

NameData TypeValue
DescriptionstringProvides methods for configuring parameters of Wi-Fi ports and the Wi-Fi protocol endpoints associated with them.
UMLPackagePathstringCIM::Device::Ports
Versionstring2.22.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
InstanceIDstringCIM_ManagedElement
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

AddWiFiSettings (uint32)

Method Qualifiers (AddWiFiSettings)

NameData TypeValue
DescriptionstringShall atomically create settings that enable a WiFiEndpoint to connect to a given Wi-Fi network. These settings include the name (SSID) of the network as well as the security parameters used by the WiFiEndpoint to authenticate to the network and encrypt frames it transmits into the network and decrypt the frames it receives from the network. Upon successful completion, a new instance of CIM_WiFiEndpointSettings shall be associated to the CIM_WiFiEndpoint referenced by the WiFiEndpoint parameter, through a new instance of CIM_ElementSettingData. If the IEEE8021xSettingsInput parameter is not null, a new instance of CIM_IEEE8021xSettings containing its property values shall be associated to the new instance of CIM_WiFiEndpointSettings through a new instance of CIM_ConcreteComponent upon successful completion. Alternatively, if the IEEE8021xSettingsInputReference parameter is not null, the CIM_IEEE8021xSettings that it references shall be associated to the new instance of CIM_WiFiEndpointSettings through a new instance of CIM_ConcreteComponent upon successful completion. This method shall not apply the new settings to WiFiEndpoint. Rather, it shall make them available for subsequent manual or autonomous application.
ValueMapstring0, 1, 2, 3, 4, 5..4095, 4096..32767, 32768..65535
ValuesstringCompleted with No Error, Not Supported, Failed, Invalid Parameter, Invalid Reference, DMTF Reserved, Method Reserved, Vendor Specified

Method Parameters (AddWiFiSettings)

NameTypeQualifiers
NameData TypeValue
IEEE8021xSettingsInputstring
DescriptionstringProvides the property values for a new instance of CIM_IEEE8021xSettings. If both IEEE8021xSettingsInput and IEEE8021xSettingsInputReference are not null, this method shall return 2 ("Unknown/Unspecified Error").If this parameter is not null and IEEE8021xSettingsInputReference is null, this method shall create a new CIM_IEEE8021xSettings instance with the values in this parameter, and shall associate it (through a new instance of CIM_ConcreteComponent) with the newly created instance of CIM_WiFiEndpointSettings.
EmbeddedInstancestringCIM_IEEE8021xSettings
INbooleantrue
WiFiEndpointSettingsInputstring
DescriptionstringProvides the input property values for the CIM_WiFiEndpointSettings instance that shall be created by this method. Upon successful completion of this method, a new instance of CIM_WiFiEndpointSettings shall be associated to the CIM_WiFiEndpoint referenced by the WiFiEndpoint parameter, through a new instance of CIM_ElementSettingData.
EmbeddedInstancestringCIM_WiFiEndpointSettings
INbooleantrue
Requiredbooleantrue
CACredential REF CIM_Credential
DescriptionstringReferences a credential that shall be used as a trusted root certificate by the CIM_WiFiEndpoint when it authenticates the leaf certificate provided by the authentication server. This method shall return 2 ("Unknown/Unspecified Error") if IEEE8021xSettingsInput is null and IEEE8021xCredential is not null.
INbooleantrue
ClientCredential REF CIM_Credential
DescriptionstringReferences a credential that shall be used to authenticate the CIM_WiFiEndpoint to a IEEE 802.1x authentication server. This method shall return 2 ("Unknown/Unspecified Error") if IEEE8021xSettingsInput is null and IEEE8021xCredential is not null.
INbooleantrue
IEEE8021xSettings REF CIM_IEEE8021xSettings
DescriptionstringUpon successful completion, shall contain a reference to the CIM_IEEE8021xSettings instance created by this method if and only if IEEE8021xSettingsInput was not null.
OUTbooleantrue
WiFiEndpoint REF CIM_WiFiEndpoint
DescriptionstringReferences the instance of CIM_WiFiEndpoint with which the new settings shall be associated.
INbooleantrue
Requiredbooleantrue
WiFiEndpointSettings REF CIM_WiFiEndpointSettings
DescriptionstringUpon successful completion, shall contain a reference to the CIM_WiFiEndpointSettings instance created by this method.
OUTbooleantrue

UpdateWiFiSettings (uint32)

Method Qualifiers (UpdateWiFiSettings)

NameData TypeValue
DescriptionstringShall atomically update settings that enable a WiFiEndpoint to connect to a given Wi-Fi network. These settings include the name (SSID) of the network as well as the security parameters used by the WiFiEndpoint to authenticate to the network and encrypt frames it transmits into the network and decrypt the frames it receives from the network. This method addresses the following update scenarios, each of which is given a tag line that precedes its description. Each tag line is in the form A to B, in which A indicates the type of authentication method in the settings before UpdateWiFiSettings is executed, and B indicates the type of authentication method in the settings after UpdateWiFiSettings is executed. Each of A and B is replaced in the tag lines by either "IEEE 802.1x", which indicates that the authentication method in the settings is based on IEEE 802.1x, or "Non-IEEE-802.1x", which indicates that the authentication method in the settings is not based on IEEE 802.1x. * IEEE 802.1x to IEEE 802.1x, update all: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates an IEEE 802.1x authentication method and the properties of the associated CIM_IEEE8021xSettings instance, without reverting to a non-IEEE-802.1x authentication method. In this scenario, all parameters should be not null. * IEEE 802.1x to IEEE 802.1x, update WiFi only: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates an IEEE 802.1x authentication method and that accordingly has an associated CIM_IEEE8021xSettings instance, without updating the CIM_IEEE8021xSettings instance, and without reverting to a non-IEEE-802.1x authentication method. In this scenario, the IEEE8021xSettingsInput parameter should be null and all other parameters should be not null. * IEEE 802.1x to IEEE 802.1x, update IEEE 802.1x only: Updating the properties of a CIM_IEEE8021xSettings instance that has an associated CIM_WiFiEndpointSettings instance without updating the CIM_WiFiEndpointSettings instance. In this scenario, the WiFiEndpointSettingsInput parameter should be null and all other parameters should be not null. * Non-IEEE-802.1x to Non-IEEE-802.1x: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates a non-IEEE-802.1x authentication method, and that accordingly does not have an associated CIM_IEEE8021xSettings instance, without changing the authentication method to an IEEE 802.1x method. In this scenario, the WiFiEndpointSettings and WiFiEndpointSettingsInput parameters should be not null, and the IEEE8021xSettings and IEEE8021xSettingsInput parameters should be null. * Non-IEEE-802.1x to IEEE 802.1x: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates a non-IEEE-802.1x authentication method, and that accordingly does not have an associated CIM_IEEE8021xSettings instance, and changing the authentication method to an IEEE 802.1x method. In this scenario, the IEEE8021xSettingsInput parameter should be null, and all other parameters should be not null. An instance of CIM_IEEE8021xSettings should first be created using the intrinsic method CreateInstance. Then, this method should be used with all parameters except IEEE8021xSettingsInput not null. This method shall update WiFiEndpointSettings and create a new instance of CIM_ConcreteComponent between WiFiEndpointSettings and IEEE8021xSettings. * IEEE 802.1x to Non-IEEE-802.1x: Updating the properties of a CIM_WiFiEndpointSettings instance in which the AuthenticationMethod property indicates an IEEE 802.1x authentication method and that accordingly has an associated CIM_IEEE8021xSettings instance, and reverting to a non-IEEE-802.1x authentication method. In this scenario, the IEEE8021xSettingsInput should be null, and all other parameters should be not null. This method shall delete the CIM_ConcreteComponent instance between the instances referenced by the WiFiEndpointSettings and IEEE8021xSettings parameters. If this CIM_ConcreteComponent instance is the last CIM_ConcreteComponent instance that references the CIM_IEEE8021xSettings instance referenced by the IEEE8021xSettings parameter, and the instance of CIM_IEEE8021xSettings referenced by the IEEE8021xSettings parameter was created by AddWiFiEndpointSettings, then this method shall also delete this CIM_IEEE8021xSettings instance. This method shall not apply the updated settings to any instance of CIM_WiFiEndpoint.
ValueMapstring0, 1, 2, 3, 4, 5..4095, 4096..32767, 32768..65535
ValuesstringCompleted with No Error, Not Supported, Failed, Invalid Parameter, Invalid Reference, DMTF Reserved, Method Reserved, Vendor Specified

Method Parameters (UpdateWiFiSettings)

NameTypeQualifiers
NameData TypeValue
IEEE8021xSettingsInputstring
DescriptionstringIf not null, shall provide the new property values for the instance of CIM_IEEE8021xSettings referenced by the IEEE8021xSettings parameter. If the IEEE8021xSettings is null and the IEEE8021xSettingsInput parameter is not null, this method shall return 2 ("Unknown/Unspecified Error").
EmbeddedInstancestringCIM_IEEE8021xSettings
INbooleantrue
WiFiEndpointSettingsInputstring
DescriptionstringIf not null, shall provide the new property values for the instance of CIM_WiFiEndpointSettings referenced by the WiFiEndpointSettings parameter.
EmbeddedInstancestringCIM_WiFiEndpointSettings
INbooleantrue
CACredential REF CIM_Credential
DescriptionstringReferences a credential that shall be used as a trusted root certificate by the CIM_WiFiEndpoint when it authenticates the leaf certificate provided by the authentication server.
INbooleantrue
ClientCredential REF CIM_Credential
DescriptionstringReferences a credential that shall be used to authenticate the CIM_WiFiEndpoint to a IEEE 802.1x authentication server.
INbooleantrue
IEEE8021xSettings REF CIM_IEEE8021xSettings
DescriptionstringIf not null, shall reference the CIM_IEEE8021xSettings instance that shall be updated by this method.
INbooleantrue
OUTbooleantrue
WiFiEndpointSettings REF CIM_WiFiEndpointSettings
DescriptionstringShall reference the CIM_WiFiEndpointSettings instance that shall be updated by this method.
INbooleantrue
OUTbooleantrue
Requiredbooleantrue

Inherited Class Methods

NameReturn TypeClass Origin
AddLANEndpointuint32CIM_NetworkPortConfigurationService
RequestStateChangeuint32CIM_EnabledLogicalElement
StartServiceuint32CIM_Service
StopServiceuint32CIM_Service