Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

SHEnsure

Uses two shell scripts to Collect, and then Ensure a configuration about a server.

Script usage:

SHEnsure(
	Key: <text>,
	Value: <text>,
	[Collect: <text>],
	[Configure: <text>],
	[CollectScript: <text>],
	[ConfigureScript: <text>],
	[UseExitCode: <true/false>],
	[Verbose: <true/false>],
	[CollectScriptArgs: <text>],
	[ConfigureScriptArgs: <text>]
);

This operation may be prefixed with Linux::, although this is a built-in namespace and isn't really necessary.

Arguments:

NameFormatScript UsageUsage Notes
Configuration key
text
Key
This argument is required.
Expected value
text
Value
This argument is required.
Collection script
text
Collect
The output of this shell script will be used to collect the current configuration of the server.
Configure script
text
Configure
This shell script is executed if the configuration gathered using the collection script does not match the stored configuration.
Collection script asset
text
CollectScript
The name of a shell script asset to use for collection. The output of this script will be used to collect the current configuration of the server.
Configuration script asset
text
ConfigureScript
The name of a shell script asset to use for configuration. This script is executed if the configuration gathered using the collection script does not match the stored configuration.
Use exit code
true/false
UseExitCode
When set, the exit/return code of the script will be used instead of the output stream for collection.
Verbose
true/false
Verbose
When true, additional information about staging the script is written to the debug log.
Collection script arguments
text
CollectScriptArgs
Arguments to pass to the collect script.
Configure script arguments
text
ConfigureScriptArgs
Arguments to pass to the configure script.

Note: The Key is a unique string per server, and having multiple operations attempt to use the same key will yield in unpredictable behavior.