Skip to content

Citrix.WEM.SDK.Configuration.InfrastructureService

Property Commandlets.BaseInfrastructureServiceConfigurationCommand.InfrastructureServer

Remote infrastructure service machine name or IP address.


Property Commandlets.BaseInfrastructureServiceConfigurationCommand.InfrastructureServerCredential

PSCredential that will be used on the remote machine for getting data.


Property Commandlets.BaseInfrastructureServiceConfigurationCommand.PSDebugMode

Enable verbose logging of the infrastructure service. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Type Commandlets.GetWemInfrastructureServiceConfiguration

Get the current infrastructure service configuration.

The Get-WemInfrastructureServiceConfiguration cmdlet gets the current infrastructure service configuration from the local or remote infrastructure server machine. Remote machines can be either in the same domain, or can be in a multi-forest domain environment.

--To return the current configuration on the local infrastructure server, run the cmdlet without the InfrastructureServer parameter and without the InfrastructureServerCredential parameter. All the following parameter values are applied.

--To return the current configuration from a remote server in the same domain, you must specify the InfrastructureServer parameter.

--To return the current configuration from a remote server in a multi forest Active Directory environment, you must specify the InfrastructureServer parameter (to identify the target machine) and the InfrastructureServerCredential parameter(to provide access credentials).

Example:
code
Get-WemInfrastructureServiceConfiguration

Get the current configuration of the infrastructure service from the local machine.

Example:
code
Get-WemInfrastructureServiceConfiguration InfrastructureServer [Server]

Get the current configuration of the infrastructure service from the remote machine in the same domain by using Windows authentication.

Example:
code
    $passwd = ConvertTo-SecureString "[Password]" -AsPlainText -Force; 
    $cred = New-Object System.Management.Automation.PSCredential ("[Domain\UserName]", $passwd)
    Get-WemInfrastructureServiceConfiguration InfrastructureServer [Server] InfrastructureServiceAccountCredentials $cred

Get the current configuration of the infrastructure service from the remote machine in multi-forest environments. For authentication, this cmdlet uses the PSCredential type object.

Set-WemInfrastructureServiceConfiguration


Type Commandlets.SetWemInfrastructureServiceConfiguration

Set the infrastructure service configuration on a local or remote machine.

The Set-WemInfrastructureServiceConfiguration cmdlet sets the infrastructure service configuration on a local or remote infrastructure server machine. Remote machines can be either in the same domain, or can be in a multi-forest domain environment. You can set the full configuration, or a subset of it.

--To return the current configuration on the local infrastructure server, run the cmdlet without the InfrastructureServer parameter and without the InfrastructureServerCredential parameter. All the following parameter values are applied.

--To set the current configuration to a remote server in the same domain, you must specify the InfrastructureServer parameter.

--To set the current configuration to a remote server in a multi forest Active Directory environment, you must specify the InfrastructureServer parameter (to identify the target machine) and the InfrastructureServerCredential parameter(to provide access credentials).

Example:
code
Set-WemInfrastructureServiceConfiguration -DatabaseName "WEM_DB";

Set a single configuration option (DatabaseName) on the local machine.

Example:
code
    $Enable = [Norskale.Utilities.Common.SwitchState]::Enable;
    Set-WemInfrastructureServiceConfiguration -DatabaseName "WEM_DB" -MonitoringPort 8084 -DebugMode $Enable;

Set multiple configuration options (DatabaseName, MonitoringPort, and EnableDebug) on the local machine.

Example:
code
    $Enable = [Norskale.Utilities.Common.SwitchState]::Enable;
    Set-WemInfrastructureServiceConfiguration -InfrastructureServer "[Server]" -DatabaseName "WEM_DB" -MonitoringPort 8084 -DebugMode $Enable;

Set multiple configuration options (DatabaseName, MonitoringPort, and EnableDebug) on the remote machine in the same domain by using Windows authentication.

Example:
code
    $passwd = ConvertTo-SecureString "[Password]" -AsPlainText -Force; 
    $cred = New-Object System.Management.Automation.PSCredential("[Domain]\[UserName]", $passwd);
    Set-WemInfrastructureServiceConfiguration -InfrastructureServer "[Server]" -InfrastructureServiceAccountCredential $cred -DatabaseName "WEM_DB" -MonitoringPort 8084;

Set multiple configuration options (DatabaseName and MonitoringPort) on the remote machine in multi-forest domain environments.

