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 supprimé.

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 sont 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 sont 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 est autorisé dans le coffre avant l'exécution. Role1 et Role2 sont 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 sont autorisés dans le coffre avant l'exécution. Role1 et Role3 sont autorisés dans le coffre après la commande. Role2 perd son accès en raison de la présence de l'indicateur de mise à jour.

Paramètres

-AllowedRolesList

Accepte un tableau de chaînes contenant des noms d'utilisateurs (non des identifiants) à 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, de nombreuses cmdlets DS retournaient un objet ServerResponse. L'activation de ce commutateur de compatibilité descendante permet aux scripts développés pour des 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

Met à jour les utilisateurs actuels au lieu de les remplacer.

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

Identifiant 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 cmdlet 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".