ClientServicingProxy.RegisterClient Method

Article
02/19/2014

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)

Usage

Syntax

'Declaration
Public Sub RegisterClient ( _
    clientInfo As ClientInfo, _
    targetGroupNames As StringCollection _
)

public void RegisterClient (
    ClientInfo clientInfo,
    StringCollection targetGroupNames
)

public:
void RegisterClient (
    ClientInfo^ clientInfo, 
    StringCollection^ targetGroupNames
)

public void RegisterClient (
    ClientInfo clientInfo, 
    StringCollection targetGroupNames
)

public function RegisterClient (
    clientInfo : ClientInfo, 
    targetGroupNames : StringCollection
)

Parameters

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).

Exceptions

Exception type	Condition
ArgumentNullException	clientInfo is null.
ArgumentException	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.

Platforms

Development Platforms

Target Platforms

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