Commandes PowerShell

Cette rubrique concerne toutes les commandes et les arguments pour gérer PSHubContext.

Vous devrez avoir installé le module Devolutions.PowerShell pour utiliser ces commandes.

Des permissions appropriées sont également nécessaires pour exécuter certaines de ces commandes. Veuillez vous référer à Utilisateurs d'application.

PSHubContext est un objet qui spécifie vos informations d'authentification. Vous aurez besoin d'un PSHubContext valide pour vous connecter à votre Devolutions Hub Business. Vous pouvez avoir plusieurs PSHubContext connectés dans votre session PowerShell, mais un seul est utilisé lorsque vous utilisez l'applet de commande Devolutions Hub.

Dans cet objet, vous avez ce qui suit :

  • Nom : Nom de l'utilisateur d'application
  • URL : URL du Devolutions Hub Business
  • Clé secrète d'application : Clé secrète d'application donnée après la création de l'utilisateur d'application
  • Clé de l'application : Clé de l'application donnée après la création de l'utilisateur d'application
  • Pour vérifier toutes les commandes disponibles :
    Get-Command-Module <ModuleName>
  • Pour vérifier tous les arguments et paramètres potentiels pour une commande :
    Show-Command <CommandName>

Connexion

Commande Arguments Description Exemple de code
Connect-HubAccount
  • PSHubContext

    ou

  • Url

  • ApplicationKey

  • ApplicationSecret

Si PSHubContext est fourni, tente de se connecter à Devolutions Hub avec celui-ci.

ou

Si PSHubContext n'est pas fourni, crée un PSHubContext avec les informations reçues et tente de se connecter à Devolutions Hub par la suite.

$PSHubContext = [Devolutions.Hub.PowerShell.Entities.PowerShell.PSHubContext]@{ApplicationKey="24526a88-7f18-4356-95bd-11690f7bc59b;468ce2d5-ea4b-42ff-bc02-d93c71b4e554"; ApplicationSecret="U4nmdOjqPAcL0GfbvNC2u8e0FCZjhEJFTnn6YHpIZDY="; Url="https://<YourPasswordHubUrl>.devolutions.app"}

Connect-HubAccount -PSHubContext $PSHubContext

ou

Connect-HubAccount -Url https://<YourPasswordHubUrl>.devolutions.app -ApplicationKey "24526a88-7f18-4356-95bd-11690f7bc59b;468ce2d5-ea4b-42ff-bc02-d93c71b4e554" -ApplicationSecret U4nmdOjqPAcL0GfbvNC2u8e0FCZjhEJFTnn6YHpIZDY=

Disconnect-HubAccount

  • ApplicationKey

    ou

  • All

Si ApplicationKey est fourni, déconnecte et supprime PSHubContext de la session PowerShell.

ou

Si All est fourni, déconnecte et supprime tous les PSHubContext de la session PowerShell.

Contexte

Commande Arguments Description Exemple de code
Get-HubContext
  • ListAvailable

Si ListAvailable est fourni, répertorie tous les PSHubContext définis dans la session PowerShell.

Si ListAvailable n'est pas fourni, récupère le PSHubContext actuel qui sera utilisé pour toutes les autres commandes Devolutions Hub.

Set-HubContext

  • PSHubContext
Définir le PSHubContext actuel sur celui fourni.

Select-HubContext

  • ApplicationKey
Sélectionner un autre PSHubContext pour modifier le PSHubContext actuel qui sera utilisé pour toutes les commandes Devolutions Hub.

Save-HubContext

  • PSHubContext
  • Path
  • Force
    • SecurePassword

      ou

    • Password

Enregistrer le PSHubContext actuel dans un fichier .json par le chemin d'accès reçu.

Si PSHubContext est fourni, enregistre celui-ci dans un fichier .sjon.

Si Force est fourni, écrase le fichier si le chemin d'accès existe déjà.

Si SecurePassword est fourni, invite l'utilisateur à entrer un mot de passe pour chiffrer le fichier .json.

ou

Si Password est fourni, chiffre le fichier .json avec le mot de passe reçu.

Enregistrer un PSHubContext standard.

Save-HubContext -Path "C:\PATH\TO\YOUR\FILE\file.json

Si vous souhaitez enregistrer en toute sécurité un PSHubContext avec un mot de passe, vous pouvez le faire de 2 manières :

Avec un mot de passe envoyé par argument.

Save-HubContext -Path "C:\PATH\TO\YOUR\FILE\file.json" -Password "password"

