Get-RDMUserTag

Übersicht

Benutzer-Tags abrufen.

Syntax

__AllParameterSets

Get-RDMUserTag [[-User] <IPSUser>] [-ForcePromptAnswer <DialogResult[]>] [<CommonParameters>]

Beschreibung

Benutzer-Tags als Namensliste abrufen, System-Tags zuerst. Ohne den Parameter User wird jedes in der Datenquelle verfügbare Benutzer-Tag zurückgegeben; mit ihm werden die diesem Benutzer zugewiesenen Tags zurückgegeben. Erfordert die Berechtigung zum Anzeigen von Benutzern.

Beispiele

Beispiel 1

PS C:\> Get-RDMUserTag

Ruft jeden in der Datenquelle verfügbaren Benutzer-Tag ab.

Beispiel 2

PS C:\> $user = Get-RDMUser -Name 'jdoe'
PS C:\> $tags = @(Get-RDMUserTag -User $user)
PS C:\> $tags += 'Contractor-2026'
PS C:\> Set-RDMUserTag -User $user -Tag $tags
PS C:\> Set-RDMUser $user

Fügt den Tags, die der Benutzer bereits trägt, ein Tag hinzu und speichert anschließend den Benutzer. Das @() ist wichtig: ohne es ergibt ein Benutzer mit einem einzelnen Tag eine Zeichenfolge, und das Anhängen würde verketten statt hinzufügen.

Parameter

-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.

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: ''

-User

Benutzer, dessen zugewiesene Tags zurückgegeben werden, abgerufen von Get-RDMUser. Weglassen, um jedes in der Datenquelle verfügbare Benutzer-Tag zurückzugeben.

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.IPSUser
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  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.

Eingaben

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo

Benutzer, dessen Tags zurückgegeben werden, abgerufen von Get-RDMUser

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo

Cloud-Benutzer, dessen Tags zurückgegeben werden, abgerufen von Get-RDMUser

Ausgaben

System.String

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help Get-RDMUserTag -detailed". Technische Informationen erhalten Sie mit "Get-Help Get-RDMUserTag -full".