BuildServiceHostUtilities Class

The [BuildServiceHostUtilities] class can be used to configure a build service host on the physical computer where it will run.

Inheritance Hierarchy

System.Object
  Microsoft.TeamFoundation.Build.Config.BuildServiceHostUtilities

Namespace:  Microsoft.TeamFoundation.Build.Config
Assembly:  Microsoft.TeamFoundation.Build.Config (in Microsoft.TeamFoundation.Build.Config.dll)

Syntax

'Declaration
Public NotInheritable Class BuildServiceHostUtilities
public static class BuildServiceHostUtilities
public ref class BuildServiceHostUtilities abstract sealed
[<AbstractClass>]
[<Sealed>]
type BuildServiceHostUtilities =  class end
public final class BuildServiceHostUtilities

The BuildServiceHostUtilities type exposes the following members.

Methods

  Name Description
Public methodStatic member ChangeEndpoint Changes the endpoint—the incoming URI, such as http://machinename:9191—for the currently registered service host.
Public methodStatic member ChangeEndpointAndUser Obsolete. Changes the endpoint—the incoming URI, such as http://machinename:9191—and the service account for the currently registered service host.
Public methodStatic member ChangeInteractive(Boolean) Changes the service interactive flag for the currently registered service host.
Public methodStatic member ChangeInteractive(Boolean, Boolean)
Public methodStatic member ChangeUser Obsolete. Changes the service account for the currently registered service host.
Public methodStatic member GetCurrent Gets the currently registered build service host for this computer.
Public methodStatic member GetHttpPrefix
Public methodStatic member Register(IBuildServiceHost, String, String)
Public methodStatic member Register(IBuildServiceHost, String, String, X509Certificate2)
Public methodStatic member Register(IBuildServiceHost, String, String, String, Boolean) Registers the service host with its project collection, by using the provided userName and password. If the service host is already registered, an exception is thrown. In this case, call Unregister first.
Public methodStatic member Register(IBuildServiceHost, String, String, X509Certificate2, String, Boolean) Registers the service host with its project collection, by using the provided userName and password. If the service host is already registered, an exception is thrown. In this case, call Unregister first.
Public methodStatic member RegisterEndpointOnly Partially registers the service host by using the provided endpoint userName, and password. The service host will not be registered with a project collection and will not be usable until registration is completed.
Public methodStatic member Unregister Unregisters the currently registered service host and optionally deletes all resources (controller and agents). If you plan to move this service host to another computer, pass in false for deleteResources. If not, pass true.
Public methodStatic member UpdateAuthenticatingAccount Update the Team Foundation Server authenticating account for the currently registered service host. Use this method when a different account from the build service account is used to authenticate against TFS
Public methodStatic member UpdateBuildServiceAccount Changes the service account for the currently registered service host.If another account is used to authenticate against TFS, use UpdateAuthenticatingAccount.
Public methodStatic member UpdateEndpointAndBuildServiceAccount Changes the endpoint—the incoming URI, for example, http://machinename:9191—and the service account for the currently registered service host.If another account is used to authenticate against TFS, use UpdateAuthenticatingAccount.

Top

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.

See Also

Reference

Microsoft.TeamFoundation.Build.Config Namespace