ou

Avec l'argument SecurePassword, qui demandera la saisie du mot de passe sécurisé.

Save-HubContext -Path "C:\PATH\TO\YOUR\FILE\file.json" -SecurePassword

Password: [INSERT YOUR PASSWORD]

Import-HubContext

  • Path
  • SecurePassword
  • Password
Importer un PSHubContext à partir d'un fichier .json par le chemin d'accès reçu.

Si SecurePassword est fourni, invite à entrer un mot de passe pour déchiffrer le fichier .json.

Si Password est fourni, déchiffre le fichier .json avec le mot de passe reçu.

Importer un PSHubContext standard.

Import-HubContext -Path "C:\PATH\TO\YOUR\FILE\file.json"

Si vous souhaitez importer un fichier protégé par mot de passe, vous pouvez le faire de 2 manières :

Avec un mot de passe envoyé par argument.

Import-HubContext -Path "C:\PATH\TO\YOUR\FILE\file.json" -Password "password"

ou

Avec l'argument SecurePassword, qui demandera la saisie du mot de passe sécurisé.

Import-HubContext -Path "C:\PATH\TO\YOUR\FILE\file.json" -SecurePassword

Password: [INSERT YOUR PASSWORD]

Paramètres système

Cette section concerne les commandes permettant de gérer les paramètres système.

Commande Arguments Description Exemple de code
Get-HubSystemSettings

Obtient l'objet PSSystemSettings.
Set-HubSystemSettings

  • PSSystemSettings

Définit les paramètres du système fournis à Devolutions Hub.

Modifier certaines informations des paramètres du système et enregistrer ces modifications.

$psSystemSettings = Get-HubSystemSettings

$psSystemSettings.ForceTwoFactorAuthentication = $true

$psSystemSettings.ExtendedSessionLifespan = “SevenDays“

$psSystemSettings.SystemPermissions.Users[“33a0253c-2bbf-43a0-9051-fb6adcb5ac7e“].ManageUsersGroups = $false;

Set-HubSystemSettings -$psSystemSettings $psSystemSettings

New-HubSystemVaultPermission

  • UserId

  • PSVaultRole | SystemVaultPermission

    ou

  • GroupId

  • PSVaultRole | SystemVaultPermission

Ajoute une permission système au coffre fournie aux paramètres du système. Si un utilisateur ou un groupe existe déjà, la permission sera écrasée.

Si UserId est fourni, définit un PSVaultRole prédéfini ou une permission personnalisée du coffre au système pour cet utilisateur.

ou

Si GroupId est fourni, définit un PSVaultRole prédéfini ou une permission personnalisée du coffre au système pour ce groupe.

$newSystemVaultPermission = [Devolutions.Hub.Clients.VaultPermission]@{ AddEntries = $true }

New-HubSystemVaultPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -SystemVaultPermission $newSystemVaultPermission

Remove-HubSystemVaultPermission

  • UserId

    ou

  • GroupId

Si UserID est fourni, supprime la permission du coffre au système de l'utilisateur des paramètres système.

ou

Si GroupId est fourni, supprime la permission du coffre au système de l'utilisateur des paramètres système.

Get-HubSystemVaultPermission

  • UserId

ou

  • GroupId
Si UserId est fourni, récupère la permission coffre du système de l'utilisateur à partir des paramètres du système.

ou

Si GroupId est fourni, récupère la permission coffre de système de ce groupe à partir des paramètres du système.

Récupérer une systemVaultPermission d'un utilisateur pour créer une nouvelle systemVaultPermission avec les mêmes permissions (valeurs).

$systemVaultPermissionFromUserA = Get-HubSystemVaultPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4

New-HubSystemVaultPermission -UserId 152c06cf-cce6-4116-97e1-34aadeab9984 -SystemVaultPermission $systemVaultPermissionFromUserA

Set-HubSystemVaultPermission

  • UserId

  • PSVaultRole | SystemVaultPermissions

    ou

  • GroupId

  • PSVaultRole | SystemVaultPermissions

Définit une permission de coffre système fournie.

Si UserId est fourni, définit un PSVaultRole prédéfini ou une permission personnalisée du coffre au système pour cet utilisateur.

ou

Si GroupId est fourni, définit un PSVaultRole prédéfini ou une permission personnalisée du coffre au système pour ce groupe.

$systemVaultPermission = Get-HubSystemVaultPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4

$systemVaultPermission.ExecuteEntries = $false;

