MS-WUSP: Windows Update Services: Client-Server Protocol

https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp
Admin
Microsoft Open Specifications documentation for the Windows Update Services Client-Server Protocol...
Tokens:91,257
Snippets:670
Trust Score:10
Update:4 days ago
Show doc for...
Tokens:
Raw
### StartCategoryScan

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

Starts a category scan for updates. This operation is available in both SOAP 1.1 and SOAP 1.2 bindings.

```APIDOC
## StartCategoryScan

### Description
Starts a category scan for updates.

### Method
SOAP (document/literal)

### Endpoint
http://localhost/ClientWebService/Client.asmx

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/Server/ClientWebService/StartCategoryScan

### Binding
ClientSoap (SOAP 1.1) and ClientSoap12 (SOAP 1.2)

### Request
No request body is specified.

### Response
No response body is specified.
```

--------------------------------

### GetConfig

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/493589c3-521c-4798-ab2d-6b7b08a59c36

Returns configuration information from the server. Must be the initial method called by the client when connecting to the server.

```APIDOC
## GetConfig

### Description
Returns configuration information on the server. This method MUST be the initial method called by the client when connecting to the server. The client SHOULD cache the results and only call it again if the server throws a SoapFault with ErrorCodes: InvalidCookie, ServerChanged, or ConfigChanged.

### Method
SOAP

### Endpoint
Not specified

### Parameters
#### Request Body
- **protocolVersion** (string) - Required - MUST be a non-NULL two-part version string (e.g., "1.0"). If validation fails, the server MAY return InvalidParameters.

### Response
#### Success Response
Returns a GetConfigResponse message if no faults occur.

```

--------------------------------

### Guid simple type definition

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/406050a7-d9e4-4dad-a47b-a5a6303fb18d

Defines the guid simple type as a string restricted by a specific GUID pattern.

```xml
   <s:simpleType name="guid">
     <s:restriction base="s:string">
       <s:pattern value="[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" />
     </s:restriction>
   </s:simpleType>
```

--------------------------------

### DeploymentAction

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

The DeploymentAction simple type enumerates the possible deployment actions for an update.

```APIDOC
## DeploymentAction

### Description
The DeploymentAction simple type defines the allowed values for the Action field in Deployment.

### Values
- **OptionalInstall** - The update is optional.
- **Install** - The update is installed.
- **Uninstall** - The update is uninstalled.
- **PreDeploymentCheck** - Pre-deployment check.
- **Block** - The update is blocked.
- **Evaluate** - The update is evaluated.
- **Bundle** - The update is a bundle.
```

--------------------------------

### ArrayOfGuid complexType definition

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/eb4c4ff2-445d-4bed-9434-8d89f0ea65a4

The XML schema definition for the ArrayOfGuid type, which contains a sequence of guid elements.

```xml
 <s:complexType name="ArrayOfGuid">
   <s:sequence>
     <s:element minOccurs="0" maxOccurs="unbounded" name="guid" 
        type="s2:guid" />
   </s:sequence>
 </s:complexType>
```

--------------------------------

### RegisterComputer

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/b0f2a41f-4b96-42a5-b84f-351396293033

The client invokes this method to perform registration with the server by providing information about its operating system, hardware, and network parameter configuration.

