---
title: "SHEnsure"
---
Uses two shell scripts to Collect, and then Ensure a configuration about a server.
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.
Name | Format | Script Usage | Usage 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.