Set-DSVaultRole

Übersicht

Legt die zugelassenen Benutzergruppen für einen bestimmten Tresor fest.

Syntax

__AllParameterSets

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

Beschreibung

Legt fest, welche Benutzer Zugriff auf einen bestimmten Tresor haben. Wenn das Flag "Update" vorhanden ist und ein angegebener Benutzername bereits Mitglied des Tresors ist, wird dieser Benutzer entfernt.

Beispiele

Beispiel 1

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

Vor der Ausführung ist keine Rolle im Tresor zugelassen. Nach dem Befehl sind Role1 und Role2 im Tresor zugelassen.

Beispiel 2

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

Vor der Ausführung sind Role1 und Role2 im Tresor zugelassen. Nach dem Befehl ist Role3 die einzige im Tresor zugelassene Rolle.

Beispiel 3

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

Vor der Ausführung ist User1 im Tresor zugelassen. Nach dem Befehl sind Role1 und Role2 im Tresor zugelassen. Das Update-Flag behält die vorherigen Benutzer bei.

Beispiel 4

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

Vor der Ausführung sind Role1 und Role2 im Tresor zugelassen. Nach dem Befehl sind Role1 und Role3 im Tresor zugelassen. Role2 verliert den Zugriff aufgrund des Vorhandenseins des Update-Flags.

Parameter

-AllowedRolesList

Akzeptiert ein Array von Zeichenfolgen mit Benutzernamen (nicht IDs), die im Tresor zugelassen werden sollen

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

In Versionen vor 2024.2 gaben viele DS-Cmdlets ein ServerResponse-Objekt zurück. Die Aktivierung dieses Schalters für Rückwärtskompatibilität ermöglicht, dass für frühere Versionen entwickelte Skripte korrekt funktionieren.

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

Aktualisiert die aktuellen Benutzer, anstatt sie zu überschreiben.

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 des zu aktualisierenden Tresors

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

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Hinweise

Weitere Informationen erhalten Sie durch die Eingabe von "Get-Help Set-DSVaultRole -detailed". Für technische Informationen geben Sie "Get-Help Set-DSVaultRole -full" ein.