```APIDOC
## RegisterComputer

### Description
The client invokes this method to perform registration with the server by providing information about its operating system, hardware, and network parameter configuration.

### Method
SOAP operation (document style)

### Endpoint
SOAP action: http://www.microsoft.com/SoftwareDistribution/Server/ClientWebService/RegisterComputer

### Parameters
#### Request Body
- **cookie** (Cookie) - Required - Specifies a cookie that MUST have been obtained from a previous call to GetCookie, GetFileLocations, or SyncUpdates.
- **computerInfo** (ComputerInfo) - Required - Information about the client computer.

#### ComputerInfo Structure
- **DnsName** (string) - Optional - DNS name of the client computer.
- **OSMajorVersion** (int) - Required - Major version of the operating system.
- **OSMinorVersion** (int) - Required - Minor version of the operating system.
- **OSBuildNumber** (int) - Required - Build number of the operating system.
- **OSServicePackMajorNumber** (short) - Required - Major service pack number of the operating system.
- **OSServicePackMinorNumber** (short) - Required - Minor service pack number of the operating system.
- **OSLocale** (string) - Optional - Locale of the operating system.
- **ComputerManufacturer** (string) - Optional - Manufacturer of the computer.
- **ComputerModel** (string) - Optional - Model of the computer.
- **BiosVersion** (string) - Optional - Version of the BIOS.
- **BiosName** (string) - Optional - Name of the BIOS.
- **BiosReleaseDate** (dateTime) - Required - Release date of the BIOS.
- **ProcessorArchitecture** (string) - Optional - Architecture of the processor.
- **SuiteMask** (short) - Required - Suite mask of the operating system.
- **OldProductType** (unsignedByte) - Required - Old product type.
- **NewProductType** (int) - Required - New product type.
- **SystemMetrics** (int) - Required - System metrics.
- **ClientVersionMajorNumber** (short) - Required - Major version number of the client.
- **ClientVersionMinorNumber** (short) - Required - Minor version number of the client.
- **ClientVersionBuildNumber** (short) - Required - Build number of the client.
- **ClientVersionQfeNumber** (short) - Required - QFE number of the client.
- **OSDescription** (string) - Optional - Description of the operating system.
- **OEM** (string) - Optional - OEM information.
- **DeviceType** (string) - Optional - Type of device.
- **FirmwareVersion** (string) - Optional - Version of the firmware.
- **MobileOperator** (string) - Optional - Mobile operator information.

### Request Example
```xml
<RegisterComputer>
  <cookie>...</cookie>
  <computerInfo>
    <DnsName>example.com</DnsName>
    <OSMajorVersion>10</OSMajorVersion>
    <OSMinorVersion>0</OSMinorVersion>
    <OSBuildNumber>19045</OSBuildNumber>
    <OSServicePackMajorNumber>0</OSServicePackMajorNumber>
    <OSServicePackMinorNumber>0</OSServicePackMinorNumber>
    <OSLocale>en-US</OSLocale>
    <ComputerManufacturer>Contoso</ComputerManufacturer>
    <ComputerModel>Model X</ComputerModel>
    <BiosVersion>1.0</BiosVersion>
    <BiosName>BIOS</BiosName>
    <BiosReleaseDate>2023-01-01T00:00:00Z</BiosReleaseDate>
    <ProcessorArchitecture>AMD64</ProcessorArchitecture>
    <SuiteMask>0</SuiteMask>
    <OldProductType>1</OldProductType>
    <NewProductType>1</NewProductType>
    <SystemMetrics>0</SystemMetrics>
    <ClientVersionMajorNumber>10</ClientVersionMajorNumber>
    <ClientVersionMinorNumber>0</ClientVersionMinorNumber>
    <ClientVersionBuildNumber>19045</ClientVersionBuildNumber>
    <ClientVersionQfeNumber>0</ClientVersionQfeNumber>
    <OSDescription>Windows 10</OSDescription>
    <OEM>Contoso</OEM>
    <DeviceType>Desktop</DeviceType>
    <FirmwareVersion>1.0</FirmwareVersion>
    <MobileOperator></MobileOperator>
  </computerInfo>
</RegisterComputer>
```

### Response
No response details are provided in the source documentation.
```

--------------------------------

### RollupComputers

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/4134ecbe-752a-439c-b5ff-291d3b3d3cec

SOAP operation to roll up computers.

```APIDOC
## RollupComputers

### Description
Rolls up computers.

### Method
SOAP Operation

### Endpoint
http://www.microsoft.com/SoftwareDistribution/RollupComputers

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/RollupComputers

### Binding
WebServiceSoap (SOAP 1.1) and WebServiceSoap12 (SOAP 1.2)

### Style
Document/Literal
```

--------------------------------

### SyncPrinterCatalog

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

Synchronizes the printer catalog with the server. It accepts a cookie, installed non-leaf update IDs, and printer update IDs, and returns synchronization information.

