Synopsis:
The client invokes this method to perform registration with the server by providing information about its operating system, hardware, and network parameter configuration.
<wsdl:operation name="RegisterComputer">
The SOAP operation is defined as follows.
<soap:operation soapAction="http://www.microsoft.com/
SoftwareDistribution/Server/ClientWebService/RegisterComputer"
style="document" />
Request:
<s:element name="RegisterComputer">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="cookie"
type="s1:Cookie" />
<s:element minOccurs="0" maxOccurs="1" name="computerInfo"
type="s1:ComputerInfo" />
</s:sequence>
</s:complexType>
</s:element>
cookie: Specifies a cookie that MUST have been obtained from a previous call to GetCookie (section 2.2.3.2), GetFileLocations (section 2.2.3.7), or SyncUpdates (section 2.2.3.4). This element MUST be present.
computerInfo: Information about the client computer. Its format is as follows.
<s:complexType name="ComputerInfo">
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="DnsName"
type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="OSMajorVersion"
type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="OSMinorVersion"
type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="OSBuildNumber"
type="s:int" />
<s:element minOccurs="1" maxOccurs="1" name="OSServicePackMajorNumber"
type="s:short" />
<s:element minOccurs="1" maxOccurs="1" name="OSServicePackMinorNumber"
type="s:short" />
<s:element minOccurs="0" maxOccurs="1" name="OSLocale"
type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ComputerManufacturer"
type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="ComputerModel"
type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="BiosVersion"
type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="BiosName"
type="s:string" />
<s:element minOccurs="1" maxOccurs="1" name="BiosReleaseDate"
type="s:dateTime" />
<s:element minOccurs="0" maxOccurs="1" name="ProcessorArchitecture"
type="s:string" />
<s:element minOccurs="0" maxOccurs="1" name="SuiteMask"
type="s:short" />
<s:element minOccurs="0" maxOccurs="1" name="OldProductType"
type="s:unsignedByte" />
<s:element minOccurs="0" maxOccurs="1" name="NewProductType"
type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="SystemMetrics"
type="s:int" />
<s:element minOccurs="0" maxOccurs="1" name="ClientVersionMajorNumber"
type="s:short" />
<s:element minOccurs="0" maxOccurs="1" name="ClientVersionMinorNumber"
type="s:short" />
<s:element minOccurs="0" maxOccurs="1" name="ClientVersionBuildNumber"
type="s:short" />
<s:element minOccurs="0" maxOccurs="1" name="ClientVersionQfeNumber"
type="s:short" /> </s:sequence>
</s:complexType>
DnsName: For domain-joined clients, specifies the fully-qualified DNS name of the client machine. For non-domain-joined clients, specifies the client computer name (NETBIOS). This element MUST be present.
OSMajorVersion: The client operating system major version number.
OSMinorVersion: The client operating system minor version number.
OSBuildNumber: The client operating system build number.
OSServicePackMajorNumber: The client operating system service pack major number.
OSServicePackMinorNumber: The client operating system service pack minor number.
OSLocale: The client operating system locale, as specified in [MS-LCID].
ComputerManufacturer: The manufacturer of the client computer.
ComputerModel: The model of the client computer.
BiosVersion: The version of the client computer's BIOS firmware.
BiosName: The name of the client computer's BIOS firmware.
BiosReleaseDate: The release date of the client computer's BIOS firmware.
ProcessorArchitecture: The architecture of the client computer's CPU.
SuiteMask, OldProductType, NewProductType, SystemMetrics: Operating system properties that help the server identify the name of the client's operating system. These elements SHOULD be present in version 3.0 of the protocol, but MUST NOT be present in prior versions.<16>
This table details how the WSUS server determines the name of the client's operating system. Where the values in the cells below are omitted, the WSUS server does not use that information in determining the operating system name.
ClientVersionMajorNumber: The WUA major version number. This is the first part in the four-part WUA version string. This element SHOULD be present in version 3.0 of the protocol, but MUST NOT be present in prior versions.
ClientVersionMinorNumber: The WUA minor version number. This is the second part in the four-part WUA version string. This element SHOULD be present in version 3.0 of the protocol, but MUST NOT be present in prior versions.
ClientVersionBuildNumber: The WUA build number. This is the third part in the four-part WUA version string. This element SHOULD be present in version 3.0 of the protocol, but MUST NOT be present in prior versions.
ClientVersionQfeNumber: The WUA qfe number. This is the fourth part in the four-part WUA version string. This element SHOULD be present in version 3.0 of the protocol, but MUST NOT be present in prior versions.<17>
Response:
<s:element name="RegisterComputerResponse">
<s:complexType />
</s:element>
This type has no fields.