Windows Update Services: Server-Server Protocol

https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/
Admin
Windows Update Services: Server-Server Protocol enables hierarchically organized servers to...
Tokens:80,430
Snippets:646
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### RollupComputers Request

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a RollupComputers SOAP request containing computer rollup information and client details.

```xml
<?xml version="1.0" encoding="utf-8"?>
<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>
    <RollupComputers xmlns="http://www.microsoft.com/SoftwareDistribution">
      <cookie>
        <Expiration>9999-12-31T23:59:59.9999999</Expiration>
        <EncryptedData />
      </cookie>
      <clientTime>2007-03-06T03:28:02.9726004Z</clientTime>
      <computers>
        <ComputerRollupInfo
                          ComputerId="d07a4d51-7cb2-46d1-ad86-91195cb4325a"
                          LastSyncTime="2007-03-06T03:22:28.137Z"
                          LastSyncResult="1"
                          LastReportedRebootTime="0001-01-01T00:00:00"
                          LastReportedStatusTime="2007-03-06T03:27:59.377Z"
                          LastInventoryTime="0001-01-01T00:00:00"
                          ParentServerId="050cee4a-aaff-470c-8fc3-7a94cb3a4293">
          <Details
                          IPAddress="127.0.0.1"
                          FullDomainName="yasufs64.ntdev.corp.microsoft.com"
                          OSMajorVersion="5"

```

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

### GetOutOfSyncComputers SOAP Response

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a successful GetOutOfSyncComputers response message.

```xml
<?xml version="1.0" encoding="utf-8"?>
 <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>
	 <GetOutOfSyncComputersResponse
						  xmlns="http://www.microsoft.com/SoftwareDistribution">
	   <GetOutOfSyncComputersResult />
	 </GetOutOfSyncComputersResponse>
   </soap:Body>
 </soap:Envelope>
```

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

### RollupComputers SOAP Response

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a successful RollupComputers response message.

```xml
<?xml version="1.0" encoding="utf-8"?>
 <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>
	 <RollupComputersResponse
						  xmlns="http://www.microsoft.com/SoftwareDistribution">
	   <RollupComputersResult />
	 </RollupComputersResponse>
   </soap:Body>
 </soap:Envelope>
```

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

### RollupComputerStatus SOAP Response

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a successful RollupComputerStatus response message.

```xml
<?xml version="1.0" encoding="utf-8"?>
 <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>
     <RollupComputerStatusResponse
                          xmlns="http://www.microsoft.com/SoftwareDistribution">
       <RollupComputerStatusResult>true</RollupComputerStatusResult>
     </RollupComputerStatusResponse>
   </soap:Body>
 </soap:Envelope>
```

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

### RollupComputerStatus SOAP Request

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a RollupComputerStatus request message including computer status and update information.

```xml
<?xml version="1.0" encoding="utf-8"?>
 <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>
	 <RollupComputerStatus xmlns="http://www.microsoft.com/SoftwareDistribution">
	   <cookie>
		 <Expiration>9999-12-31T23:59:59.9999999</Expiration>
		 <EncryptedData />
	   </cookie>
	   <clientTime>2007-03-06T03:39:24.2520342Z</clientTime>
	   <parentServerId>050cee4a-aaff-470c-8fc3-7a94cb3a4293</parentServerId>
	   <computers>
		 <ComputerStatusRollupInfo>
		   <InstanceId>14720b83-5998-41f7-b586-6088cd8acd0c</InstanceId>
		   <ComputerId>d07a4d51-7cb2-46d1-ad86-91195cb4325a</ComputerId>
		   <EffectiveLastDetectionTime>2007-03-06T01:47:46.42Z</EffectiveLastDete
 ectionTime>
		   <RollupNumber>3</RollupNumber>
		   <IsFullRollup>true</IsFullRollup>
		   <UpdateStatus>
			 <ComputerStatusRollupUpdateStatus>
			   <UpdateId>09de7a79-5c09-4f3a-972e-cc1bbb7ca7e4</UpdateId>
			   <SummarizationState>4</SummarizationState>
			   <LastChangeTime>2007-03-05T22:25:11.64Z</LastChangeTime>
			 </ComputerStatusRollupUpdateStatus>
			 <ComputerStatusRollupUpdateStatus>
			   <UpdateId>5eb6225f-5d33-4213-a6b4-fcdd9f672d75</UpdateId>
			   <SummarizationState>5</SummarizationState>
			   <LastChangeTime>2007-03-05T22:25:11.64Z</LastChangeTime>
```

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

### RollupDownstreamServers Request and Response

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a RollupDownstreamServers SOAP request containing server summary and client activity data, followed by its corresponding empty response.