```APIDOC
## SyncPrinterCatalog

### Description
Synchronizes the printer catalog with the server. It accepts a cookie, installed non-leaf update IDs, and printer update IDs, and returns synchronization information.

### Method
SOAP Operation

### Endpoint
Client Web Service

### Parameters
#### Request Body
- **cookie** (Cookie) - Optional - Cookie for session state.
- **installedNonLeafUpdateIDs** (ArrayOfInt) - Optional - Array of installed non-leaf update IDs.
- **printerUpdateIDs** (ArrayOfInt) - Optional - Array of printer update IDs.

### Response
#### Success Response
- **SyncPrinterCatalogResult** (SyncInfo) - Optional - Result of the synchronization.

```

--------------------------------

### GetConfig SOAP Request and Response

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/f9f47314-d480-4087-a86b-d9d2a86de3aa

Demonstrates the GetConfig operation to retrieve server configuration settings, followed by a successful response containing authentication and property details.

```xml
 <!-- AUTHORIZATION PHASE: GetConfig() Request  -->
 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
 <soap:Body>
 <GetConfig xmlns="http://www.microsoft.com/SoftwareDistribution/
     Server/ClientWebService">
 <protocolVersion>1.0</protocolVersion>
 </GetConfig>
 </soap:Body>
 </soap:Envelope>
```

```xml
 <!-- AUTHORIZATION PHASE: GetConfig() Response - Success  -->
 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
     <GetConfigResponse xmlns="http://www.microsoft.com/SoftwareDistribut
 ion/Server/ClientWebService">
       <GetConfigResult>
         <LastChange>2007-01-31T04:16:35.24Z</LastChange> 
         <IsRegistrationRequired>true</IsRegistrationRequired> 
         <AuthInfo>
           <AuthPlugInInfo>
              <PlugInID>SimpleTargeting</PlugInID>
 
 <ServiceUrl>SimpleAuthWebService/SimpleAuth.asmx</ServiceUrl> 
             <Parameter /> 
           </AuthPlugInInfo>
         </AuthInfo>
         <Properties>
           <ConfigurationProperty>
             <Name>MaxExtendedUpdatesPerRequest</Name> 
             <Value>50</Value> 
           </ConfigurationProperty>
           <ConfigurationProperty>
             <Name>PackageServerShare</Name> 
             <Value>\\microsof-
 cd0710.redmond.corp.microsoft.com\UpdateServicesPackages</Value> 
           </ConfigurationProperty>
           <ConfigurationProperty>
             <Name>ProtocolVersion</Name> 
             <Value>3.0</Value> 
           </ConfigurationProperty>
           <ConfigurationProperty>
             <Name>IsInventoryRequired</Name> 
             <Value>0</Value> 
           </ConfigurationProperty>
           <ConfigurationProperty>
             <Name>ClientReportingLevel</Name> 
             <Value>2</Value> 
           </ConfigurationProperty>
         </Properties>
       </GetConfigResult>
     </GetConfigResponse>
   </soap:Body>
 </soap:Envelope>
```

--------------------------------

### StartCategoryScan

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

The StartCategoryScan operation initiates a scan for update categories. It is a SOAP-based web service method.

```APIDOC
## StartCategoryScan

### Description
Initiates a scan for update categories.

### Method
SOAP

### Endpoint
Client Web Service

### Messages
- **StartCategoryScanSoapIn**: Request message containing the StartCategoryScan element.
- **StartCategoryScanSoapOut**: Response message containing the StartCategoryScanResponse element.

### Request Example
```xml
<StartCategoryScan xmlns="...">
  <!-- parameters -->
</StartCategoryScan>
```

### Response Example
```xml
<StartCategoryScanResponse xmlns="...">
  <!-- response data -->
</StartCategoryScanResponse>
```
```

--------------------------------

### RegisterComputer

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/1c84550d-ba7b-4174-9b0d-bf7cb1a70238

The client calls this method to pass information about itself to the server. The client MUST call this method if the server has returned IsRegistrationRequired=true from the client's most recent preceding call to GetConfig. The client SHOULD only call this method again if any of its registration information has changed, or if the server has requested it be called again by throwing a RegistrationRequired ErrorCode while processing a subsequent method invocation.

