Creating Variable-Groups

Variable-Groups are containers for object-variables and are required by these. They are associated to one of the views available in DSM 2014.1, "Computer", "Software" or "Virtual Environments". In order to create new Variable-Groups, the cmdlet New-EmdbVariableGroup is used.


Hint: The execution of these examples requires a connected PowerShell drive.

The information required at least to create a new Variable-Group, is its name. If not specified otherwise, the scope of a new group is set to "Computer" and the display name equals the (internal) name supplied. The following example creates an new Variable-Group named "InternalData", that is shown in the "Computer and Users" view of the DSM console:

New-EmdbVariableGroup "InternalData"

Note: Empty Variable-Groups, i.e. groups that don't contain any Variables, are not displayed in the console.

By specifying the parameter DisplayName, the display name of the new group can be set. The following example therefore creates a Variable-Group with the internal identifier "InternalData" but sets the name displayed in the console to "Internal Variables":

New-EmdbVariableGroup "InternalData" -DisplayName "Internal variables"

If you are working in an international environment, the display names for the different languages supported by DSM 2014.1 can be specified. To achieve this, you supply a hash-table as the value of the DisplayName-switch, where each element consists of the combination <culturecode>=<displayname> and the elements are separated by semicolons.

New-EmdbVariableGroup "InternalData" -DisplayName @{de="Interne Variablen";en="Internal variables"}

In order to create a Variable-Group for the scope "Software", you set the scope via the Visibility-parameter:

New-EmdbVariableGroup "SoftwareData" -Visibility "Software"

Valid values of the Visibility-parameter are: "Computer", "Software" and "VirtualEnvironments".

Note: Note that Variable-Groups are not part of the context rootDSE and therefore they can be referenced without a full qualified path resp. an absolute path.