Commandes PowerShell

On this page
Contribute

Ce sujet concerne toutes les commandes d'authentification et les gestionnaires pour PSHubContext.

Le module Devolutions.PowerShell doit être installé 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 les cmdlets Devolutions Hub.

Dans cet objet, vous avez les éléments suivants :

  • Nom : Nom de l'utilisateur d'application
  • URL : URL de Devolutions Hub Business
  • Secret d'application : Secret d'application donné après la création de l'utilisateur d'application
  • Clé d'application : Clé d'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 définis pour une commande :
Show-Command <CommandName>

Connexion

Connect-HubAccount

Arguments

  • PSHubContext

ou

  • Url
  • ApplicationKey
  • ApplicationSecret

Description

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.

Exemple de code

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

Connect-HubAccount -PSHubContext $PSHubContext

ou

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

Disconnect-HubAccount

Arguments

  • ApplicationKey

ou

  • All

Description

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

Get-HubContext

Arguments

  • ListAvailable

Description

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

ou

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

Set-HubContext

Arguments

  • PSHubContext

Description

Définit le PSHubContext actuel à celui fourni.

Select-HubContext

Arguments

  • ApplicationKey

Description

Sélectionne un autre PSHubContext pour changer le PSHubContext actuel qui sera utilisé pour toutes les commandes Devolutions Hub.

Save-HubContext

Arguments

  • PSHubContext

  • Chemin

  • Force

    • SecurePassword

    ou

    • Password

Description

Sauvegarde le PSHubContext actuel dans un fichier .json au chemin reçu.

Si PSHubContext est fourni, le sauvegarde dans un fichier .json.

Si Force est fourni, écrase le fichier si le chemin 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.

Exemple de code

Sauvegarder un PSHubContext standard.

Save-HubContext -Path “C:\CHEMIN\VERS\VOTRE\FICHIER\file.json“

Si vous souhaitez sauvegarder de manière sécurisée un PSHubContext avec un mot de passe, vous pouvez le faire de 2 manières :

Avec un mot de passe passé par arguments.

Save-HubContext -Path “C:\CHEMIN\VERS\VOTRE\FICHIER\file.json“ -Password “password“

ou

Avec un argument SecurePassword qui invitera à la saisie sécurisée du mot de passe.

Save-HubContext -Path “C:\CHEMIN\VERS\VOTRE\FICHIER\file.json“ -SecurePassword

Password: [INSÉRER VOTRE MOT DE PASSE]

Import-HubContext

Arguments

  • Chemin
  • SecurePassword
  • Password

Description

Importe un PSHubContext à partir d'un fichier .json au chemin reçu.

Si SecurePassword est fourni, invite l'utilisateur à 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.

Exemple de code

Importer un PSHubContext standard.

Import-HubContext -Path “C:\CHEMIN\VERS\VOTRE\FICHIER\file.json“

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

Avec un mot de passe passé par arguments.

Import-HubContext -Path “C:\CHEMIN\VERS\VOTRE\FICHIER\file.json“ -Password “password“

ou

Avec un argument SecurePassword qui invitera à la saisie sécurisée du mot de passe.

Import-HubContext -Path “C:\CHEMIN\VERS\VOTRE\FICHIER\file.json“ -SecurePassword

Password: [INSÉRER VOTRE MOT DE PASSE]

Paramètres Système

Cette section concerne les commandes utilisées pour gérer les paramètres système.

Get-HubSystemSettings

Description

Obtient l'objet PSSystemSettings.

Set-HubSystemSettings

Arguments

  • PSSystemSettings

Description

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

Exemple de code

Modifier les informations des paramètres système et sauvegarder 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

Arguments

  • UserId
  • PSVaultRole | SystemVaultPermission

ou

  • GroupId
  • PSVaultRole | SystemVaultPermission

Description

Ajoute la permission système coffre fournie aux paramètres système. 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 système coffre personnalisée pour cet utilisateur.

ou

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

Exemple de code

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

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

Remove-HubSystemVaultPermission

Arguments

  • UserId

ou

  • GroupId

Description

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

ou

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

Get-HubSystemVaultPermission

Arguments

  • UserId

ou

  • GroupId

Description

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

ou

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

Exemple de code

Obtenir 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

Arguments

  • UserId
  • PSVaultRole | SystemVaultPermissions