```APIDOC
## RegisterComputer

### Description
The client calls this method to pass information about itself to the server. The client MUST call this method if the server has returned IsRegistrationRequired=true from the client's most recent preceding call to GetConfig. The client SHOULD only call this method again if any of its registration information has changed, or if the server has requested it be called again by throwing a RegistrationRequired ErrorCode while processing a subsequent method invocation.

### Method
RegisterComputer

### Parameters
#### Request Parameters
- **cookie** - Required - MUST be a valid cookie, issued by this server, that has not expired. Error codes: InvalidCookie, ServerChanged, or CookieExpired.
- **computerInfo** - Optional - MAY perform validation of these fields. Error code: InvalidParameters. Validation is optional because this data is purely informational and is not used anywhere else in the client/server protocol.

### Data Processing
The server SHOULD store client registration info on the server so that administrators can see the types of computers that are getting updates from the server. This is not required because the cookie is created and maintained through the GetCookie method, and the computerInfo is purely informational and is not used anywhere else in the client/server protocol. If the server does not store this information, then the server will generally take no action in response to this method (other than validating parameters and returning a result). A server that does not store client registration information could include IsRegistrationRequired=false in its response to GetConfig, to inform the client that a call to the RegisterComputer method is not needed.

### Results
If no faults occur during the operation, the server MUST return a RegisterComputerResponse message to the client.
```

--------------------------------

### GetConfig

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

The GetConfig operation retrieves the configuration settings for the client. It takes a protocol version string and returns a Config object containing the last change timestamp, registration requirement, authentication plugin information, allowed event IDs, and configuration properties.

```APIDOC
## GetConfig

### Description
Retrieves the configuration settings for the client.

### Method
SOAP Operation

### Endpoint
ClientWebService (SOAP)

### Parameters
#### Request Body
- **protocolVersion** (string) - Optional - The protocol version to use.

### Request Example
```xml
<GetConfig>
  <protocolVersion>string</protocolVersion>
</GetConfig>
```

### Response
#### Success Response
- **GetConfigResult** (Config) - The configuration object containing:
  - **LastChange** (dateTime) - The last change timestamp.
  - **IsRegistrationRequired** (boolean) - Whether registration is required.
  - **AuthInfo** (ArrayOfAuthPlugInInfo) - Authentication plugin information.
  - **AllowedEventIds** (ArrayOfInt) - Allowed event IDs.
  - **Properties** (ArrayOfConfigurationProperty) - Configuration properties.

#### Response Example
```xml
<GetConfigResponse>
  <GetConfigResult>
    <LastChange>2023-01-01T00:00:00</LastChange>
    <IsRegistrationRequired>true</IsRegistrationRequired>
    <AuthInfo>
      <AuthPlugInInfo>
        <PlugInID>string</PlugInID>
        <ServiceUrl>string</ServiceUrl>
        <Parameter>string</Parameter>
      </AuthPlugInInfo>
    </AuthInfo>
    <AllowedEventIds>
      <int>1</int>
    </AllowedEventIds>
    <Properties>
      <ConfigurationProperty>
        <Name>string</Name>
        <Value>string</Value>
      </ConfigurationProperty>
    </Properties>
  </GetConfigResult>
</GetConfigResponse>
```
```

--------------------------------

### StartCategoryScan

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

Initiates a scan for updates in the specified categories.

```APIDOC
## SOAP StartCategoryScan

### Description
Initiates a scan for updates in the specified categories.

### Method
SOAP

### Endpoint
http://www.microsoft.com/SoftwareDistribution/Server/ClientWebService/StartCategoryScan

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/Server/ClientWebService/StartCategoryScan

### Style
document/literal

### Request Example
(No request body details provided)

### Response
(No response details provided)
```

--------------------------------

### RegisterComputer

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/b0f2a41f-4b96-42a5-b84f-351396293033

Registers a client computer with the Windows Update server by providing client and operating system information. The response is an empty RegisterComputerResponse element.