Example:
code
    $Enable = [Norskale.Utilities.Common.SwitchState]::Enable;
    $Disable = [Norskale.Utilities.Common.SwitchState]::Disable;
    $config = New-Object Citrix.WEM.SDK.Configuration.InfrastructureService.SDKInfrastructureServiceConfiguration
    $config.DatabaseServerInstance = "SQLServer_machine";                   
    $config.DatabaseName = "WEM_DB";
    $config.AdminServicePort = 8284;
    $config.DebugMode = $Disable;
    $config.SendGoogleAnalytics = $Enable
    ...
    Set-WemInfrastructureServiceConfiguration -Configuration $config

Configure the infrastructure service through a single configuration object. You can also use this approach to configure the local and remote machine (in the same domain or in multi-forest domain environments).

Warning! If you use a single configuration object, make sure that you configure all required properties of the configuration object. Otherwise, infrastructure service is configured with empty values by default.

Get-WemInfrastructureServiceConfiguration


Property Commandlets.SetWemInfrastructureServiceConfiguration.DebugMode

Enable WEM debug mode. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.SendGoogleAnalytics

Enable collection of statistics. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.UseCacheEvenIfOnline

Enable infrastructure service to always reading site settings from its cache. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.DatabaseServerInstance

SQL Server instance on which the WEM database is hosted. (serveraddress,port\instancename).


Property Commandlets.SetWemInfrastructureServiceConfiguration.DatabaseName

WEM database name.


Property Commandlets.SetWemInfrastructureServiceConfiguration.DatabaseFailoverServerInstance

Database failover server instance.


Property Commandlets.SetWemInfrastructureServiceConfiguration.SetSqlUserSpecificPassword

Allow vuemUser SQL user account password to be set. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.SqlUserSpecificPassword

vuemUser SQL user account password.


Property Commandlets.SetWemInfrastructureServiceConfiguration.AdminServicePort

Administration port for administration console to connect to the infrastructure service.


Property Commandlets.SetWemInfrastructureServiceConfiguration.AgentServicePort

Agent service port for agent to connect to the infrastructure server.


Property Commandlets.SetWemInfrastructureServiceConfiguration.AgentSyncPort

Cache synchronization port for agent cache synchronization process to connect to the infrastructure service.


Property Commandlets.SetWemInfrastructureServiceConfiguration.MonitoringPort

WEM monitoring port.


Property Commandlets.SetWemInfrastructureServiceConfiguration.InfrastructureServiceAccountCredential

PSCredential for running the infrastructure service.


Property Commandlets.SetWemInfrastructureServiceConfiguration.EnableInfrastructureServiceAccountCredential

Use Windows authentication for infrastructure service database connection. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.CacheRefreshDelay

Time (in minutes) before the infrastructure service refreshes its cache.


Property Commandlets.SetWemInfrastructureServiceConfiguration.SQLCheckDelay

Time (in seconds) between each infrastructure service attempt to poll the SQL server.


Property Commandlets.SetWemInfrastructureServiceConfiguration.InfrastructureServiceSQLConnectionTimeout

Time (in seconds) which the infrastructure service waits when trying to establish a connection with the SQL server.


Property Commandlets.SetWemInfrastructureServiceConfiguration.EnableScheduledMaintenance

Enable deletion of old statistics records from the database at periodic intervals. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.StatisticsRetentionPeriod

Retention period for user and agent statistics (in days).


Property Commandlets.SetWemInfrastructureServiceConfiguration.SystemMonitoringRetentionPeriod

Retention period for system optimization statistics (in days).


Property Commandlets.SetWemInfrastructureServiceConfiguration.AgentRegistrationsRetentionPeriod

Retention period for agent registration logs (in days).


Property Commandlets.SetWemInfrastructureServiceConfiguration.DatabaseMaintenanceExecutionTime

The time at which the database maintenance action is performed (HH:MM).


Property Commandlets.SetWemInfrastructureServiceConfiguration.GlobalLicenseServerOverride

Override any Citrix License Server information already in the WEM database. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.LicenseServerName

Citrix License Server name.


Property Commandlets.SetWemInfrastructureServiceConfiguration.LicenseServerPort

Citrix License Server port.


Property Commandlets.SetWemInfrastructureServiceConfiguration.Configuration

Configuration set to save the settings in.


