Set-DSVaultRole

Synopsis

Définit les groupes d'utilisateurs autorisés pour un coffre donné.

Syntaxe

__AllParameterSets

Set-DSVaultRole [-VaultID] <guid> [[-AllowedRolesList] <string[]>] [-Update] [-AsLegacyResponse]
 [<CommonParameters>]

Description

Définit quels utilisateurs ont accès à un coffre donné. Si l'indicateur « Update » est présent et qu'un nom d'utilisateur fourni est déjà membre du coffre, cet utilisateur sera retiré.

Exemples

Exemple 1

PS C:\> Set-DSVaultRole -AllowedRolesList @("Role1", "Role2") -VaultID "00000000-0000-0000-0000-000000000000"

Aucun rôle autorisé dans le coffre avant l'exécution. Role1 et Role2 autorisés dans le coffre après la commande.

Exemple 2

PS C:\> Set-DSVaultRole -AllowedRolesList @("Role3") -VaultID "00000000-0000-0000-0000-000000000000"

Role1 et Role2 autorisés dans le coffre avant l'exécution. Role3 est le seul rôle autorisé dans le coffre après la commande.

Exemple 3

PS C:\> Set-DSVaultRole -AllowedRolesList @("Role2") -Update -VaultID "00000000-0000-0000-0000-000000000000"

User1 autorisé dans le coffre avant l'exécution. Role1 et Role2 autorisés dans le coffre après la commande. L'indicateur de mise à jour conserve les utilisateurs précédents.

Exemple 4

PS C:\> Set-DSVaultRole -AllowedRolesList @("User2", "Role3") -Update -VaultID "00000000-0000-0000-0000-000000000000"

Role1 et Role2 autorisés dans le coffre avant l'exécution. Role1 et Role3 autorisés dans le coffre après la commande. Role2 perd son accès à cause de la présence de l'indicateur de mise à jour.

Paramètres

-AllowedRolesList

Accepte un tableau de chaînes contenant les noms d'utilisateur (pas les id) à autoriser dans le coffre

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

-AsLegacyResponse

Dans les versions antérieures à 2024.2, plusieurs applets de commande DS retournaient un objet ServerResponse. L'activation de ce commutateur de compatibilité ascendante permet aux scripts développés pour les versions antérieures de fonctionner correctement.

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

-Update

Mettre à jour les utilisateurs actuels au lieu de les écraser.

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

-VaultID

ID du coffre à mettre à jour

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  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.

Notes

Pour plus d'informations, tapez « Get-Help Set-DSVaultRole -detailed ». Pour des informations techniques, tapez « Get-Help Set-DSVaultRole -full ».