```xml
          <FullDomainName>yasufs64.ntdev.corp.microsoft.com</FullDomainName>
          <LastSyncTime>0001-01-01T00:00:00</LastSyncTime>
          <ParentServerId>00000000-0000-0000-0000-000000000000</ParentServerId>
          <Version>3.0.6000.354</Version>
          <IsReplica>true</IsReplica>
          <LastRollupTime>2007-03-06T03:28:01.894503Z</LastRollupTime>
          <ServerSummary>
             <UpdateCount>1002</UpdateCount>
             <DeclinedUpdateCount>29</DeclinedUpdateCount>
             <ApprovedUpdateCount>2</ApprovedUpdateCount>
             <NotApprovedUpdateCount>971</NotApprovedUpdateCount>
             <UpdatesWithStaleUpdateApprovalsCount>0</UpdatesWithStaleUpdateAppro
valsCount>
             <ExpiredUpdateCount>1</ExpiredUpdateCount>
             <CriticalOrSecurityUpdatesNotApprovedForInstallCount>953</CriticalOr
SecurityUpdatesNotApprovedForInstallCount>
             <WsusInfrastructureUpdatesNotApprovedForInstallCount>3</WsusInfrastr
uctureUpdatesNotApprovedForInstallCount>
             <UpdatesWithClientErrorsCount>0</UpdatesWithClientErrorsCount>
             <UpdatesWithServerErrorsCount>0</UpdatesWithServerErrorsCount>
             <UpdatesNeedingFilesCount>0</UpdatesNeedingFilesCount>
             <UpdatesNeededByComputersCount>1</UpdatesNeededByComputersCount>
             <UpdatesUpToDateCount>972</UpdatesUpToDateCount>
             <CustomComputerTargetGroupCount>0</CustomComputerTargetGroupCount>
             <ComputerTargetCount>1</ComputerTargetCount>
             <ComputerTargetsNeedingUpdatesCount>1</ComputerTargetsNeedingUpdates
Count>
             <ComputerTargetsWithUpdateErrorsCount>0</ComputerTargetsWithUpdateEr
rorsCount>
             <ComputersUpToDateCount>0</ComputersUpToDateCount>
          </ServerSummary>
          <ClientSummaries>
            <DownstreamServerRollupClientSummary>
              <OSMajorVersion>5</OSMajorVersion>
              <OSMinorVersion>2</OSMinorVersion>
              <OSBuildNumber>3790</OSBuildNumber>
              <OSServicePackMajorNumber>1</OSServicePackMajorNumber>
              <OSServicePackMinorNumber>0</OSServicePackMinorNumber>
              <OSLocale>en-US</OSLocale>
              <SuiteMask>272</SuiteMask>
              <OldProductType>3</OldProductType>
              <NewProductType>0</NewProductType>
              <SystemMetrics>0</SystemMetrics>
              <ProcessorArchitecture>AMD64</ProcessorArchitecture>
              <Count>1</Count>
              <ActivitySummaries>
                 <DownstreamServerRollupClientActivitySummary>
                    <UpdateId>63ee225f-897d-42ae-841e-4a383c92f350</UpdateId>
                    <RevisionNumber>101</RevisionNumber>
                    <InstallSuccessCount>1</InstallSuccessCount>
                    <InstallFailureCount>0</InstallFailureCount>
                 </DownstreamServerRollupClientActivitySummary>
              </ActivitySummaries>
            </DownstreamServerRollupClientSummary>
          </ClientSummaries>
        </DownstreamServerRollupInfo>
      </downstreamServers>
    </RollupDownstreamServers>
  </soap:Body>
</soap:Envelope>
```

```xml
<?xml version="1.0" encoding="utf-8"?>
<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>
    <RollupDownstreamServersResponse
                         xmlns="http://www.microsoft.com/SoftwareDistribution" />
  </soap:Body>
</soap:Envelope>
```

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

### GetOutOfSyncComputers SOAP Request

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a GetOutOfSyncComputers request message containing cookie and server identification data.

```xml
<?xml version="1.0" encoding="utf-8"?>
 <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>
	 <GetOutOfSyncComputers
						  xmlns="http://www.microsoft.com/SoftwareDistribution">
	   <cookie>
		 <Expiration>9999-12-31T23:59:59.9999999</Expiration>
		 <EncryptedData />
	   </cookie>
	   <parentServerId>050cee4a-aaff-470c-8fc3-7a94cb3a4293</parentServerId>
	   <lastRollupNumbers>
		 <ComputerLastRollupNumber>
		   <ComputerId>d07a4d51-7cb2-46d1-ad86-91195cb4325a</ComputerId>
		   <RollupNumber>2</RollupNumber>
		 </ComputerLastRollupNumber>
	   </lastRollupNumbers>
	 </GetOutOfSyncComputers>
   </soap:Body>
 </soap:Envelope>
```

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

### XML Schema Definitions for Server Sync Web Service

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863

