Set-RDMUserTag

Übersicht

Die Tags eines Benutzers festlegen.

Syntax

__AllParameterSets

Set-RDMUserTag [-User] <IPSUser> [-Tag] <string[]> [-PassThru] [-Set]
 [-ForcePromptAnswer <DialogResult[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

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

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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