> 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/de/powershell-commands/set-rdmusertag.md). # Set-RDMUserTag Set-RDMUserTag ersetzt die einem Remote Desktop Manager-Benutzer zugewiesenen Tags vollständig. ### Übersicht Die Tags eines Benutzers festlegen. ### Syntax #### \_\_AllParameterSets ``` Set-RDMUserTag [-User] [-Tag] [-PassThru] [-Set] [-ForcePromptAnswer ] [-WhatIf] [-Confirm] [] ``` ### Beschreibung Die Tags eines Benutzers festlegen. Dies ersetzt die Tags des Benutzerobjekts; den Schalter Set verwenden, um es zu speichern, oder den Benutzer an Set-RDMUser übergeben, um die Änderung zu speichern. Die Liste ersetzt die Tags des Benutzers vollständig, alles, was sie nicht nennt, wird gelöscht: um ein Tag zu ändern und den Rest zu behalten, von der von Get-RDMUserTag zurückgegebenen Liste ausgehen. Benutzerdefinierte Tags dürfen nur Buchstaben, Ziffern, Leerzeichen und die Zeichen . - \_ enthalten: Contractor ist nicht frei zuweisbar: es kennzeichnet einen Auftragnehmerbenutzer, wird daher bei jedem anderen Benutzer abgelehnt und bei einem Auftragnehmerbenutzer immer beibehalten, unabhängig davon, ob die Liste es nennt. Erfordert die Berechtigung zum Bearbeiten von Benutzern. ### Beispiele #### Beispiel 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 ``` Ersetzt jedes Tag des Benutzers jdoe und speichert anschließend den Benutzer. External wird ein System-Tag; Finance und Tier 1 werden benutzerdefinierte Tags. #### Beispiel 2 ```powershell PS C:\> Set-RDMUserTag -User (Get-RDMUser -Name 'jdoe') -Tag @('External', 'Finance') -Set ``` Ersetzt jedes Tag des Benutzers jdoe und speichert ihn in einem Aufruf, ohne ein separates Set-RDMUser. #### Beispiel 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 ``` Versieht die Benutzer, deren Beschreibung sie als Dienstkonten kennzeichnet, mit Tags und speichert sie. Von der eigenen Tagliste des Benutzers auszugehen erhält seine übrigen Tags. #### Beispiel 4 ```powershell PS C:\> $user = Get-RDMUser -Name 'jdoe' PS C:\> Set-RDMUserTag -User $user -Tag @() PS C:\> Set-RDMUser $user ``` Entfernt jeden Tag des Benutzers jdoe und speichert dann den Benutzer. ### Parameter #### -Confirm Fordert vor der Ausführung des Cmdlets eine Bestätigung an. ```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 Mit Vorsicht zu verwendender Schalter. Er beantwortet automatisch Eingabeaufforderungen mit Ja/Nein-, Ja/Nein/Abbrechen- oder OK/Abbrechen-Fragen. Bei mehreren Eingabeaufforderungen können mehrere Werte an diesen Parameter übergeben werden. Hier sind die zulässigen Werte: * Yes: Die Eingabeaufforderung annehmen. Deckt die Werte OK und Automatic ab. * No: Die Ja/Nein/Abbrechen-Eingabeaufforderung ablehnen. "Cancel" ist die Ausweichoption, wenn keine "No"-Option vorhanden ist. * Cancel: Die Ja/Nein/Abbrechen-Eingabeaufforderung abbrechen. "No" ist die Ausweichoption, wenn keine "Cancel"-Option vorhanden ist. ```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 Den geänderten Benutzer zurückgeben. ```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 Den geänderten Benutzer speichern. Ohne diesen Schalter werden die Tags nur auf das Benutzerobjekt im Arbeitsspeicher angewendet. ```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 Zuzuweisende Tags, abgerufen von Get-RDMUserTag oder als Namensliste angegeben. Ersetzt die Tags des Benutzers vollständig: ein leeres Array übergeben, um sie zu löschen. ```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 Zu markierender Benutzer, abgerufen von Get-RDMUser oder 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 Zeigt, was passieren würde, wenn das Cmdlet ausgeführt würde. Das Cmdlet wird nicht ausgeführt. ```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 Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Eingaben #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo Zu markierender Benutzer, abgerufen von Get-RDMUser oder New-RDMUser #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo Zu markierender Cloud-Benutzer, abgerufen von Get-RDMUser oder New-RDMUser ### Ausgaben #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo Benutzer mit den neu zugewiesenen Tags, wenn PassThru angegeben ist #### RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo Cloud-Benutzer mit den neu zugewiesenen Tags, wenn PassThru angegeben ist ### Hinweise Weitere Informationen erhalten Sie mit "Get-Help Set-RDMUserTag -detailed". Technische Informationen erhalten Sie mit "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/de/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.