Contains schema definitions for complex types like MonitoredServicesResponse and simple types like GUID patterns.

```xml
             <s:element minOccurs="0" maxOccurs="1" name="cookie" type="tns:Cookie" />
             <s:element minOccurs="0" maxOccurs="1" name="updateIDs" type="tns:ArrayOfGuid" />
           </s:sequence>
         </s:complexType>
       </s:element>
       <s:element name="GetRelatedRevisionsForUpdatesResponse">
         <s:complexType>
           <s:sequence>
             <s:element minOccurs="0" maxOccurs="1" name="GetRelatedRevisionsForUpdatesResult" type="tns:ArrayOfUpdateIdentity" />
           </s:sequence>
         </s:complexType>
       </s:element>
     </s:schema>
     <s:schema elementFormDefault="qualified" targetNamespace="http://microsoft.com/wsdl/types/">
       <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>
     </s:schema>
     <s:schema elementFormDefault="qualified" targetNamespace="http://www.microsoft.com/SoftwareDistribution/Server/IMonitorable">
       <s:element name="Ping">
         <s:complexType>
           <s:sequence>
             <s:element minOccurs="1" maxOccurs="1" name="pingLevel" type="s:int" />
           </s:sequence>
         </s:complexType>
       </s:element>
       <s:element name="PingResponse">
         <s:complexType>
           <s:sequence>
             <s:element minOccurs="0" maxOccurs="1" name="PingResult" type="s2:MonitoredServicesResponse" />
           </s:sequence>
         </s:complexType>
       </s:element>
       <s:complexType name="MonitoredServicesResponse">
         <s:sequence>
           <s:element minOccurs="1" maxOccurs="1" name="SuccessFlag" type="s:boolean" />
           <s:element minOccurs="1" maxOccurs="1" name="ServicesTime" type="s:dateTime" />
           <s:element minOccurs="0" maxOccurs="1" name="ServicesName" type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="ServicesMachine" type="s:string" />
           <s:element minOccurs="1" maxOccurs="1" name="IsHttps" type="s:boolean" />
           <s:element minOccurs="0" maxOccurs="1" name="RequestContentType" type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="ConfigFilePath" type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="ConfigFileProjectName" type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="ConfigFileEnvironmentName" type="s:string" />
           <s:element minOccurs="1" maxOccurs="1" name="ConfigFileLastModifiedTime" type="s:dateTime" />
           <s:element minOccurs="0" maxOccurs="1" name="ConfigFileVersion" type="s:string" />
           <s:element minOccurs="1" maxOccurs="1" name="ConfigFileNextExpirationTime" type="s:dateTime" />
           <s:element minOccurs="1" maxOccurs="1" name="ConfigFileExpirationModuloInMinutes" type="s:int" />
           <s:element minOccurs="0" maxOccurs="1" name="DatabaseInfo" type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="CustomInfo" type="s:string" />
         </s:sequence>
       </s:complexType>
     </s:schema>
   </wsdl:types>
```

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

### Reporting Web Service Schema Definitions

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443

Defines the XML schema for the Reporting Web Service, including a GUID pattern and the MonitoredServicesResponse complex type.

```xml
   targetNamespace="http://microsoft.com/wsdl/types/">
       <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>
     </s:schema>
     <s:schema elementFormDefault="qualified"
targetNamespace="http://www.microsoft.com/SoftwareDistribution/Server/IMonitorable">
       <s:element name="Ping">
         <s:complexType>
           <s:sequence>
             <s:element minOccurs="1" maxOccurs="1" name="pingLevel"
                       type="s:int" />
           </s:sequence>
         </s:complexType>
       </s:element>
       <s:element name="PingResponse">
         <s:complexType>
           <s:sequence>
             <s:element minOccurs="0" maxOccurs="1" name="PingResult"
                       type="s2:MonitoredServicesResponse" />
            </s:sequence>
         </s:complexType>
       </s:element>
       <s:complexType name="MonitoredServicesResponse">
         <s:sequence>
           <s:element minOccurs="1" maxOccurs="1" name="SuccessFlag"
                     type="s:boolean" />
           <s:element minOccurs="1" maxOccurs="1" name="ServicesTime"
                     type="s:dateTime" />
           <s:element minOccurs="0" maxOccurs="1" name="ServicesName"
                     type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="ServicesMachine"
                     type="s:string" />
           <s:element minOccurs="1" maxOccurs="1" name="IsHttps"
                     type="s:boolean" />
           <s:element minOccurs="0" maxOccurs="1" name="RequestContentType"
                     type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="ConfigFilePath"
                     type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="ConfigFileProjectName"
                     type="s:string" />
           <s:element minOccurs="0" maxOccurs="1"
                     name="ConfigFileEnvironmentName" type="s:string" />
           <s:element minOccurs="1" maxOccurs="1"
                     name="ConfigFileLastModifiedTime" type="s:dateTime" />
           <s:element minOccurs="0" maxOccurs="1" name="ConfigFileVersion"
                     type="s:string" />
           <s:element minOccurs="1" maxOccurs="1"
                     name="ConfigFileNextExpirationTime" type="s:dateTime" />
           <s:element minOccurs="1" maxOccurs="1"
                     name="ConfigFileExpirationModuloInMinutes" type="s:int" />
           <s:element minOccurs="0" maxOccurs="1" name="DatabaseInfo"
                     type="s:string" />
           <s:element minOccurs="0" maxOccurs="1" name="CustomInfo"
                     type="s:string" />
         </s:sequence>
       </s:complexType>
     </s:schema>
   </wsdl:types>
```

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

