Add-DSRoleAssignment

Sinossi

Assegnare un ruolo amministrativo a uno o più principal in uno o più ambiti.

Sintassi

__AllParameterSets

Add-DSRoleAssignment -RoleID <guid> -PrincipalId <guid[]> -ScopeType <AdministrativeRoleAssignmentScopeType>
 [-ScopeID <guid[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Descrizione

Concedere un ruolo a uno o più utenti, gruppi di utenti o identità applicazione su una o più risorse di ambito. A differenza dei cmdlet legacy Set-DSVaultUser/-UserGroup/-Application, questo imposta l'ID della risorsa di ambito che il server richiede affinché l'assegnazione abbia effetto.

Esempi

Esempio 1

PS C:\> $role = Get-DSAdministrativeRole | Where-Object Name -EQ 'Vault Owner'
PS C:\> Add-DSRoleAssignment -RoleID $role.Id -PrincipalId $userID -ScopeType Repository -ScopeID $vaultID

Concedere il ruolo 'Proprietario della cassaforte' a un utente su una cassaforte specifica.

Esempio 2

PS C:\> Add-DSRoleAssignment -RoleID $role.Id -PrincipalId $userID1, $userID2 -ScopeType Repository -ScopeID $vaultID1, $vaultID2

Concedere il ruolo a due utenti su due casseforti in una singola chiamata (4 assegnazioni in totale).

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

-PrincipalId

ID degli utenti, dei gruppi di utenti o delle identità applicazione a cui assegnare il ruolo.

Type: System.Guid[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-RoleID

ID del ruolo da assegnare.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ScopeID

ID delle risorse di ambito su cui è assegnato il ruolo: ID di cassaforte quando -ScopeType è Repository, ID di gateway quando è Gateway, ID di provider PAM quando è PamProvider oppure ID di unità aziendale quando è OrganizationalUnit. Obbligatorio a meno che -ScopeType non sia Global; ignorato (con un avviso) quando -ScopeType è Global.

Type: System.Guid[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ScopeType

Tipo di ambito dell'assegnazione. Obbligatorio, non esiste un valore predefinito, per evitare di assegnare silenziosamente nell'ambito errato.

Type: Devolutions.RemoteDesktopManager.AdministrativeRoleAssignmentScopeType
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: true
  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.

Note

Per maggiori informazioni, digiti "Get-Help Add-DSRoleAssignment -detailed". Per informazioni tecniche, digiti "Get-Help Add-DSRoleAssignment -full".