NAME
Use-JobSchedulerMaster
SYNOPSIS
This cmdlet has to be used as the first operation with JobScheduler cmdlets.
Applies settings from a JobScheduler Master location. A Master is identified
by its JobScheduler ID and Url for which it is operated.
SYNTAX
Use-JobSchedulerMaster [-Url <String>] [-Id <String>] [-InstallPath <String>] [-BasePath <String>] [[-Environme
ntVariablesScript] <String>] -Remote <CommonParameters>
DESCRIPTION
During installation of a JobScheduler Master a number of settings are specified.
Such settings are imported for use with subsequent cmdlets.
- For a local Master that is installed on the local computer the cmdlet reads
settings from the installation path. - For a remote Master the parameter -Remote has to be used with the -Id and -Url
parameters to specify the instance.
For a
PARAMETERS
Url
-Url <String>
Specifies the Url for which a JobScheduler Master is available.
The Url includes one of the protocols http or https and optionally the port that JobScheduler listens to, e.g. http
://localhost:4444
Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters?
Id
-Id <String>
Specifies the ID of a JobScheduler Master.
The installation path is assumed from the -BasePath parameter and the JobScheduler ID,
therefore no -InstallPath parameter has to be specified.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
InstallPath
-InstallPath <String>
Specifies the installation path of a JobScheduler Master.
The installation path is expected to be accessible from the host on which the JobScheduler cmdlets are executed.
Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
BasePath
-BasePath <String>
Specifies the base path of a JobScheduler Master installation. This parameter is used in
combination with the -Id parameter to determine the installation path.
Default Value: C:\Program Files\sos-berlin.com\jobscheduler
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
EnvironmentVariablesScript
-EnvironmentVariablesScript <String>
Specifies the name of the script that includes environment variables of a JobScheduler Master installation.
Typically the script name is "jobscheduler_environment_variables.cmd" and the script is available
from the "bin" directory and optionally "user_bin" directory of a JobScheduler installation directory.
Default Value: jobscheduler_environment_variables.cmd
Required? false
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
Remote
-Remote <SwitchParameter>
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters?
RELATED LINKS
about_jobscheduler
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
C:\PS>Use-Master http://somehost:4444
Allows to manage a JobScheduler Master that is operated on the same or on a remote host.
This includes to manage Master instances that are running e.g. in a Linux box.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>Use-Master http://localhost:4444 scheduler110
Use-Master -Url http://localhost:4444 -Id scheduler110
Specifies the URL for a local master and imports settings from the the JobScheduler Master with ID scheduler110.
The installation path is determined from the default value of the -BasePath parameter.
Cmdlets that require a local Master can be used, e.g. Install-Service, Remove-Service, Start-Master.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>Use-Master -InstallPath "C:\Program Files\sos-berlin.com\jobscheduler\scheduler110"
Imports settings from the specified installation path.
-------------------------- EXAMPLE 4 --------------------------
C:\PS>Use-Master -InstallPath $env:SCHEDULER_HOME
Imports settings from the installation path that is specified from the SCHEDULER_HOME environment variable.