### WSUS GetDeployments Request and Response

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Demonstrates the request and response structure for retrieving deployment information from a WSUS server.

```xml
<GetDeployments xmlns="http://www.microsoft.com/SoftwareDistribution">
      <cookie>
        <Expiration>2006-05-26T22:59:25.1296674Z</Expiration>
        <EncryptedData>c7jG7GX4Czeq+uO8twkF3uNyVfDX6G2bXwIUKk114C+BOl80eXz9YToko
+KAMpO50h16kmztwMUn4i7bJ7AQw64t05Xtgfmf9F42JG1mADwLmRUSAIxnWEpKJe4fmdUzHPKjUWbKB
Pi2UijibE2jZ4y177B3vafHo3RtM7NM2lMi/VWXxHwlNKvMYvzOrOvXPNuDJtTM3AOHGzW2MlZ4daT7T
Usd5m6g</EncryptedData>
      </cookie>
      <syncAnchor>4742,2006-05-26 18:59:26.192</syncAnchor>
    </GetDeployments>
```

```xml
<GetDeploymentsResponse 
                          xmlns="http://www.microsoft.com/SoftwareDistribution">
      <GetDeploymentsResult>
        <Anchor>4742,2006-05-26 18:59:26.192</Anchor>
        <Groups>
          <ServerSyncTargetGroup>
             <TargetGroupID>a0a08746-4dbe-4a37-9adf-9e7652c0b421</TargetGroupID>
            <ParentGroupId>00000000-0000-0000-0000-000000000000</ParentGroupId>
            <Name>All Computers</Name>
            <IsBuiltin>true</IsBuiltin>
          </ServerSyncTargetGroup>
          <ServerSyncTargetGroup>
            <TargetGroupID>b73ca6ed-5727-47f3-84de-015e03f6a88a</TargetGroupID>
            <Name>Unassigned Computers</Name>
            <IsBuiltin>true</IsBuiltin>
          </ServerSyncTargetGroup>
        </Groups>
        <Deployments>
          <ServerSyncDeployment>
            <UpdateId>4b62aa32-52f6-4c15-b739-1c8e696eb33e</UpdateId>
            <RevisionNumber>100</RevisionNumber>
            <Action>0</Action>
            <AdminName>WUS Server</AdminName>
            <Deadline>9999-12-31T23:59:59.9999999</Deadline>
            <IsAssigned>true</IsAssigned>
```

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

### SusXML LocalizedPropertiesCollection Example

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/031bba26-cf0d-430c-9901-9377d0bce87a

Example of a LocalizedPropertiesCollection using the NeutralLanguage type for language neutral packages.

```xml
    <upd:LocalizedPropertiesCollection>
         <upd:LocalizedProperties>
         <upd:Language>NeutralLanguage</upd:Language>
         <upd:Title>SQL 2005 English ia64</upd:Title>
         </upd:LocalizedProperties>
    </upd:LocalizedPropertiesCollection>
```

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

### GUID XML Schema Definition

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/567b00a9-cfec-400e-975e-6b447e54a4b7

Defines the GUID simple type using an XML schema restriction with a specific pattern for hexadecimal character sequences.

```xml
 <s:schema elementFormDefault="qualified"
                                        
 "targetNamespace=http://microsoft.com/wsdl/types/">
  <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>
 </s:schema>
```

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

### DownloadFiles

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863

Initiates the download process for a list of files identified by their digests.

```APIDOC
## DownloadFiles

### Description
Downloads files based on the provided file digest list.

### Parameters
- **cookie** (Cookie) - Optional - Authentication or session cookie.
- **fileDigestList** (ArrayOfBase64Binary) - Optional - List of file digests to download.
```

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

### DownloadFiles

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/65492f6c-ad61-4c02-a0d3-eeda2a4303f9

Initiates the Content Download process on a USS for a set of files from the parent of the USS.