Property Commandlets.SetWemInfrastructureServiceConfiguration.BrokerMinimumWorkerThreads

Minimum number of worker threads.


Property Commandlets.SetWemInfrastructureServiceConfiguration.BrokerMinimumCompletetionPortThreads

Minimum number of asynchronous I/O threads.


Property Commandlets.SetWemInfrastructureServiceConfiguration.EnablePerformanceSettings

Enable configuration of WCF performance settings. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property Commandlets.SetWemInfrastructureServiceConfiguration.CachedDataSyncPort

Cache synchronization port for agent cache synchronization process to connect to the infrastructure service.


Type SDKInfrastructureServiceConfiguration

SDK Infrastructure service Configuration object.


Property SDKInfrastructureServiceConfiguration.DebugMode

Enable WEM debug mode. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.SendGoogleAnalytics

Enable collection of statistics. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.UseCacheEvenIfOnline

Enable infrastructure service to always reading site settings from its cache. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.DatabaseServerInstance

SQL Server instance on which the WEM database is hosted. (serveraddress,port\instancename).


Property SDKInfrastructureServiceConfiguration.DatabaseName

WEM database name.


Property SDKInfrastructureServiceConfiguration.DatabaseFailoverServerInstance

Database failover server instance.


Property SDKInfrastructureServiceConfiguration.SetSqlUserSpecificPassword

Allow vuemUser SQL user account password to be set. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.SqlUserSpecificPassword

vuemUser SQL user account password.


Property SDKInfrastructureServiceConfiguration.AdminServicePort

Administration port for administration console to connect to the infrastructure service.


Property SDKInfrastructureServiceConfiguration.AgentServicePort

Agent service port for agent to connect to the infrastructure server.


Property SDKInfrastructureServiceConfiguration.AgentSyncPort

Cache synchronization port for agent cache synchronization process to connect to the infrastructure service.


Property SDKInfrastructureServiceConfiguration.MonitoringPort

WEM monitoring port.


Property SDKInfrastructureServiceConfiguration.CachedDataSyncPort

Cached data synchronization port for agent cached data synchronization process to connect to the infrastructure service.


Property SDKInfrastructureServiceConfiguration.EnablePerformanceSettings

Enable configuration of WCF performance settings. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.BrokerMinimumWorkerThreads

Minimum number of worker threads.


Property SDKInfrastructureServiceConfiguration.BrokerMinimumCompletetionPortThreads

Minimum number of asynchronous I/O threads.


Property SDKInfrastructureServiceConfiguration.InfrastructureServiceAccountCredentialLogin

Login for running the infrastructure service.


Property SDKInfrastructureServiceConfiguration.InfrastructureServiceAccountCredentialPassword

Password for running the infrastructure service.


Property SDKInfrastructureServiceConfiguration.EnableInfrastructureServiceAccountCredential

Use Windows authentication for infrastructure service database connection. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.CacheRefreshDelay

Time (in minutes) before the infrastructure service refreshes its cache.


Property SDKInfrastructureServiceConfiguration.SqlCheckDelay

Time (in seconds) between each infrastructure service attempt to poll the SQL server.


Property SDKInfrastructureServiceConfiguration.InfrastructureServiceSQLConnectionTimeout

Time (in seconds) which the infrastructure service waits when trying to establish a connection with the SQL server.


Property SDKInfrastructureServiceConfiguration.EnableScheduledMaintenance

Enable deletion of old statistics records from the database at periodic intervals. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.StatisticsRetentionPeriod

Retention period for user and agent statistics (in days).


Property SDKInfrastructureServiceConfiguration.SystemMonitoringRetentionPeriod

Retention period for system optimization statistics (in days).


Property SDKInfrastructureServiceConfiguration.AgentRegistrationsRetentionPeriod

Retention period for agent registration logs (in days).


Property SDKInfrastructureServiceConfiguration.DatabaseMaintenanceExecutionTime

The time at which the database maintenance action is performed (HH:MM).


Property SDKInfrastructureServiceConfiguration.GlobalLicenseServerOverride

Override any Citrix License Server information already in the WEM database. Specify 'None' to leave the current value unchanged. This is equivalent to omitting this parameter.


Property SDKInfrastructureServiceConfiguration.LicenseServerName

Citrix License Server name.


Property SDKInfrastructureServiceConfiguration.LicenseServerPort

Citrix License Server port.