```APIDOC
## RegisterComputer

### Description
Registers a client computer with the Windows Update server. The client sends its name, operating system details, and client version information. The server responds with an empty RegisterComputerResponse element.

### Method
RegisterComputer (SOAP action)

### Endpoint
Not specified in the source.

### Parameters
#### Request Body
- **DnsName** (string) - Required - The client's name. MUST uniquely identify the computer on the network and MUST be the same value used in the call to GetAuthorizationCookie.
- **OSMajorVersion** (integer) - Required - The client operating system major version number.
- **OSMinorVersion** (integer) - Required - The client operating system minor version number.
- **OSBuildNumber** (integer) - Required - The client operating system build number.
- **OSServicePackMajorNumber** (integer) - Required - The client operating system service pack major number.
- **OSServicePackMinorNumber** (integer) - Required - The client operating system service pack minor number.
- **OSLocale** (string) - Required - The client operating system locale, as specified in [MS-LCID].
- **ComputerManufacturer** (string) - Required - The manufacturer of the client computer.
- **ComputerModel** (string) - Required - The model of the client computer.
- **BiosVersion** (string) - Required - The version of the client computer's BIOS firmware.
- **BiosName** (string) - Required - The name of the client computer's BIOS firmware.
- **BiosReleaseDate** (string) - Required - The release date of the client computer's BIOS firmware.
- **ProcessorArchitecture** (string) - Required - The architecture of the client computer's CPU. Not an enumeration; no predefined set of values.
- **SuiteMask** (integer) - Optional - Operating system property that helps the server identify the client's operating system.
- **OldProductType** (integer) - Optional - Operating system property that helps the server identify the client's operating system.
- **NewProductType** (integer) - Optional - Operating system property that helps the server identify the client's operating system.
- **SystemMetrics** (integer) - Optional - Operating system property that helps the server identify the client's operating system.
- **ClientVersionMajorNumber** (integer) - Optional - The Windows Update Agent (WUA) major version number (first part of the four-part WUA version string).
- **ClientVersionMinorNumber** (integer) - Optional - The WUA minor version number (second part of the four-part WUA version string).
- **ClientVersionBuildNumber** (integer) - Optional - The WUA build number (third part of the four-part WUA version string).
- **ClientVersionQfeNumber** (integer) - Optional - The WUA QFE number (fourth part of the four-part WUA version string).
- **OSDescription** (string) - Optional - The commercial name of the operating system including the edition.
- **OEM** (string) - Optional - The original equipment manufacturer of the client device.
- **DeviceType** (string) - Optional - The model of the client device.
- **FirmwareVersion** (string) - Optional - The firmware version of the client device; for example 2040.0021.12522.211.
- **MobileOperator** (string) - Optional - For devices with mobile SKUs only. The current mobile operator of the device. Format: xxx-yy where xxx is the alphanumeric mobile operator ID and yy is the country code. Example: 000-88 (World-wide Open Market), or VZW-US (Verizon Wireless).

### Response
#### Success Response
- **RegisterComputerResponse** (element) - This type has no fields.

#### Response Example
```xml
<s:element name="RegisterComputerResponse">
  <s:complexType />
</s:element>
```
```

--------------------------------

### StartCategoryScanResponse

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

Defines the response message for the StartCategoryScan operation.

```APIDOC
## StartCategoryScanResponse

### Description
Defines the response message for the StartCategoryScan operation.

### Message
StartCategoryScanResponse

### Response Elements
Not specified in the source.

```

--------------------------------

### GetConfig

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/b76899b4-ad55-427d-a748-2ecf0829412b

SOAP operation that returns server configuration information including registration requirements, authorization plugin details, and allowed event IDs.

```APIDOC
## SOAP Operation: GetConfig

### Description
Returns information on the server's registration, authorization, and reporting requirements.

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/Server/ClientWebService/GetConfig

### Request
#### Request Body
- **protocolVersion** (string) - Optional - The client protocol version, as a two-part version string separated by a period. The client SHOULD pass "1.8".

### Response
#### Success Response
- **GetConfigResult** (Config) - Required - Contains the configuration data.

#### Config Type
- **LastChange** (dateTime) - Required - The last time configuration data changed on the server.
- **IsRegistrationRequired** (boolean) - Required - Specifies whether the server requires registration. TRUE indicates registration is required; FALSE indicates not required.
- **AuthInfo** (ArrayOfAuthPlugInInfo) - Optional - Array of authorization plug-ins supported by the server. On successful execution, this array MUST contain exactly one element.
- **AllowedEventIds** (ArrayOfInt) - Optional - Array of allowed event IDs.
- **Properties** (ArrayOfConfigurationProperty) - Optional - Array of configuration properties.

#### ArrayOfAuthPlugInInfo Type
- **AuthPlugInInfo** (AuthPlugInInfo) - Optional - Contains information about the Authorization PlugIn available on the server. MUST contain exactly one element.

#### AuthPlugInInfo Type
- **PlugInID** (string) - Optional - Identifier of the plug-in.
- **ServiceUrl** (string) - Optional - URL of the service.
- **Parameter** (string) - Optional - Additional parameter.

### Request Example
```xml
<GetConfig>
  <protocolVersion>1.8</protocolVersion>