```APIDOC
## SOAP Operation: DownloadFiles

### Description
A DSS calls the DownloadFiles method to initiate the Content Download process on a USS for a set of files from the parent of the USS. This method is typically called after a Content Download attempt fails with a "File Not Found" condition.

### Operation
http://www.microsoft.com/SoftwareDistribution/DownloadFiles

### Parameters
- **cookie** (string) - Required - Must be present, not empty, and contain valid encrypted data.
- **fileDigestList** (array) - Required - A list of FileDigest values to download. The number of elements must not exceed 100.

### Error Handling
- **InvalidCookie**: The cookie is missing, empty, or has an incorrect format.
- **InvalidParameters**: Parameters are invalid or the protocol version format is incorrect.
- **IncompatibleProtocolVersion**: The Major Version in the cookie is not 1.
- **FileDigestsMissing**: One or more requested FileDigest values are not found in the Revision Table.
- **InternalServerError**: An internal error occurred on the server.
```

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

### Configure DownloadFiles SOAP Action

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/65492f6c-ad61-4c02-a0d3-eeda2a4303f9

SOAP operation configuration specifying the action and document style.

```xml
 <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribut
 ion/DownloadFiles" style="document" />
```

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

### GetDeployments

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Synchronizes deployment information and target groups between the server and client.

```APIDOC
## GetDeployments

### Description
Requests deployment information from the server. The request includes a synchronization cookie and a sync anchor to track the state of the synchronization.

### Parameters
- **cookie** (object) - Contains Expiration and EncryptedData for session management.
- **syncAnchor** (string) - A timestamp-based anchor used to synchronize state.

### Response
- **Anchor** (string) - Updated sync anchor.
- **Groups** (array) - List of ServerSyncTargetGroup objects.
- **Deployments** (array) - List of ServerSyncDeployment objects.
```

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

### GetAuthorizationCookie

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Requests an authorization cookie for a specific account name and GUID.

```APIDOC
## SOAP GetAuthorizationCookie

### Description
Requests an authorization cookie from the server for a given account identity.

### Request Body
- **accountName** (string) - The account name to authorize.
- **accountGuid** (string) - The unique identifier for the account.

### Response
- **PlugInId** (string) - The ID of the plugin used.
- **CookieData** (string) - The returned authorization cookie data.
```

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

### GetDeployments

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/af3c24e0-df97-4fc2-9580-fcb46092f538

Retrieves deployment information based on the provided cookie and synchronization anchors.

```APIDOC
## GetDeployments

### Description
The GetDeployments operation is used to retrieve deployment data. It requires a valid cookie and synchronization anchors to ensure the data returned is consistent with the client's current state.

### Parameters
- **cookie** (s1:Cookie) - Required - The cookie returned by the GetCookie operation. Must not be expired.
- **deploymentAnchor** (string) - Optional - Identifies the point in time of the last successful GetDeployments call. Must not be present on the first call.
- **syncAnchor** (string) - Required - The anchor returned in the last successful GetRevisionIdList operation response.
```

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

### ReportInventory

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443

Reports client inventory data to the WSUS server.

```APIDOC
## ReportInventory

### Description
Reports client inventory information to the server.

### Parameters
- **cookie** (tns:Cookie) - Optional - Authentication or session cookie.
- **clientTime** (s:dateTime) - Required - The timestamp of the client.
- **inventory** (tns:ReportingInventory) - Optional - The inventory data to report, containing IsCompressed, RawXml, or CompressedXml.

### Response
- **ReportInventoryResult** (s:boolean) - Returns true if the inventory was successfully reported.
```

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

### RollupComputers

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Synchronizes computer status and inventory information from clients to the WSUS server.

```APIDOC
## SOAP RollupComputers

### Description
This operation synchronizes computer-specific status, inventory, and sync results to the WSUS server.

### Request Example
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <RollupComputers xmlns="http://www.microsoft.com/SoftwareDistribution">
      <cookie>
        <Expiration>9999-12-31T23:59:59.9999999</Expiration>
      </cookie>
      <clientTime>2007-03-06T03:28:02.9726004Z</clientTime>
      <computers>
        <ComputerRollupInfo ComputerId="d07a4d51-7cb2-46d1-ad86-91195cb4325a" />
      </computers>
    </RollupComputers>
  </soap:Body>
</soap:Envelope>
```

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

### GetDeployments

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/abc52295-a11f-4871-a1c4-831c4d502b23

Defines the SOAP request and response messages for retrieving deployment data.

```APIDOC
## SOAP Operation: GetDeployments

### Description
Requests and retrieves deployment data from the server.

### Messages
- **GetDeploymentsSoapIn**: Requests the deployment data.
- **GetDeploymentsSoapOut**: A response containing the deployment data.
```

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

### ArrayOfGuid XML Schema Definition

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/7eb31e85-f34e-4235-b47f-7510435a87da

The XML schema definition for the ArrayOfGuid complex type, specifying a sequence of GUID elements.

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

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