```Set-HubSystemVaultPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -SystemVaultPermission $systemVaultPermission ``

New-HubSystemPermission

  • SystemPermission
    • UserId

      ou

    • GroupId

Ajoute une permission système fournie aux paramètres du système.

Si UserId est fourni, définit la permission système sur cet utilisateur.

ou

Si GroupId est fourni, définit la permission système sur ce groupe.

$newSystemPermission = [Devolutions.Hub.Clients.SystemPermission]@{ AddVaults = $true }

New-HubSystemPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -SystemPermission $newSystemPermission

Remove-HubSystemPermission

  • UserId

    ou

  • GroupId

Si UserId est fourni, supprime la permission système de cet utilisateur des paramètres système.

ou

Si GroupId est fourni, supprime la permission système de ce groupe des paramètres système.

Get-HubSystemPermission

  • UserId

    ou

  • GroupId

Si UserId est fourni, récupère la permission système de l'utilisateur à partir des paramètres système.

ou

Si GroupId est fourni, récupère la permission système de ce groupe à partir des paramètres système.

Récupérer une systemPermission d'un utilisateur pour créer une nouvelle systemPermission avec les mêmes permissions (valeurs).

$systemPermissionFromUserA = Get-HubSystemPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4

New-HubSystemPermission -UserId 152c06cf-cce6-4116-97e1-34aadeab9984 -SystemPermission $systemPermissionFromUserA

Set-HubSystemPermission

  • UserId

  • SystemPermission

    ou

  • GroupId

  • SystemPermission

Définit une permission système fournie.

Si UserId est fourni, définit une permission système pour cet utilisateur.

ou

Si GroupId est fourni, définit une permission système pour ce groupe.

$systemPermission = Get-HubSystemPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4

$systemPermission.ForcePromptLogin = $false;

Set-HubSystemPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -SystemPermission $systemPermission

Devolutions Gateway

Cette section concerne les commandes permettant de gérer Devolutions Gateway.

Commande Arguments Description Exemple de code
New-HubGateway
  • PsDecryptedGateway
Ajoute un nouveau Devolutions Gateway au hub. $newDevolutionsGateway = [Devolutions.Hub.CryptoUtils.Models.PSDecryptedGateway]@{ PsMetadata = [Devolutions.Hub.CryptoUtils.Models.PSGatewayMetadata]@{ Name = 'Test Gateway From PS ' }}

New-HubGateway -PSDecryptedGateway $newDevolutionsGateway

Remove-HubGateway

  • GatewayId
Supprime le Devolutions Gateway avec l'ID fourni.

Set-HubGateway

  • PsDecryptedGateway
Définit le Devolutions Gateway fourni. $psDecrpytedGateway = Get-HubGateway -GatewayId 4c6fb2dc-f7ba-4089-8bc2-b46b3bdcd1d0

$psDecrpytedGateway.PSMetadata.Name = “New Name From PS“

Set-HubGateway -PSDecryptedGateway $psDecrpytedGateway

Get-HubGateway

  • GatewayId
Récupère le Devolutions Gateway avec l'ID fourni.

New-HubGatewaySettings

Crée des nouveaux paramètres Devolutions Gateway. Si des paramètres existent déjà, ils seront écrasés.
Set-HubGatewaySettings Définit les paramètres de Devolutions Gateway fournis.
Get-HubGatewaySettings Récupère les paramètres de Devolutions Gateway.

Coffre

Cette section concerne les commandes permettant de gérer les coffres.

Commande Arguments Description Exemple de code
New-HubVault
  • VaultName
  • VaultDescription
Ajoute un nouveau coffre. Avoir la permission de créer un coffre et de mettre le nom.

Remove-HubVault

  • VaultId
Supprime ce coffre du hub.

Get-HubVault

  • VaultId

Si VaultId est fourni, récupère le coffre par l'ID.

Si VaultId n'est pas fourni, récupère tous les coffres auxquels vous avez accès.

Set-HubVault

  • VaultId
  • PSVault
Définit le coffre fourni sur l'ID du coffre mentionné. Modifier certaines informations sur un coffre et enregistrer ces modifications.

$psVault = Get-HubVault -VaultId 3beb6536-95d2-405b-bc69-70751cc55ca1

$psVault.Name = “New RDP Name“;

$psVault.VaultPermissions.Users[“33a0253c-2bbf-43a0-9051-fb6adcb5ac7e“].ViewPassword = $false;

Set-HubVault -VaultId 3beb6536-95d2-405b-bc69-70751cc55ca1 -PSVault $psVault

New-HubVaultPermission

  • VaultId
    • UserId

    • VaultRoleId | VaultPermission

      ou

    • GroupId

    • VaultRoleId | VaultPermission

Ajoute la permission du coffre fournie à un coffre spécifique. Si un utilisateur ou un groupe existe déjà, la permission sera écrasée.

Si UserId est fourni, définit un PSVaultRole prédéfini ou une permission du coffre personnalisée pour cet utilisateur.

Si GroupId est fourni, définit un PSVaultRole prédéfini ou une permission du coffre personnalisée pour ce groupe.

Avec une vaultPermission personnalisée :

$newVaultPermission = [Devolutions.Hub.Clients.VaultPermission]@{ AddEntries = $true }

New-HubVaultPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -VaultPermission $newVaultPermission

ou

Avec un rôle prédéfini :

New-HubVaultPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -VaultRoleId fde84e48-4662-493b-9de3-e05c708af060

Remove-HubVaultPermission

  • VaultId

    • UserId

    ou

    • GroupId

Si UserId est fourni, supprime la permission du coffre d'utilisateur d'un coffre spécifique.

Si GroupId est fourni, supprime la permission du coffre du groupe d'un coffre spécifique.

Get-HubVaultPermission

  • VaultId
    • UserId

      ou

    • GroupId

Si UserId est fourni, récupère la permission du coffre d'utilisateur à partir d'un coffre spécifique.

Si GroupId est fourni, récupère la permission du coffre du groupe à partir d'un coffre spécifique.

Obtenir une vaultPermission d'un utilisateur pour créer une nouvelle vaultPermission avec les mêmes permissions (valeurs).

$vaultPermissionFromUserA = Get-HubVaultPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4

New-HubVaultPermission -UserId 152c06cf-cce6-4116-97e1-34aadeab9984 -VaultPermission $vaultPermissionFromUserA

Set-HubVaultPermission

  • VaultId
    • UserId

    • VaultRoleId | VaultPermission

      ou

    • GroupId

    • VaultRoleId | VaultPermission

Définit une permission du coffre fournie à un coffre spécifique.

Si UserId est fourni, définit un rôle prédéfini ou une permission du coffre personnalisée pour cet utilisateur.

Si GroupId est fourni, définit un rôle prédéfini ou une permission du coffre personnalisée pour ce groupe.

Avec une vaultPermission personnalisée :

$vaultPermission = Get-HubVaultPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -UserId 152c06cf-cce6-4116-97e1-34aadeab9984

$vaultPermission.ExecuteEntries = $false;

Set-HubVaultPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -UserId 152c06cf-cce6-4116-97e1-34aadeab9984 -VaultPermission $vaultPermission

ou

Avec un rôle prédéfini :

$vaultRole = Get-HubVaultRole -RoleId 1dd2321d-ae0d-41d9-bd2a-ec71cce5b13c

Set-HubVaultPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -GroupId 339d1c22-c01b-47ff-b812-74e34f23991f -PSVaultRole $vaultRole

Get-HubVaultRole

  • RoleId

Si RoleId est fourni, récupère le rôle du coffre par l'ID.

Si RoleId n'est pas fourni, récupère tous les rôles du coffre.

Utilisateur

Cette section concerne les commandes permettant de gérer les utilisateurs.

Commande Arguments Description Exemple de code
New-HubUser
  • UserEmail
  • UserLocale
  • IsTemporaryPasswordSendByEmail
Ajoute un nouvel utilisateur Devolutions ou invite un utilisateur Devolutions existant.

Si IsTemporaryPasswordSendByEmail est fourni, le mot de passe temporaire du nouvel utilisateur Devolutions sera envoyé par courriel. Sinon, le mot de passe temporaire est renvoyé.

New-HubOrganizationUser

  • Email

  • AllowOfflineInRDM

  • UserSendMessageConfiguration

    ou

  • PSInvitation

Invite un utilisateur d'une Organisation du Compte Devolutions définie dans votre hub.

Si Email, AllowOfflineInRDM et UserSendMessageConfiguration sont fournis. Un seul courriel sera envoyé.

Si PSInvitation est fourni, vous pouvez manuellement définir plus d'un courriel et assigner des groupes.

Cette commande fonctionnera seulement si l'option Activer l'authentification unique (SSO) pour l'organisation dans le Compte Devolutions a été activée dans votre hub et qu'une Organisation du Compte Devolutions y a été sélectionnée.

Ajouter avec une PSInvitation.

$psInvitation = [Devolutions.Hub.CryptoUtils.Models.PSInvitation]@{AllowOfflineInRDM = $true; UserSendMessageConfiguration = [Devolutions.Hub.Clients.UserSendMessagePermission]::MessagesWithEntries; Groups = @(“1f017956-1d36-4787-acaa-22b16c73cce5“); Emails = @(“bob@windjammer.co“);}

New-HubOrganizationUser -PSInvitation $psInvitation

Remove-HubUser

  • UserId
Supprime cet utilisateur du hub.

Get-HubUser

  • UserId
Si UserId est fourni, récupère l'utilisateur par ID.

Si UserId n'est pas fourni, récupère tous les utilisateurs.

Set-HubUser

  • UserId
  • PSUser
Définit l'utilisateur fourni sur l'ID utilisateur mentionné. Désactiver un utilisateur et enregistrer.

$psUser = Get-HubUser -UserId 321ec891-5674-4be0-aaf1-0c11a62eaf20

$psUser.IsEnabled = $false

Set-HubVault -VaultId 3beb6536-95d2-405b-bc69-70751cc55ca1 -PSVault $psUser

Groupe

Cette section concerne les commandes pour gérer les groupes.

Commande Arguments Description Exemple de code
New-HubGroup
  • GroupName
  • GroupUserIds
Ajoute un nouveau groupe au Hub avec des utilisateurs, si fourni.

Remove-HubGroup

  • GroupId
Supprime ce groupe du hub.

Get-HubGroup

  • GroupId
Si GroupId est fourni, récupére le groupe par ID.

Si GroupId n'est pas fourni, récupére tous les groupes.

Set-HubGroup

  • GroupId
  • PSGroup
Définit le groupe fourni sur l'ID de groupe reçu. Modifier le nom, ajouter un utilisateur et enregistrer le groupe.

$psGroup = Get-HubGroup -GroupId d41b9475-e00a-4f5b-8f25-4d539639dedd

$psGroup.Name = “New Group Name“

$psGroup.UserIds.Add(“321ec891-5674-4be0-aaf1-0c11a62eaf20“)

Set-HubGroup -GroupId d41b9475-e00a-4f5b-8f25-4d539639dedd -$psGroup $psGroup

Add-HubGroupUser

  • GroupId
  • UserIds
Ajoute un ou des utilisateurs à un groupe spécifique.

Remove-HubGroupUser

  • GroupId
  • UserIds
Supprime un ou des utilisateurs d'un groupe spécifique.

Entrée

Cette section concerne les commandes pour gérer les entrées.

Commande Arguments Description Exemple de code
New-HubEntry
  • VaultId
  • PSDecryptedEntry
  • DocumentPath
Ajoute une nouvelle entrée à un coffre spécifique de Devolutions Hub avec l'entrée PSDecryptedEntry fournie. $t = [Devolutions.Hub.CryptoUtils.Models.PSDecryptedEntry]@{ PsMetadata = [Devolutions.Hub.CryptoUtils.Models.PSEntryMetadata]@{ Name = “Test Cred“; ParentId = “9df41856-125a-490a-8589-93afc3059924“; ConnectionType = [Devolutions.Generated.Enums.ConnectionType]::Credential }; Connection = [Devolutions.Generated.Models.Connection]@{ Credentials = [Devolutions.Generated.Models.CredentialsConnection]@{ CredentialType = [Devolutions.Generated.Enums.CredentialResolverConnectionType]::Default; Password = “passworddepowershell“ } } }

New-HubEntry -VaultId d334f44c-fb84-4559-b576-e1e8b68baf65 -Connection $ff

Remove-HubEntry

  • VaultId
  • EntryId
Supprime cette entrée d'un coffre spécifique.

Get-HubEntry

  • VaultId
  • EntryId
Si EntryId est fourni, récupère cette entrée à partir d'un coffre spécifique.

Si EntryId n'est pas fourni, récupère toutes les entrées d'un coffre spécifique.

Les entrées auront des mots de passe sensibles si vous en avez la permission.

Set-HubEntry

  • VaultId
  • EntryId
  • PSDecryptedEntry
Définit l'entrée PSDecryptedEntry fournie dans le coffre et l'entrée mentionnée.
Modifier certaines informations sur une entrée et enregistrer ces modifications.

$decryptedEntry = Get-HubEntry -VaultId 3beb6536-95d2-405b-bc69-70751cc55ca1 -EntryId eb3b079e-b763-4657-bfac-ec83998015c1

$decryptedEntry.PsMetadata.Name = “New RDP Name“;

$decryptedEntry.Connection.RDP.Password = “new_password“;

Set-HubEntry -VaultId 3beb6536-95d2-405b-bc69-70751cc55ca1 -EntryId eb3b079e-b763-4657-bfac-ec83998015c1 -PSDecryptedEntry $decryptedEntry

New-HubEntryPermission

  • VaultId
  • EntryId
    • UserId

    • PSEntryRole | EntryPermission

      ou

    • GroupId

    • PSEntryRole | EntryPermission

Ajoute la permission de l'entrée fournie à une entrée spécifique. Si un utilisateur ou un groupe existe déjà, la permission sera écrasée.

Si UserId est fourni, définit un rôle prédéfini ou une permission de l'entrée personnalisée pour cet utilisateur.

ou

Si GroupId est fourni, définit un rôle prédéfini ou une permission de l'entrée personnalisée pour ce groupe.

Avec une entryPermission personnalisée :

$newEntryPermission = [Devolutions.Hub.Clients.EntryPermission]@{ EditEntries = $true }

New-HubEntryPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -EntryId cf73b4ea-c1cd-4f53-9b53-f9277a108c56 -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -EntryPermission $newEntryPermission

ou

Avec un rôle prédéfini :

$entryRole = Get-HubEntryRole -RoleId 851f86f6-fe3b-4325-9b22-08c3b797e10c

New-HubEntryPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -EntryId cf73b4ea-c1cd-4f53-9b53-f9277a108c56 -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -PSEntryRole $entryRole

Remove-HubEntryPermission

  • VaultId
  • EntryId
    • UserId

      ou

    • GroupId

Si UserId est fourni, supprime la permission de l'entrée de l'utilisateur de l'entrée spécifique.

Si GroupId est fourni, supprime la permission de l'entrée du groupe de l'entrée spécifique.

Get-HubEntryPermission

  • VaultId
  • EntryId
    • UserId

      ou

    • GroupId

Si UserId est fourni, récupère la permission de l'entrée de l'utilisateur de l'entrée spécifique.

Si GroupId est fourni, récupère la permission de l'entrée du groupe de l'entrée spécifique.

Obtenir une entryPermission d'un utilisateur pour créer une nouvelle entryPermission avec les mêmes permissions (valeurs).

$entryPermissionFromUserA = Get-HubEntryPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -EntryId cf73b4ea-c1cd-4f53-9b53-f9277a108c56 -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4

New-HubEntryPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -EntryId cf73b4ea-c1cd-4f53-9b53-f9277a108c56 -UserId 152c06cf-cce6-4116-97e1-34aadeab9984 -EntryPermission $entryPermissionFromUserA

Set-HubEntryPermission

  • VaultId
  • EntryId
    • UserId

    • PSEntryRole | EntryPermission

      ou

    • GroupId

    • PSEntryRole | EntryPermission

Définit une permission de l'entrée fournie à une entrée spécifique.

Si UserId est fourni, définit un rôle prédéfini ou une permission de l'entrée personnalisée pour cet utilisateur.

Si GroupId est fourni, définit un rôle prédéfini ou une permission de l'entrée personnalisée pour ce groupe.

Avec une entryPermission personnalisée :

$entryPermission = Get-HubEntryPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -EntryId cf73b4ea-c1cd-4f53-9b53-f9277a108c56 -UserId 152c06cf-cce6-4116-97e1-34aadeab9984

$entryPermission.ViewPassword = $false;

Set-HubEntryPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -EntryId cf73b4ea-c1cd-4f53-9b53-f9277a108c56 -UserId 152c06cf-cce6-4116-97e1-34aadeab9984 -EntryPermission $entryPermission

ou

Avec un rôle prédéfini :

$entryRole = Get-HubEntryRole -RoleId 851f86f6-fe3b-4325-9b22-08c3b797e10c

Set-HubEntryPermission -VaultId 12ac66eb-7caa-4866-b5fd-5bd59c7f657e -EntryId cf73b4ea-c1cd-4f53-9b53-f9277a108c56 -GroupId 339d1c22-c01b-47ff-b812-74e34f23991f -PSEntryRole $entryRole

Get-HubEntryRole

  • RoleId
Si RoleId est fourni, récupère le rôle de l'entrée par l'ID.

Si RoleId n'est pas fourni, récupère tous les rôles de l'entrée.