IServerObjectAdmin4 Interface

Provides access to members that administer the ArcGIS server.

Description

IServerObjectAdmin4provides methods to retrieve server configuration information and to administer the ArcGIS Server.

The IServerObjectAdmin4interface can be obtained by a query interface with the IServerObjectAdmin interface.

Members

	Name	Description
	AddConfiguration	Adds a server object configuration (created with CreateConfiguration) to the GIS server.
	AddExtensionType	Registers a new server object extension type with the server object type indicated in the argument list.
	AddMachine	Adds a host machine (created with CreateMachine) to the GIS server.
	AddServerDirectory	Adds a server directory (created with CreateServerDirectory) to the GIS server.
	CreateConfiguration	Creates a new server object configuration.
	CreateExtensionType	Creates a new empty server object extension type.
	CreateFolder	Creates a server configuration folder.
	CreateMachine	Creates a new host machine.
	CreateServerDirectory	Creates a new server directory.
	DeleteConfiguration	Deletes a server object configuration from the GIS server.
	DeleteExtensionType	Unregisters a server object extension type from the server object type indicated in the argument list.
	DeleteFolder	Deletes a server configuration folder.
	DeleteMachine	Deletes a host machine from the GIS server, making it unavailable to host server objects.
	DeleteServerDirectory	Deletes a server directory such that its cleanup is no longer managed by the GIS server. It does not delete the physical directory from disk.
	Disable	Disables a started SOM.
	Enable	Enables a disabled SOM.
	FolderInfo	Properties associated with a server configuration folder.
	GetConfiguration	Get the server object configuration with the specified Name and TypeName.
	GetConfigurations	An enumerator over all the server object configurations.
	GetConfigurationsEx	An enumerator over all the server object configurations in a server configuration folder.
	GetConfigurationsEx2	An enumerator over all the server object configurations in a server configuration folder.
	GetConfigurationStatus	Get the configuration status for a server object configuration with the specified Name and TypeName.
	GetExtensionTypes	An enumerator over all the server object extension types.
	GetFolders	An array of folder names in the server configuration folder.
	GetMachine	Get the host machine with the specified Name.
	GetMachines	An enumerator over all the GIS server's host machines.
	GetServerDirectories	An enumerator over the GIS server's output directories.
	GetServerDirectory	Get the server directory with the specified Path.
	GetTypes	An enumerator over all the server object types.
	IsSecurityEnabled	Indicates whether security is switched on or off.
	PauseConfiguration	Makes the configuration unavailable to clients for processing requests, but does not shut down running instances of server objects, or interrupt requests in progress.
	Properties	The properties for the GIS server.
	RenameFolder	Renames a server configuration folder.
	ServerLog	Retrieves a reference to the ArcGIS Server logs.
	StartConfiguration	Starts a server object configuration and makes it available to clients for processing requests.
	StopConfiguration	Stops a server object configuration and shuts down any running instances of server objects defined by the configuration.
	UpdateConfiguration	Updates the properties of a server object configuration.
	UpdateMachine	Updates the properties of a host machine.
	UpdateServerDirectory	Updates the properties of a server directory.
	ValidateConfiguration	Validates server object configuration.

IServerObjectAdmin4.IsSecurityEnabled Property

Indicates whether security is switched on or off.

Public Property IsSecurityEnabled As Boolean

public bool IsSecurityEnabled {get; set;}

Remarks

IsSecurityEnabled has a Default value of OFF.

This switch does NOT affect

- any methods called on IServerObjectAdmin, IServerObjectAdmin2 or IServerObjectAdmin3

- any methods called on IServerObjectManager, IServerObjectManager2, IServerObjectManager3 orIServerObjectManager4 obtained from IGISServerConnection.ServerObjectManager..

This swtich DOES affect the following IServerObjectManager methods only when the interfacesare accessed through IGISServerConnection2.ServerObjectManager:

 IServerObjectManager.CreateServerContext
 IServerObjectManager.GetConfigurationInfo
 IServerObjectManager.GetConfigurationInfos

 IServerObjectManager2.GetConfigurationInfosEx
 IServerObjectManager2.GetFolders
 IServerObjectManager2.FolderInfo
 IServerObjectManager2.GetConfigurationStatus

 IServerObjectManager3.GetConfigurationInfosEx2

In the case that a user does not have permissions to access a particular resource (e.g configuration or folder ), each of the methods above will return ACCESSDENIED errors and produce the following error message:

_"User X does not have sufficient permissions to access Y."_

When a user obtains a list of configurations, configurationInfos or Folders it will NOT contain resources to which the user does not have access.

VERY IMPORTANT - If you disable security through the API with a call to IPermissionsAdmin.IsSecurityEnabled = false, you will have exposed all of your web services to the public internet and security will be defeated. Disable security at your own risk!

Inherited Interfaces

Interfaces	Description
IServerObjectAdmin3	Provides access to members that administer the ArcGIS server.
IServerObjectAdmin2	Provides access to members that administer the ArcGIS server.
IServerObjectAdmin	Provides access to members that administer the ArcGIS server.

Classes that implement IServerObjectAdmin4

Classes	Description