Set-AppVentiXShortcutLinkedUserSetting¶
SYNOPSIS¶
Sets the linked (prelaunch and postlaunch) User Settings of a Shortcuts User Setting.
SYNTAX¶
__AllParameterSets¶
Set-AppVentiXShortcutLinkedUserSetting [-Id] <guid> [[-Prelaunch] <Object[]>]
[[-Postlaunch] <Object[]>] [[-ConfigShare] <string>] [-Force] [-PassThru] [<CommonParameters>]
ALIASES¶
This cmdlet has the following aliases,
DESCRIPTION¶
Replaces the PrelaunchUserSettings and/or PostlaunchUserSettings of a Shortcuts User Setting. Prelaunch User Settings are processed before the application is started, postlaunch User Settings when the application has been closed. Only the list of a given parameter is replaced. An empty list removes all linked User Settings of that phase.
Only Drive Mapping, Environment Variables, External Tasks, Files and Folders, Printer Mapping and Registry Settings User Settings can be linked.
A linked User Setting cannot be assigned to user groups. When a User Setting to link is assigned to one or more user groups, you are asked to unassign it, as AppVentiX Central View does. Use -Force to unassign without asking. When you decline, nothing is changed.
EXAMPLES¶
EXAMPLE 1¶
Set-AppVentiXShortcutLinkedUserSetting -Id "ac4cc957-c328-4258-9086-1bfb4b1ffc87" -Prelaunch "f2d4c639-a348-4324-ae90-176ad83e4244", "befb465c-0413-4657-88df-68252902e734" -Postlaunch "83676923-069d-4bd6-b27a-332b092fa225"
EXAMPLE 2¶
Set-AppVentiXShortcutLinkedUserSetting -Id "ac4cc957-c328-4258-9086-1bfb4b1ffc87" -Postlaunch @()
Removes all postlaunch User Settings. The prelaunch User Settings are not changed.
EXAMPLE 3¶
$shortcut = Get-AppVentiXShortcutLinkedUserSetting -Id "ac4cc957-c328-4258-9086-1bfb4b1ffc87" $shortcut.Prelaunch = @($shortcut.Prelaunch | Where-Object UserSettingName -ne "Set Var") $shortcut | Set-AppVentiXShortcutLinkedUserSetting
Removes one prelaunch User Setting and keeps the others.
EXAMPLE 4¶
$driveMapping = Get-AppVentiXUserSettings -Type DriveMapping -FriendlyName "Map Public" Set-AppVentiXShortcutLinkedUserSetting -Id "ac4cc957-c328-4258-9086-1bfb4b1ffc87" -Prelaunch $driveMapping.Id -Force
Links a drive mapping as prelaunch User Setting and unassigns it from user groups without asking.
PARAMETERS¶
-ConfigShare¶
Path to the ConfigShare. Defaults to the module-configured ConfigShare.
Type: System.String
DefaultValue: $Script:AppVentiX.ConfigShare
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: 3
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Force¶
Unassigns linked User Settings from user groups without asking.
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Id¶
The Id (GUID) of the Shortcuts User Setting.
Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ShortcutId
ParameterSets:
- Name: (All)
Position: 0
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-PassThru¶
Returns the linked User Settings of the Shortcuts User Setting after the change.
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Postlaunch¶
The User Settings to run when the application has been closed, in order. Accepts Ids (GUID) or the objects from the Postlaunch property of Get-AppVentiXShortcutLinkedUserSetting.
Type: System.Object[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- PostlaunchId
ParameterSets:
- Name: (All)
Position: 2
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Prelaunch¶
The User Settings to run before the application is started, in order. Accepts Ids (GUID) or the objects from the Prelaunch property of Get-AppVentiXShortcutLinkedUserSetting.
Type: System.Object[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- PrelaunchId
ParameterSets:
- Name: (All)
Position: 1
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: true
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
CommonParameters¶
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.