Set-DSVaultApplication

2025-01-30

Set-DSVaultApplication

SYNOPSIS

Sets the allowed applications for a given vault.

SYNTAX

__AllParameterSets

Set-DSVaultApplication [-VaultID] <guid> [[-AllowedApplicationsList] <string[]>] [-Update]
 [-AsLegacyResponse] [<CommonParameters>]

ALIASES

This cmdlet has the following aliases,

DESCRIPTION

Sets which application have access to a given vault. If the "Update" flag is present and a supplied application name is already a member of the vault, it will remove this application.

EXAMPLES

EXAMPLE 1

PS C:> Set-DSVaultApplication @("App1", "App2")

No application allowed in the vault before the execution. App1 and App2 allowed in the vault after the command.

EXAMPLE 2

PS C:> Set-DSVaultApplication @("App3")

App1 and User2 allowed in the vault before the execution. App3 is the only application allowed in the vault after the command.

EXAMPLE 3

PS C:> Set-DSVaultApplication @("App2") -Update

App1 allowed in the vault before the execution. App1 and App2 allowed in the vault after the command. The update flag keeps previous applications.

EXAMPLE 4

PS C:> Set-DSVaultApplication @("App2", "App3") -Update

App1 and App2 allowed in the vault before the execution. App1 and App3 allowed in the vault after the command. App2 lose his access because of the presence of the update flag.

PARAMETERS

-AllowedApplicationsList

Accept an array of strings containing application names (not id) to allow in vault

Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-AsLegacyResponse

In versions prior to 2024.2, many DS cmdlets returned a ServerResponse object. Enabling this backward compatibility switch allows scripts developed for earlier versions to function correctly.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Update

Update the current applications instead of overwriting them.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-VaultID

Vault's ID to update

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  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.

INPUTS

OUTPUTS

RemoteDesktopManager.PowerShellModule.Private.ServerResponse

NOTES

For more information, type "Get-Help Set-DSVaultApplication -detailed". For technical information, type "Get-Help Set-DSVaultApplication -full".

RELATED LINKS