The Configuration Logging Service PowerShell snap-in enables both local
and remote administration of the Configuration Logging Service.
The Configuration Logging Service logs configuration changes or
administrator requested state changes made to the site. Configuration
Logging can be configured, site wide, to be mandatory or optional. If
mandatory logging is selected, then any attempts to change site
configuration or state when the logging mechanism is unavailable
The Configuration Logging Service stores information about the logged
changes in a database which can be configured to be separate from
the site database.
The snap-in provides storage and configuration of these entities:
The Configuration Logging Site object holds global settings which
control the behaviour of the Configuration Logging Service. The site
object can be configured by the Set-LogSite cmdlet. The properties of
the site object are returned by the Get-LogSite cmdlet.
High Level Operations
A high level operation object represents a logged configuration change
performed from Desktop Studio, Desktop Director or a PowerShell Script.
The XenDesktop consoles log high level operations when:
1) Executing operations which performs configuration changes.
2) Executing operations which performs administration related
activities which may affect site configuration.
PowerShell scripts which carry out customized configuration changes can
also log high level operations via cmdlets Start-LogHighLevelOperation
Low Level Operations
A low level operation object represents a logged configuration change
performed by a service. One or more low level operation objects are
used to record the actions performed by a services in order to fulfil
a high level operation initiated from the consoles, or from PowerShell
Low level operations in the system are returned by cmdlet
A low level operation performed by a service can affect a number of
individual objects, or a number of properties on an object. An operation
detail log records each individual change to an object. This includes
the creation and deletion of the object, as well as changes to
individual properties of the object.
One or more operation detail objects are used to record specific changes to
each object that is affected by a low level service operation.
Operation details are included in the data returned from
the Get-LogLowLevelOperation cmdlet.
High Level Operations, Low Level Operations and Operation Details are
arranged in a hierarchy. A High Level Operation can have multiple
Low Level Operations, and each Low Level Operation can have multiple
Setting up a separate logging database
After creating the database on the database server, the logging database
can be setup and configured for use by:
1) Generating the database schema, and applying it the logging database
2) Configuring the configuration logging service to use the new logging database.
The logging database schema can be generated from the Get-LogDBSchem cmdlet,
as illustrated below:
Get-LogDBSchema -DatabaseName "loggingDB"
-ServiceGroupName "service group name"
The configuration logging service can be configured to use the logging
database with the Set-LogDBConnection cmdlet, as illustrated below:
Set-LogDBConnection -DataStore Logging -DBConnection $null
Set-LogDBConnection -DataStore Logging -DBConnection "new logging db connection string"
Configuration Logging site settings
On the Site object:
o The 'State' setting allows configuration logging to be disabled, enabled,
or made mandatory.
o The 'Locale' setting specifies the language in which configuration
logging data text will be stored.
See Get-LogSite cmdlet help for further information on these settings.
This locale setting applies to the text description that is associated with
each log , e.g. �Create Catalog�. It doesn't apply to other textual
information in the log like the names of parameters passed to
operations, e.g. �CatalogName�.
This localisation is applied when the data is logged, and not when the
logs are viewed later. For example, logs which are created in English
will be displayed in English on an end user system which may be configured
with a different locale.