New-DSEntityPermission

Résumé

Créer un objet de permission pour une entité

Syntaxe

WithExistenceCheck (par défaut)

New-DSEntityPermission [-Override] <SecurityRoleOverride> [-Right] <SecurityRoleRight>
 [-User <string[]>] [-Role <string[]>] [-Application <string[]>] [<CommonParameters>]

WithoutExistenceCheck

New-DSEntityPermission [-Override] <SecurityRoleOverride> [-Right] <SecurityRoleRight>
 [-PrincipalId] <guid[]> [<CommonParameters>]

Description

Créer un objet de permission pour une entité. Les paramètres User, Role et Application peuvent être spécifiés par leur ID ou par leur nom. Pour une application, le nom fait référence à l'Application ID, car le nom affiché n'est pas nécessairement unique. L'existence de toutes les entités sera confirmée, avec un message d'avertissement pour celles qui ne sont pas trouvées. Le paramètre ID accepte uniquement les ID, qu'ils correspondent à un utilisateur, à un groupe d'utilisateurs ou à une application. Aucune vérification d'existence ne sera effectuée sur les entités spécifiées par ce paramètre, donc assurez-vous d'utiliser les bons ID. Comme aucune vérification n'a lieu, c'est beaucoup plus rapide.

Exemples

Exemple 1

PS C:\> $permission = New-DSEntityPermission -Override Custom -Right Delete -User MyUserA, MyUserB
        $pamRoot = Get-DSPamFolder -VaultID $pamVaultID -Root
        Set-DSEntityPermission -EntityID $pamRoot.ID -Permissions $permission

Pour les comptes PAM dans le coffre PAM dont l'ID est $pamVaultID, le droit par défaut de supprimer sera assigné à MyUserA et MyUserB.

Exemple 2

PS C:\> $userIDs = Get-DSUser | Where Name -like *something* | Select -ExpandProperty ID
        $permission = New-DSEntityPermission -Override CustomInherited -Right Edit -PrincipalId $userIDs
        Set-DSEntityPermission -EntityID $entryID -Permissions $permission

Ajouter les utilisateurs dont le nom contient 'something' aux utilisateurs hérités qui peuvent modifier l'entrée dont l'ID est stocké dans $entryID

Paramètres

-Application

Identités d’application autorisées à accéder au droit. Peuvent être spécifiées par leur application ID ou par leur ID.

Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: WithExistenceCheck
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Override

Définit comment les permissions sont déterminées. Cinq modes sont disponibles : Custom : Spécifier une valeur personnalisée pour la permission. Seuls les utilisateurs, groupes d'utilisateurs et applications spécifiés auront la permission. CustomInherited : Combinaison de Inherited et Custom. Ajoute des utilisateurs, groupes d'utilisateurs et applications supplémentaires à ceux hérités. Everyone : Identique à Allowed dans l'interface. La permission est accordée à tout le monde. Inherited : Hériter la permission du parent Never : Identique à Disallowed dans l'interface. La permission n'est accordée à personne, sauf aux administrateurs

Type: Devolutions.RemoteDesktopManager.SecurityRoleOverride
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PrincipalId

ID des utilisateurs, rôles et applications sans vérifier leur existence. Il est beaucoup plus rapide de procéder avec ce paramètre qu'avec les paramètres User, Role ou Application.

Type: System.Guid[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ID
ParameterSets:
- Name: WithoutExistenceCheck
  Position: 2
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Right

Définit quel droit est modifié

Type: Devolutions.RemoteDesktopManager.SecurityRoleRight
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Role

Rôles (groupes d'utilisateurs) autorisés à accéder au droit. Peuvent être spécifiés par leur nom ou par leur ID.

Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: WithExistenceCheck
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-User

Utilisateurs autorisés à accéder au droit. Peuvent être spécifiés par leur nom ou par leur ID.

Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: WithExistenceCheck
  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'information, voir about_CommonParameters.

Notes

Pour plus d'information, tapez "Get-Help New-DSEntityPermission -detailed". Pour de l'information technique, tapez "Get-Help New-DSEntityPermission -full".