AdministrationWebService4 Class

Article
07/02/2014

Inheritance Hierarchy

System.Object
  System.ComponentModel.MarshalByValueComponent
    System.Web.Services.WebService
      Microsoft.TeamFoundation.Server.Core.WebServices.TeamFoundationWebService
        Microsoft.TeamFoundation.Build.Server.BuildWebServiceBase
          Microsoft.TeamFoundation.Build.Server.AdministrationWebService4

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

Syntax

'Declaration
<ClientServiceAttribute(ComponentName := "TeamBuild", RegistrationName := "Build",  _
    ServiceName := "AdministrationService4", CollectionServiceIdentifier := "FB42B129-9E9B-4CF4-BA4F-F87859C2DB1C")> _
<WebServiceAttribute(Name := "AdministrationService", Namespace := "https://schemas.microsoft.com/TeamFoundation/2010/Build")> _
Public NotInheritable Class AdministrationWebService4 _
    Inherits BuildWebServiceBase

[ClientServiceAttribute(ComponentName = "TeamBuild", RegistrationName = "Build", 
    ServiceName = "AdministrationService4", CollectionServiceIdentifier = "FB42B129-9E9B-4CF4-BA4F-F87859C2DB1C")]
[WebServiceAttribute(Name = "AdministrationService", Namespace = "https://schemas.microsoft.com/TeamFoundation/2010/Build")]
public sealed class AdministrationWebService4 : BuildWebServiceBase

[ClientServiceAttribute(ComponentName = L"TeamBuild", RegistrationName = L"Build", 
    ServiceName = L"AdministrationService4", CollectionServiceIdentifier = L"FB42B129-9E9B-4CF4-BA4F-F87859C2DB1C")]
[WebServiceAttribute(Name = L"AdministrationService", Namespace = L"https://schemas.microsoft.com/TeamFoundation/2010/Build")]
public ref class AdministrationWebService4 sealed : public BuildWebServiceBase

[<Sealed>]
[<ClientServiceAttribute(ComponentName = "TeamBuild", RegistrationName = "Build", 
    ServiceName = "AdministrationService4", CollectionServiceIdentifier = "FB42B129-9E9B-4CF4-BA4F-F87859C2DB1C")>]
[<WebServiceAttribute(Name = "AdministrationService", Namespace = "https://schemas.microsoft.com/TeamFoundation/2010/Build")>]
type AdministrationWebService4 =  
    class 
        inherit BuildWebServiceBase 
    end

public final class AdministrationWebService4 extends BuildWebServiceBase

The AdministrationWebService4 type exposes the following members.

Constructors

	Name	Description
	AdministrationWebService4

Top

Properties

	Name	Description
	Application	Gets the application object for the current HTTP request. (Inherited from WebService.)
	Container	Gets the container for the component. (Inherited from MarshalByValueComponent.)
	Context	Gets the ASP.NET HttpContext for the current request, which encapsulates all HTTP-specific context used by the HTTP server to process Web requests. (Inherited from WebService.)
	DesignMode	Gets a value indicating whether the component is currently in design mode. (Inherited from MarshalByValueComponent.)
	Server	Gets the HttpServerUtility for the current request. (Inherited from WebService.)
	Session	Gets the HttpSessionState instance for the current request. (Inherited from WebService.)
	Site	Gets or sets the site of the component. (Inherited from MarshalByValueComponent.)
	SoapVersion	Gets the version of the SOAP protocol used to make the SOAP request to the XML Web service. (Inherited from WebService.)
	User	Gets the ASP.NET server User object. Can be used to authenticate whether a user is authorized to execute the request. (Inherited from WebService.)

Top

Methods

	Name	Description
	AcquireServiceHost
	AddBuildAgents	Adds build agents with the specified parameters to the system. The build agents that are added must have unique names throughout the containing service host. Agents may optionally be associated with a build controller when they are added to the system.
	AddBuildControllers	Adds build controllers with the specified parameters to the system. Only one build controller can be associated with a service host at a time. An attempt to define more than one build controller on a service host causes an exception.
	AddBuildServiceHost
	DeleteBuildAgents
	DeleteBuildControllers
	DeleteBuildServiceHost
	Dispose	Releases all resources used by the MarshalByValueComponent. (Inherited from MarshalByValueComponent.)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetService	Gets the implementer of the IServiceProvider. (Inherited from MarshalByValueComponent.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	QueryBuildAgents	Queries the list of build agents that match the provided specifications. The output list result sets will match up to the index of the spec that produced the result.
	QueryBuildAgentsByUri	Queries the list of build agents using the provided URIs. If a null or empty list is provided, then all of the build agents to which the caller has the appropriate permissions will be returned.
	QueryBuildControllers	Queries for a set of build controllers given a query specification. The query specification can include wildcard characters for both the controller name and the computer name.
	QueryBuildControllersByUri	Queries the list of build controllers using the provided URIs. If a null or empty list is provided, then all of the build controllers to which the caller has the appropriate permissions will be returned. Agents may be conditionally returned based on the includeAgents flag.
	QueryBuildServiceHosts
	QueryBuildServiceHostsByUri
	ReleaseServiceHost
	ToString	Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from MarshalByValueComponent.)
	UpdateBuildAgents	Updates build agents using the specified update structure to determine which fields are to be updated on the agent. The only required field is the URI for update which specifies the agent that should be updated in the call. No results are returned. Therefore, a successful update is indirectly signaled by the lack of an exception being thrown.
	UpdateBuildControllers	Updates the build controllers on the server by using the specified properties. The new object properties overwrite the old properties that existed before the update. If no exception is generated from this method, then the passed in properties are reflected in the database.
	UpdateBuildServiceHost

Top

Events

	Name	Description
	Disposed	Adds an event handler to listen to the Disposed event on the component. (Inherited from MarshalByValueComponent.)

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.