Set-RDMUserTag

Sinopsis

Establecer las etiquetas de un usuario.

Sintaxis

__AllParameterSets

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

Descripción

Establecer las etiquetas de un usuario. Esto reemplaza las etiquetas del objeto de usuario; use el modificador Set para guardarlo, o pase el usuario a Set-RDMUser para conservar el cambio. La lista reemplaza por completo las etiquetas del usuario, así que todo lo que no nombra se borra: para cambiar una etiqueta y conservar el resto, parta de la lista devuelta por Get-RDMUserTag. Las etiquetas personalizadas solo pueden contener letras, dígitos, espacios y los caracteres . - _ : Contractor no se puede asignar libremente: identifica a un usuario contratista, por lo que se rechaza en cualquier otro usuario y siempre se conserva en uno contratista, tanto si la lista lo nombra como si no. Requiere el permiso para editar usuarios.

Ejemplos

Ejemplo 1

PS C:\> $user = Get-RDMUser -Name 'jdoe'
PS C:\> Set-RDMUserTag -User $user -Tag @('External', 'Finance', 'Tier 1')
PS C:\> Set-RDMUser $user

Reemplaza cada etiqueta del usuario jdoe y, a continuación, guarda el usuario. External pasa a ser una etiqueta del sistema; Finance y Tier 1 pasan a ser etiquetas personalizadas.

Ejemplo 2

PS C:\> Set-RDMUserTag -User (Get-RDMUser -Name 'jdoe') -Tag @('External', 'Finance') -Set

Reemplaza cada etiqueta del usuario jdoe y lo guarda en una sola llamada, sin un Set-RDMUser aparte.

Ejemplo 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

Etiqueta a los usuarios cuya descripción los marca como cuentas de servicio y, a continuación, los guarda. Partir de la propia lista del usuario es lo que conserva sus otras etiquetas.

Ejemplo 4

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

Borra todas las etiquetas del usuario jdoe y después guarda el usuario.

Parámetros

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

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

Modificador que debe usarse con precaución. Responderá automáticamente a los mensajes que planteen preguntas de sí/no, sí/no/cancelar u ok/cancelar. En caso de varios mensajes, se pueden pasar varios valores a este parámetro. Estos son los valores aceptados:

• Yes: acepta el mensaje. Cubre los valores OK y Automatic.
• No: rechaza el mensaje sí/no/cancelar. "Cancel" es la opción alternativa si no existe la opción "No".
• Cancel: cancela el mensaje sí/no/cancelar. "No" es la opción alternativa si no existe la opción "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

Devolver el usuario modificado.

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

Guardar el usuario modificado. Sin ello, las etiquetas solo se aplican al objeto de usuario en memoria.

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

Etiquetas que asignar, obtenidas de Get-RDMUserTag o indicadas como una lista de nombres. Reemplaza por completo las etiquetas del usuario: pase una matriz vacía para borrarlas.

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

Usuario que etiquetar, obtenido de Get-RDMUser o 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

Muestra lo que ocurriría si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo

Usuario que etiquetar, obtenido de Get-RDMUser o New-RDMUser

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo

Usuario de Cloud que etiquetar, obtenido de Get-RDMUser o New-RDMUser

Salidas

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo

Usuario con las etiquetas recién asignadas cuando se especifica PassThru

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo

Usuario de Cloud con las etiquetas recién asignadas cuando se especifica PassThru

Notas

Para más información, escriba "Get-Help Set-RDMUserTag -detailed". Para obtener información técnica, escriba "Get-Help Set-RDMUserTag -full".