ou

  • GroupId
  • PSVaultRole | SystemVaultPermissions

Description

Définit une permission système coffre fournie.

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

ou

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

Exemple de code

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

$systemVaultPermission.ExecuteEntries = $false;

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

New-HubSystemPermission

Arguments

  • SystemPermission
    • UserId
      ou
    • GroupId

Description

Ajoute la permission système fournie aux paramètres système

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

ou

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

Exemple de code

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

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

Remove-HubSystemPermission

Arguments

  • UserId

ou

  • GroupId

Description

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

Arguments

  • UserId

ou

  • GroupId

Description

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

ou

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

Exemple de code

Obtenir 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

Arguments

  • UserId
  • SystemPermission

ou

  • GroupId
  • SystemPermission

Description

Définit une permission système fournie.

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

ou

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

Exemple de code

$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 pour gérer Devolutions Gateway.

New-HubGateway

Arguments

  • PsDecryptedGateway

Description

Ajoute un nouveau Devolutions Gateway à Devolutions Hub.

Exemple de code

$newDevolutionsGateway = [Devolutions.Hub.CryptoUtils.Models.PSDecryptedGateway]@{ PsMetadata = [Devolutions.Hub.CryptoUtils.Models.PSGatewayMetadata]@{ Name =  'Test Gateway From PS ' }}

New-HubGateway -PSDecryptedGateway $newDevolutionsGateway

Remove-HubGateway

Arguments

  • GatewayId

Description

Supprime le Devolutions Gateway avec l'ID fourni.

Set-HubGateway

Arguments

  • PsDecryptedGateway

Description

Définit le Devolutions Gateway fourni.

Exemple de code

$psDecrpytedGateway = Get-HubGateway -GatewayId 4c6fb2dc-f7ba-4089-8bc2-b46b3bdcd1d0

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

Set-HubGateway -PSDecryptedGateway $psDecrpytedGateway

Get-HubGateway

Arguments

  • GatewayId

Description

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

New-HubGatewaySettings

Description

Crée de nouveaux paramètres Devolutions Gateway. Si les paramètres existent déjà, ils seront écrasés.

Set-HubGatewaySettings

Description

Définit les paramètres Devolutions Gateway fournis.

Get-HubGatewaySettings

Description

Récupère les paramètres Devolutions Gateway.

Coffres

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

New-HubVault

Arguments

  • VaultName
  • VaultDescription

Description

Ajoute un nouveau coffre.

Exemple de code

Avoir la permission de créer des coffres et mettre un nom.

Remove-HubVault

Arguments

  • VaultId

Description

Supprime ce coffre de Devolutions Hub.

Get-HubVault

Arguments

  • VaultId

Description

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

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

Set-HubVault

Arguments

  • VaultId
  • PSVault

Description

Définit le coffre fourni à l'ID de Vault mentionné.

Exemple de code

Modifier les informations sur un coffre et sauvegarder 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

Arguments

  • VaultID

    • UserId
    • VaultRoleId | VaultPermission

    ou

    • GroupId
    • VaultRoleId | VaultPermission

Description

Ajouter la permission 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éfinir un PSVaultRole prédéfini ou une permission coffre personnalisée pour cet utilisateur. Si GroupId est fourni, définir un PSVaultRole prédéfini ou une permission coffre personnalisée pour ce groupe.

Exemple de code

Avec une permission de coffre 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

Arguments

  • VaultID

    • UserId

    ou

    • GroupId

Description

Si UserId est fourni, supprime la permission coffre de cet utilisateur du coffre spécifique.

Si GroupId est fourni, supprime la permission coffre de ce groupe du coffre spécifique.

Get-HubVaultPermission

Arguments

  • VaultID

    • UserId

    ou

    • GroupId

Description

Si UserId est fourni, récupère la permission coffre de cet utilisateur du coffre spécifique. Si GroupId est fourni, récupère la permission coffre de ce groupe du coffre spécifique.

Exemple de code

Obtenir une permission de coffre d'un utilisateur pour créer une nouvelle permission de coffre 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

Arguments

  • VaultID

    • UserId
    • VaultRoleId | VaultPermission

    ou

    • GroupId
    • VaultRoleId | VaultPermission

Description

Définir une permission coffre fournie à un coffre spécifique. Si UserId est fourni, définir un rôle prédéfini ou une permission coffre personnalisée pour cet utilisateur. Si GroupId est fourni, définir un rôle prédéfini ou une permission coffre personnalisée pour ce groupe.

