Set-RDMUserTag

Sinossi

Impostare i tag di un utente.

Sintassi

__AllParameterSets

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

Descrizione

Impostare i tag di un utente. Questo sostituisce i tag dell'oggetto utente; usare l'opzione Set per salvarlo, oppure passare l'utente a Set-RDMUser per rendere persistente la modifica. L'elenco sostituisce per intero i tag dell'utente, quindi tutto ciò che non nomina viene cancellato: per cambiare un tag e conservare il resto, partire dall'elenco restituito da Get-RDMUserTag. I tag personalizzati possono contenere solo lettere, cifre, spazi e i caratteri . - _ : Contractor non è assegnabile liberamente: identifica un utente contractor, quindi viene rifiutato su qualsiasi altro utente e sempre conservato su un utente contractor, indipendentemente dal fatto che l'elenco lo nomini. Richiede l'autorizzazione a modificare gli utenti.

Esempi

Esempio 1

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

Sostituisce ogni tag dell'utente jdoe, quindi salva l'utente. External diventa un tag di sistema; Finance e Tier 1 diventano tag personalizzati.

Esempio 2

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

Sostituisce ogni tag dell'utente jdoe e lo salva in una sola chiamata, senza un Set-RDMUser separato.

Esempio 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

Assegna tag agli utenti la cui descrizione li contrassegna come account di servizio, quindi li salva. Partire dall'elenco proprio dell'utente è ciò che ne conserva gli altri tag.

Esempio 4

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

Cancella ogni tag dell'utente jdoe, quindi salva l'utente.

Parametri

-Confirm

Richiede una conferma prima di eseguire il 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

Opzione da usare con cautela. Risponderà automaticamente ai prompt che pongono domande sì/no, sì/no/annulla oppure ok/annulla. In caso di più prompt, è possibile passare più valori a questo parametro. Ecco i valori accettati:

• Yes: accetta il prompt. Copre i valori OK e Automatic.
• No: rifiuta il prompt sì/no/annulla. "Cancel" è l'opzione di ripiego se non è presente l'opzione "No".
• Cancel: annulla il prompt sì/no/annulla. "No" è l'opzione di ripiego se non è presente l'opzione "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

Restituire l'utente modificato.

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

Salvare l'utente modificato. Senza di esso, i tag vengono applicati solo all'oggetto utente in 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

Tag da assegnare, ottenuti da Get-RDMUserTag o indicati come elenco di nomi. Sostituisce per intero i tag dell'utente: passare una matrice vuota per cancellarli.

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

Utente da contrassegnare, ottenuto da 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

Mostra cosa accadrebbe se il cmdlet venisse eseguito. Il cmdlet non viene eseguito.

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

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per maggiori informazioni, veda about_CommonParameters.

Input

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo

Utente da contrassegnare, ottenuto da Get-RDMUser o New-RDMUser

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo

Utente Cloud da contrassegnare, ottenuto da Get-RDMUser o New-RDMUser

Output

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSUserInfo

Utente con i tag appena assegnati quando è specificato PassThru

RemoteDesktopManager.PowerShellModule.PSOutputObject.PSCloudUserInfo

Utente Cloud con i tag appena assegnati quando è specificato PassThru

Note

Per maggiori informazioni, digiti "Get-Help Set-RDMUserTag -detailed". Per informazioni tecniche, digiti "Get-Help Set-RDMUserTag -full".