ClientServicingProxy.RegisterClient Method

Registers a new client with the update server, or updates the registration information for an existing client.

Namespace: Microsoft.UpdateServices.ClientServicing
Assembly: Microsoft.UpdateServices.ClientServicing (in Microsoft.UpdateServices.ClientServicing.dll)



Public Sub RegisterClient ( _
    clientInfo As ClientInfo, _
    targetGroupNames As StringCollection _
public void RegisterClient (
    ClientInfo clientInfo,
    StringCollection targetGroupNames
void RegisterClient (
    ClientInfo^ clientInfo, 
    StringCollection^ targetGroupNames
public void RegisterClient (
    ClientInfo clientInfo, 
    StringCollection targetGroupNames
public function RegisterClient (
    clientInfo : ClientInfo, 
    targetGroupNames : StringCollection


  • clientInfo
    A ClientInfo object that describes the client.
  • targetGroupNames
    The names of the target groups to which the client belongs. If null or empty, the client will be added to the "Unassigned Computers" group. This parameter is ignored if the server is configured to use client-side targeting (IUpdateServerConfiguration.TargetingMode is TargetingMode.Client).


Exception type Condition

clientInfo is null.


The DnsName property of clientInfo is an empty string, or targetGroupNames contains duplicate entries.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


Development Platforms

Target Platforms

Windows Server 2008, Windows Server 2003, Windows Server 2008 R2

See Also


ClientServicingProxy Class
ClientServicingProxy Members
Microsoft.UpdateServices.ClientServicing Namespace