### GetRollupConfiguration

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Retrieves the configuration settings for the rollup process, including batch sizes for various synchronization tasks.

```APIDOC
## SOAP GetRollupConfiguration

### Description
Retrieves the rollup configuration from the Upstream Server (USS) to the Downstream Server (DSS).

### Request Body
- **cookie** (object) - Required - Contains authentication or session state information.

### Response
#### Success Response (200)
- **GetRollupConfigurationResult** (object) - Contains configuration details such as batch sizes and server identifiers.
```

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

### GetAuthorizationCookie

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/141c290d-4ea1-4e0c-9dc8-0430eca197d7

The GetAuthorizationCookie operation is used to request an authorization cookie by providing the account name, account GUID, and program keys.

```APIDOC
## GetAuthorizationCookie

### Description
Retrieves an authorization cookie for the specified DSS account.

### Parameters
- **accountName** (string) - Required - The FQDN of the DSS.
- **accountGuid** (string) - Required - A GUID that identifies the DSS.
- **programKeys** (ArrayOfGuid) - Required - Reserved for future use; must be set to empty.
```

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

### SOAP Fault Response for Invalid Cookie

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

Example of a SOAP fault response returned when an invalid cookie is provided during the GetDeployments operation.

```xml
 <!-- DEPLOYMENTS SYNC PHASE: GetDeployments() Failure Response - InvalidCookie -
 ->
 <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>
     <soap:Fault>
       <faultcode>soap:Client</faultcode>
       <faultstring>System.Web.Services.Protocols.SoapException: Fault occurred a
 t Microsoft.UpdateServices.Internal.SoapUtilities.ThrowException(ErrorCode error
 Code, String message) at Microsoft.UpdateServices.Internal.Authorization.Authori
 zationManager.CrackCookieInServerSync(Cookie cookie) at Microsoft.UpdateServices
 .Internal.ServerImplementation.GetDeployments(Cookie cookie, String deploymentAn
 chor, String syncAnchor) at Microsoft.UpdateServices.Internal.ServerSyncProxy.Ge
 tDeployments(Cookie cookie, String deploymentAnchor, String syncAnchor)</faultst
 ring>
       <faultactor>http://HemantTest:8530/serversyncWebService/serversyncWebServi
 ce.asmx</faultactor>
       <detail>
         <ErrorCode>InvalidCookie</ErrorCode>
         <Message />
         <ID>247dfffd-a6b4-4a57-b9d4-2e464b668cd3</ID>
         <Method>"http://www.microsoft.com/SoftwareDistribution/GetDeployments"</
 Method>
       </detail>
     </soap:Fault>
   </soap:Body>
 </soap:Envelope>
```

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

### ReportEventBatch

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443

Reports a batch of events to the WSUS server.

```APIDOC
## SOAP Operation: ReportEventBatch

### Description
Reports a batch of events to the WSUS server.

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/ReportEventBatch
```

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

### GetConfigData

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863

Retrieves the server synchronization configuration data.

```APIDOC
## GetConfigData

### Description
Retrieves the current server synchronization configuration, including limits for requests and language settings.

### Parameters
#### Request Body
- **configAnchor** (string) - Optional - An anchor string used for configuration synchronization.
```

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

### GetDriverSetData XML Schema Definition

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/b1b13150-0de7-4bf3-b3af-aac330ec93bf

Defines the structure of the GetDriverSetData request element, containing a cookie and an array of driver set GUIDs.

```xml
       <s:element name="GetDriverSetData">
         <s:complexType>
           <s:sequence>
             <s:element minOccurs="0" maxOccurs="1" name="cookie" type="tns:Cookie" />
             <s:element minOccurs="0" maxOccurs="1" name="driverSets" type="tns:ArrayOfGuid" />
           </s:sequence>
         </s:complexType>
       </s:element>
```

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

### GetAuthConfig

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863

Retrieves the server authentication configuration, including plugin information and allowed event IDs.

```APIDOC
## SOAP GetAuthConfig

### Description
Retrieves the current server authentication configuration, which includes a list of authentication plugins and allowed event identifiers.

### Request
- **GetAuthConfig** (element) - No parameters required.

### Response
- **GetAuthConfigResult** (ServerAuthConfig) - Contains LastChange (dateTime), AuthInfo (ArrayOfAuthPlugInInfo), and AllowedEventIds (ArrayOfInt).
```

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

### Define GetDeployments SOAP Action

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/ee4ce858-ec99-4129-9826-00f6db63bee9

SOAP operation configuration specifying the action URL and document style.

```xml
 <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribut
 ion/GetDeployments" style="document" />
```

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

### Configure GetUpdateData SOAP Action

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/c28ad30c-fa3f-4bc6-a747-788391d2d964

SOAP operation configuration specifying the action and document style.

```xml
 <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribut
 ion/GetUpdateData" style="document" />
```

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

