Set-RDMUserTag

Synopsis

Définir les étiquettes d'un utilisateur.

Syntaxe

__AllParameterSets

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

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

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

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

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

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.

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

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

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.

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.

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.

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.

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.

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