> 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/fr/powershell-commands/set-rdmusertag.md). # Set-RDMUserTag Set-RDMUserTag remplace intégralement les étiquettes attribuées à un utilisateur Remote Desktop Manager. ### Synopsis Définir les étiquettes d'un utilisateur. ### Syntaxe #### \_\_AllParameterSets ``` Set-RDMUserTag [-User] [-Tag] [-PassThru] [-Set] [-ForcePromptAnswer ] [-WhatIf] [-Confirm] [] ``` ### Description Définir les étiquettes d'un utilisateur. Ceci remplace les étiquettes de l'objet utilisateur ; utiliser le commutateur Set pour l'enregistrer, ou passer l'utilisateur à Set-RDMUser pour conserver le changement. La liste remplace intégralement les étiquettes de l'utilisateur, donc tout ce qu'elle ne nomme pas est effacé : pour changer une étiquette et conserver le reste, partir de la liste retournée par Get-RDMUserTag. Les étiquettes personnalisées ne peuvent contenir que des lettres, des chiffres, des espaces et les caractères . - \_ : Contractor n'est pas librement attribuable : il identifie un utilisateur contractuel, donc il est refusé sur tout autre utilisateur et toujours conservé sur un utilisateur contractuel, que la liste le nomme ou non. Nécessite la permission de modifier les utilisateurs. ### Exemples #### Exemple 1 ```powershell PS C:\> $user = Get-RDMUser -Name 'jdoe' PS C:\> Set-RDMUserTag -User $user -Tag @('External', 'Finance', 'Tier 1') PS C:\> Set-RDMUser $user ``` Remplace chaque étiquette de l'utilisateur jdoe, puis enregistre l'utilisateur. External devient une étiquette système ; Finance et Tier 1 deviennent des étiquettes personnalisées. #### Exemple 2 ```powershell PS C:\> Set-RDMUserTag -User (Get-RDMUser -Name 'jdoe') -Tag @('External', 'Finance') -Set ``` Remplace chaque étiquette de l'utilisateur jdoe et l'enregistre en un seul appel, sans Set-RDMUser distinct. #### Exemple 3 ```powershell PS C:\> Get-RDMUser | Where-Object { $_.Description -like '*service account*' } | ForEach-Object { $tags = @(Get-RDMUserTag -User $_) $tags += 'Service account' Set-RDMUserTag -User $_ -Tag $tags -PassThru } | Set-RDMUser ``` Étiquette les utilisateurs dont la description les marque comme comptes de service, puis les enregistre. Partir de la liste propre à l'utilisateur est ce qui conserve ses autres étiquettes. #### Exemple 4 ```powershell PS C:\> $user = Get-RDMUser -Name 'jdoe' PS C:\> Set-RDMUserTag -User $user -Tag @() PS C:\> Set-RDMUser $user ``` Efface toutes les étiquettes de l'utilisateur jdoe, puis enregistre l'utilisateur. ### Paramètres #### -Confirm Demande une confirmation avant d'exécuter l'applet de commande. ```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 Commutateur à utiliser avec prudence. Il répondra automatiquement aux invites posant des questions oui/non, oui/non/annuler ou ok/annuler. En cas d'invites multiples, plusieurs valeurs peuvent être passées à ce paramètre. Voici les valeurs acceptées : * Yes : Accepter l'invite. Couvre les valeurs OK et Automatic. * No : Refuser l'invite oui/non/annuler. « Cancel » est l'option de repli s'il n'y a pas d'option « No ». * Cancel : Annuler l'invite oui/non/annuler. « No » est l'option de repli s'il n'y a pas d'option « Cancel ». ```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: '' ``` #### -PassThru Retourner l'utilisateur modifié. ```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: '' ``` #### -Set Enregistrer l'utilisateur modifié. Sans cela, les étiquettes ne sont appliquées qu'à l'objet utilisateur en mémoire. ```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: '' ``` #### -Tag Étiquettes à attribuer, obtenues de Get-RDMUserTag ou données comme une liste de noms. Remplace intégralement les étiquettes de l'utilisateur : passer un tableau vide pour les effacer. ```yaml Type: System.String[] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 1 IsRequired: true ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -User Utilisateur à étiqueter, obtenu de Get-RDMUser ou New-RDMUser. ```yaml Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.IPSUser DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 0 IsRequired: true ValueFromPipeline: true ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -WhatIf Montre ce qui se passerait si l'applet de commande était exécutée. L'applet de commande n'est pas exécutée. ```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 Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'informations, consultez [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Entrées #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo Utilisateur à étiqueter, obtenu de Get-RDMUser ou New-RDMUser #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo Utilisateur infonuagique à étiqueter, obtenu de Get-RDMUser ou New-RDMUser ### Sorties #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo Utilisateur avec les étiquettes nouvellement attribuées lorsque PassThru est spécifié #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo Utilisateur infonuagique avec les étiquettes nouvellement attribuées lorsque PassThru est spécifié ### Notes Pour plus d'information, tapez « Get-Help Set-RDMUserTag -detailed ». Pour de l'information technique, tapez « Get-Help Set-RDMUserTag -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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.devolutions.net/powershell/fr/powershell-commands/set-rdmusertag.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.