### GetAuthorizationCookie

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8dbf1759-29a9-4268-a8c6-d26959f07021

The GetAuthorizationCookie method is used by a DSS to authenticate and authorize access to the Server Sync Web Service. It validates the provided account name and GUID, and returns an authorization cookie.

```APIDOC
## SOAP Operation: GetAuthorizationCookie

### Description
A DSS calls the GetAuthorizationCookie method to authenticate and authorize access to the Server Sync Web Service. The USS returns an authorization cookie used in subsequent operations.

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/Server/DssAuthWebService/GetAuthorizationCookie

### Parameters
- **accountName** (string) - Required - Must not be NULL or zero-length; must follow FQDN requirements.
- **accountGuid** (string) - Required - Must not be NULL or zero-length; must follow GUID format.

### Response
- **AuthorizationCookie** (element) - The generated cookie for the DSS.
- **PlugInId** (string) - Initialized to "DssTargeting".
- **CookieData** (bytes) - A sequence of bytes as defined in the protocol specification.

### Error Handling
- **InvalidParameters**: Returned if input parameters fail validation.
- **InternalServerError**: Returned if an internal server error occurs.
```

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

### GetRollupConfiguration

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443

Retrieves the rollup configuration from the WSUS server.

```APIDOC
## SOAP Operation: GetRollupConfiguration

### Description
Retrieves the rollup configuration from the WSUS server.

### SOAP Action
http://www.microsoft.com/SoftwareDistribution/GetRollupConfiguration
```

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

### GetDeployments

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863

Retrieves deployment information, including target groups and update assignments, based on synchronization anchors.

```APIDOC
## GetDeployments

### Description
Retrieves the current deployment state and configuration.

### Parameters
- **cookie** (Cookie) - Optional - Authentication or session cookie.
- **deploymentAnchor** (string) - Optional - Anchor for deployment state.
- **syncAnchor** (string) - Optional - Anchor for synchronization state.

### Response
- **GetDeploymentsResult** (ServerSyncDeploymentResult) - The resulting deployment data including groups, deployments, and update status.
```

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

### SOAP Binding Configuration

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863

Defines the SOAP binding and operation actions for the Server Sync Web Service.

```xml
  <wsdl:binding name="ServerSyncProxySoap" type="tns:ServerSyncProxySoap">
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
    <wsdl:operation name="GetAuthConfig">
      <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribution/GetAuthConfig" style="document" />
      <wsdl:input>
        <soap:body use="literal" />
      </wsdl:input>
      <wsdl:output>
        <soap:body use="literal" />
      </wsdl:output>
    </wsdl:operation>
    <wsdl:operation name="GetCookie">
      <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribution/GetCookie" style="document" />
      <wsdl:input>
        <soap:body use="literal" />
      </wsdl:input>
      <wsdl:output>
        <soap:body use="literal" />
      </wsdl:output>
    </wsdl:operation>
    <wsdl:operation name="GetConfigData">
      <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribution/GetConfigData" style="document" />
      <wsdl:input>
        <soap:body use="literal" />
      </wsdl:input>
      <wsdl:output>
        <soap:body use="literal" />
      </wsdl:output>
    </wsdl:operation>
    <wsdl:operation name="GetRevisionIdList">
      <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribution/GetRevisionIdList" style="document" />
      <wsdl:input>
        <soap:body use="literal" />
      </wsdl:input>
      <wsdl:output>
        <soap:body use="literal" />
      </wsdl:output>
    </wsdl:operation>
    <wsdl:operation name="GetUpdateData">
      <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribution/GetUpdateData" style="document" />
      <wsdl:input>
        <soap:body use="literal" />
      </wsdl:input>
      <wsdl:output>
        <soap:body use="literal" />
      </wsdl:output>
    </wsdl:operation>
    <wsdl:operation name="GetUpdateDecryptionData">
      <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribution/GetUpdateDecryptionData" style="document" />
      <wsdl:input>
        <soap:body use="literal" />
      </wsdl:input>
      <wsdl:output>
```

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

### DownstreamServerRollupClientSummary XML Schema

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/abddc18a-4bf8-4ebf-bd12-8834c82285d2

Defines the sequence of elements for the DownstreamServerRollupClientSummary complex type, including OS versioning, product types, and activity summaries.

