> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell/powershell-commands/set-rdmentry.md). # Set-RDMEntry ### Synopsis Save the entry. ### Syntax #### \_\_AllParameterSets ``` Set-RDMEntry [-InputObject] [-PassThru] [-Refresh] [-VaultMode ] [-ForcePromptAnswer ] [-WhatIf] [-Confirm] [] ``` ### Description Save the entry. The entry must be obtained via the Get-RDMEntry cmdlet or via the New-RDMEntry cmdlet. In the system vault, the supported types are limited to Group, Contact, SessionTool, and VPN. This cmdlet cannot be used to move an entry to another vault. To do so, use the Move-RDMEntry cmdlet. The user must have the rights to add or edit the entry. In the system vault, the user must be an administator. ### Examples #### Example 1 ```powershell PS C:\> $folder = New-RDMEntry -Name 'New Folder' -Type 'Group'; $folder.GroupDetails.UserName = 'MyUserName'; $folder.GroupDetails.Domain = 'MyDomain'; $folder = Set-RDMEntry -InputObject $folder -PassThru ``` Create a new entry without saving it and store it in $folder. Add some additionnal information in the GroupDetails. Save the entry in the current vault and store it in $folder. #### Example 2 ```powershell PS C:\> $entries = Get-RDMEntry -Name Entry?; $entries | ForEach-Object { $_.Name = '[Deprecated]' + $_.Name }; $entries | Set-RDMEntry -Reresh ``` Store all entries whose name is Entry followed by a character. Append '\[Deprecated]' to their name and save the modifications. The switch Refresh is used to ensure subsequent commands are applied on the modified entries. ### Parameters #### -Confirm Prompts you for confirmation before running the cmdlet. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: - cf ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -ForcePromptAnswer Switch to use with caution. It will automatically answer prompt asking yes/no, yes/no/cancel, or ok/cancel questions. In case of multiple prompts, multiple values can be passed to this parameter. Here are the accepted values: * Yes: Accept the prompt. Cover the OK and Automatic value. * No: Refuse the yes/no/cancel prompt. "Cancel" is the fallback option if there is no "No" option. * Cancel: Cancel the yes/no/cancel prompt. "No" is the fallback option if there is no "Cancel" option. ```yaml Type: System.Windows.Forms.DialogResult[] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -InputObject PSConnection\[] object retrieved from Get-RDMEntry or created via New-RDMEntry. ```yaml Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection[] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 0 IsRequired: true ValueFromPipeline: true ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -PassThru Return the all saved entries as a PSConnection\[]. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Refresh Refresh entries in the vault. All entries of type 'Group' automatically trigger a refresh to ensure they are available for other entries. For modification in bulk, use Update-RDMEntries after the modifications instead of this switch. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -VaultMode Vault where the command will be applied. Three choices are offered: * Default: Current vault that has been set. * User: Vault specific to the current user. * Global: Global vault of the workspace. ```yaml Type: Devolutions.RemoteDesktopManager.VaultMode DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. ```yaml Type: System.Management.Automation.SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: - wi ParameterSets: - Name: (All) Position: Named IsRequired: false 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](https://go.microsoft.com/fwlink/?LinkID=113216). ### Inputs #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSConnection Entries to save obtained from Get-RDMEntry or New-RDMEntry ### Notes For more information, type "Get-Help Set-RDMEntry -detailed". For technical information, type "Get-Help Set-RDMEntry -full". --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell/powershell-commands/set-rdmentry.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.