</GetConfig>
```

### Response Example
```xml
<GetConfigResponse>
  <GetConfigResult>
    <LastChange>2023-01-01T00:00:00Z</LastChange>
    <IsRegistrationRequired>true</IsRegistrationRequired>
    <AuthInfo>
      <AuthPlugInInfo>
        <PlugInID>example</PlugInID>
        <ServiceUrl>http://example.com</ServiceUrl>
        <Parameter>example</Parameter>
      </AuthPlugInInfo>
    </AuthInfo>
    <AllowedEventIds>1</AllowedEventIds>
    <Properties>...</Properties>
  </GetConfigResult>
</GetConfigResponse>
```
```

--------------------------------

### GetOutOfSyncComputers

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/4134ecbe-752a-439c-b5ff-291d3b3d3cec

SOAP operation to retrieve out-of-sync computers.

```APIDOC
## GetOutOfSyncComputers

### Description
Retrieves out-of-sync computers.

### Method
SOAP Operation

### Endpoint
http://www.microsoft.com/SoftwareDistribution/GetOutOfSyncComputers

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/GetOutOfSyncComputers

### Binding
WebServiceSoap (SOAP 1.1) and WebServiceSoap12 (SOAP 1.2)

### Style
Document/Literal
```

--------------------------------

### StartCategoryScan

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/5f4a9db3-67a4-43a0-8390-1c27714750cc

Clients call this method to obtain the preferred set of categories for limited update synchronization and to identify unrecognized requested categories. It must be called before SyncUpdates and only when ProtocolVersion is at least 3.2.

```APIDOC
## StartCategoryScan

### Description
Clients call this method to obtain the preferred set of categories that the server expects as part of the SyncUpdates method parameters. It also returns any requested categories that are not recognized by the server.

### Method
StartCategoryScan

### Parameters
#### Request Body
- **requestedCategories** (array of CategoryRelationship) - Required - MUST be present. Array of CategoryRelationship elements as specified in section 2.2.2.2.8.

### Response
#### Success Response
- **preferredCategoryIds** (list of GUIDs) - List of category GUIDs from the PreferredCategoryList.
- **requestedCategoryIdsInError** (list of GUIDs) - List of category GUIDs from the ErrorList.

### Error Codes
- **InvalidParameters** - Returned if requestedCategories is not present.

### Notes
- MUST be called before SyncUpdates when performing limited update synchronization.
- MUST NOT be called if ProtocolVersion is less than 3.2.
- Server SHOULD limit the number of categories requested as an optimization.
```

--------------------------------

### RollupDownstreamServers

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/4134ecbe-752a-439c-b5ff-291d3b3d3cec

SOAP operation to roll up downstream servers.

```APIDOC
## RollupDownstreamServers

### Description
Rolls up downstream servers.

### Method
SOAP Operation

### Endpoint
http://www.microsoft.com/SoftwareDistribution/RollupDownstreamServers

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/RollupDownstreamServers

### Binding
WebServiceSoap (SOAP 1.1) and WebServiceSoap12 (SOAP 1.2)

### Style
Document/Literal
```

--------------------------------

### RegisterComputer

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wusp/a5c9d6d1-e24a-4982-add3-16cfc3f35b53

Registers a computer with the update service. This operation is available in both SOAP 1.1 and SOAP 1.2 bindings.

```APIDOC
## RegisterComputer

### Description
Registers a computer with the update service.

### Method
SOAP (document/literal)

### Endpoint
http://localhost/ClientWebService/Client.asmx

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/Server/ClientWebService/RegisterComputer

### Binding
ClientSoap (SOAP 1.1) and ClientSoap12 (SOAP 1.2)

### Request
No request body is specified.

### Response
No response body is specified.
```
Tokens:
Raw