```xml
 <s:complexType name="DownstreamServerRollupClientSummary">
   <s:sequence>
     <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="OSServicePackMajorNum
 ber" type="s:int" />
     <s:element minOccurs="1" maxOccurs="1" name="OSServicePackMinorNum
 ber" type="s:int" />
     <s:element minOccurs="0" maxOccurs="1" name="OSLocale" type="s:str
 ing" />
     <s:element minOccurs="1" maxOccurs="1" name="SuiteMask" type="s:sh
 ort" />
     <s:element minOccurs="1" maxOccurs="1" name="OldProductType" type=
 "s:unsignedByte" />
     <s:element minOccurs="1" maxOccurs="1" name="NewProductType" type=
 "s:int" />
     <s:element minOccurs="1" maxOccurs="1" name="SystemMetrics" type="
 s:int" />
     <s:element minOccurs="0" maxOccurs="1" name="ProcessorArchitecture
 " type="s:string" />
     <s:element minOccurs="1" maxOccurs="1" name="Count" type="s:int" />
     <s:element minOccurs="0" maxOccurs="1" name="ActivitySummaries" ty
 pe="tns:ArrayOfDownstreamServerRollupClientActivitySummary" />
   </s:sequence>
 </s:complexType>
```

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

### DownloadFiles

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8615ba11-361d-45ec-b0eb-fea62d218bfe

The DownloadFiles operation is used to download update content files. It requires a valid cookie and a list of file digests.

```APIDOC
## DownloadFiles

### Description
Retrieves update content files based on the provided file digests.

### Parameters
- **cookie** (s1:Cookie) - Required - The cookie returned by the GetCookie operation. Must not be expired.
- **fileDigestList** (s1:ArrayOfBase64Binary) - Required - An array containing between 1 and 100 SHA-1 hash values for the update content files.
```

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

### GetAuthConfig

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/7f499e08-28c2-4490-95e3-a56d76bb1074

Requests and receives the server authorization configuration via SOAP messages.

```APIDOC
## SOAP Operation: GetAuthConfig

### Description
This operation is used to retrieve the server authorization configuration.

### Messages
- **GetAuthConfigSoapIn**: Requests the server authorization configuration.
- **GetAuthConfigSoapOut**: A response containing the server authorization configuration.
```

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

### SOAP Operations

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/8a3b2470-928a-4bd1-bdcc-8c2bf6b8e863

The Server Sync Web Service provides several SOAP operations for interacting with the synchronization proxy.

```APIDOC
## SOAP Operations

### Available Operations
- **GetAuthConfig**: Retrieves authentication configuration.
- **GetCookie**: Obtains a session cookie.
- **GetConfigData**: Fetches configuration data.
- **GetRevisionIdList**: Retrieves a list of revision IDs.
- **GetUpdateData**: Fetches data for specific updates.
- **GetUpdateDecryptionData**: Retrieves decryption data for updates.
- **DownloadFiles**: Initiates file downloads.
- **GetDeployments**: Retrieves deployment information.
- **GetRelatedRevisionsForUpdates**: Gets revisions related to specific updates.
- **Ping**: Verifies service availability.
```

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

### RollupDownstreamServers Request

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/2dedbd00-fbb7-46ee-8ee0-aec9bd1ecd2a

SOAP request for rolling up downstream server information.

```xml
<!-- REPORTING DATA SYNC PHASE: RollupDownstreamServers request -->
<?xml version="1.0" encoding="utf-8"?>
<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>
    <RollupDownstreamServers
                          xmlns="http://www.microsoft.com/SoftwareDistribution">
      <cookie>
        <Expiration>9999-12-31T23:59:59.9999999</Expiration>
        <EncryptedData />
      </cookie>
      <clientTime>2007-03-06T03:28:02.5507362Z</clientTime>
      <downstreamServers>
        <DownstreamServerRollupInfo>
          <ServerId>050cee4a-aaff-470c-8fc3-7a94cb3a4293</ServerId>
```

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

### GetOutOfSyncComputers

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/f1978fa7-59a4-44b5-980a-8efa7b8ab443

Retrieves a list of computers that are out of sync.

```APIDOC
## SOAP Operation: GetOutOfSyncComputers

### Description
Retrieves information about computers that are currently out of sync.

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

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

### GetRollupConfiguration

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/0996905e-9821-4416-a132-9d7590c224ff

Retrieves the rollup configuration data via SOAP messages.

```APIDOC
## SOAP Operation: GetRollupConfiguration

### Description
Requests and receives the rollup configuration data.

### Messages
- **GetRollupConfigurationSoapIn** - Requests the rollup configuration data.
- **GetRollupConfigurationSoapOut** - Response containing the rollup configuration data.
```

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

### GetRollupConfiguration SOAP Action

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/67d41ec2-9d9a-499a-ae7d-13da7cb01a63

Specifies the SOAP action and document style for the GetRollupConfiguration operation.

```xml
 <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribut
 ion/GetRollupConfiguration" style="document" />
```

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

### Define GetConfigData SOAP Action

Source: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wsusss/c62054a3-7ae6-4a78-9afc-80d4157d4e5d

SOAP operation configuration specifying the action and document style.

```xml
 <soap:operation soapAction="http://www.microsoft.com/SoftwareDistribut
 ion/GetConfigData" style="document" />
```
Tokens:
Raw