Exemple de code

Avec une permission de coffre 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

Arguments

  • RoleId

Description

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

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

Utilisateurs

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

New-HubUser

Arguments

  • UserEmail
  • UserLocale
  • IsTemporaryPasswordSendByEmail

Description

Ajoute un nouvel utilisateur Devolutions ou invite un utilisateur Devolutions existant.

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

New-HubOrganizationUser

Arguments

  • Email
  • AllowOfflineInRDM
  • UserSendMessageConfiguration

ou

  • PSInvitation

Description

Inviter un utilisateur d'une Organisation 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 définir manuellement plus d'un courriel et assigner des groupes. Cette commande ne fonctionnera que si Enable SSO with Compte Devolutions Organization a été activé dans votre hub et qu'une Organisation Compte Devolutions valide a été sélectionnée.

Exemple de code

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“);}```
```powershell
New-HubOrganizationUser -PSInvitation $psInvitation

Remove-HubUser

Arguments

  • UserId

Description

Supprime cet utilisateur de Devolutions Hub.

Get-HubUser

Arguments

  • UserId

Description

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

Arguments

  • UserId
  • PSUser

Description

Définir l'utilisateur fourni à l'ID d'utilisateur mentionné.

Exemple de code

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

Groupes

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

New-HubGroup

Arguments

  • GroupName
  • GroupUserIds

Description

Ajoute un nouveau groupe au hub avec des utilisateurs, si fournis.

Remove-HubGroup

Arguments

  • GroupId

Description

Supprime ce groupe du hub.

Get-HubGroup

Arguments

  • GroupId

Description

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

Arguments

  • GroupId
  • PSGroup

Description

Définir le groupe fourni à l'ID de groupe reçu.

Exemple de code

Changer 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

Arguments

  • GroupId
  • UserIds

Description

Ajoute un ou plusieurs utilisateurs à un groupe spécifique.

Remove-HubGroupUser

Arguments

  • GroupId
  • UserIds

Description

Supprime un ou plusieurs utilisateurs d'un groupe spécifique.

Entrées

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

New-HubEntry

Arguments

  • VaultId
  • PSDecryptedEntry
  • DocumentPath

Description

Ajoute une nouvelle entrée à un coffre spécifique du hub avec l'entrée PSDecryptedEntry fournie.

Exemple de code

$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

Arguments

  • VaultId
  • EntryId

Description

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

Get-HubEntry

Arguments

  • VaultId
  • EntryId

Description

Si EntryId est fourni, récupère cette entrée 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ée(s) auront des mots de passe sensibles si vous avez la permission.

Set-HubEntry

Arguments

  • VaultId
  • EntryId
  • PSDecryptedEntry

Description

Définir l'entrée PSDecryptedEntry fournie au coffre et à l'entrée mentionnés.

Exemple de code

Changer les 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

Arguments

  • VaultId

  • EntryId

    • UserId
    • PSEntryRole | EntryPermission

    ou

    • GroupId
    • PSEntryRole | EntryPermission

Description

Ajoute une permission d'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éfinir un rôle prédéfini ou une permission d'entrée personnalisée pour cet utilisateur.

ou

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

Exemple de code

Avec une permission d'entrée 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

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

Arguments

  • VaultId

  • EntryId

    • UserId

    ou

    • GroupId

Description

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

ou

Si GroupId est fourni, supprime la permission d'entrée de ce groupe d'une entrée spécifique.

Get-HubEntryPermission

Arguments

  • VaultId

  • EntryId

    • UserId

    ou

    • GroupId

Description

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

ou

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

Exemple de code

Obtenir une permission d'entrée d'un utilisateur pour créer une nouvelle permission d'entrée 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

Arguments

  • VaultId

  • EntryId

    • UserId
    • PSEntryRole | EntryPermission

    ou

    • GroupId
    • PSEntryRole | EntryPermission

Description

Définir une permission d'entrée fournie à une entrée spécifique.

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

ou

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

Exemple de code

Avec une permission d'entrée 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

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

Arguments

  • RoleId

Description

Si RoleID est fourni, récupère le rôle d'entrée par ID.

Si RoleID n'est pas fourni, récupère tous les rôles d'entrée.

Donnez-nous vos commentaires