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
Method AddConfiguration Adds a server object configuration (created with CreateConfiguration) to the GIS server.
Method AddExtensionType Registers a new server object extension type with the server object type indicated in the argument list.
Method AddMachine Adds a host machine (created with CreateMachine) to the GIS server.
Method AddServerDirectory Adds a server directory (created with CreateServerDirectory) to the GIS server.
Method CreateConfiguration Creates a new server object configuration.
Method CreateExtensionType Creates a new empty server object extension type.
Method CreateFolder Creates a server configuration folder.
Method CreateMachine Creates a new host machine.
Method CreateServerDirectory Creates a new server directory.
Method DeleteConfiguration Deletes a server object configuration from the GIS server.
Method DeleteExtensionType Unregisters a server object extension type from the server object type indicated in the argument list.
Method DeleteFolder Deletes a server configuration folder.
Method DeleteMachine Deletes a host machine from the GIS server, making it unavailable to host server objects.
Method 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.
Method Disable Disables a started SOM.
Method Enable Enables a disabled SOM.
Read/write property FolderInfo Properties associated with a server configuration folder.
Method GetConfiguration Get the server object configuration with the specified Name and TypeName.
Method GetConfigurations An enumerator over all the server object configurations.
Method GetConfigurationsEx An enumerator over all the server object configurations in a server configuration folder.
Method GetConfigurationsEx2 An enumerator over all the server object configurations in a server configuration folder.
Method GetConfigurationStatus Get the configuration status for a server object configuration with the specified Name and TypeName.
Method GetExtensionTypes An enumerator over all the server object extension types.
Method GetFolders An array of folder names in the server configuration folder.
Method GetMachine Get the host machine with the specified Name.
Method GetMachines An enumerator over all the GIS server's host machines.
Method GetServerDirectories An enumerator over the GIS server's output directories.
Method GetServerDirectory Get the server directory with the specified Path.
Method GetTypes An enumerator over all the server object types.
Read/write property IsSecurityEnabled Indicates whether security is switched on or off.
Method 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.
Read/write property Properties The properties for the GIS server.
Method RenameFolder Renames a server configuration folder.
Read-only property ServerLog Retrieves a reference to the ArcGIS Server logs.
Method StartConfiguration Starts a server object configuration and makes it available to clients for processing requests.
Method StopConfiguration Stops a server object configuration and shuts down any running instances of server objects defined by the configuration.
Method UpdateConfiguration Updates the properties of a server object configuration.
Method UpdateMachine Updates the properties of a host machine.
Method UpdateServerDirectory Updates the properties of a server directory.
Method 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
ServerObjectAdmin The ServerObjectAdmin object which administrates the GIS Server.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.