Commandes PowerShell

Cette rubrique concerne toutes les commandes d'authentification et les manipulations pour PSHubContext.

Le module Devolutions.PowerShell doit être installé pour utiliser ces commandes.

Des autorisations adéquates sont également requises pour exécuter certaines de ces commandes. Veuillez vous référer aux utilisateurs de l'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 applets de commande Devolutions Hub.

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

  • Nom : Nom de l'utilisateur de l'application

  • URL : URL Devolutions Hub Business

  • Secret de l'application : Secret de l'application donné après la création de l'utilisateur de l'application

  • Clé d'application : Clé d'application donnée après la création de l'utilisateur de l'application.

* To check all available commands: ```powershell Get-Command-Module ``` * To check all potential arguments and parameters set for a command: ```powershell Show-Command ```

Connexion

Connect-HubAccount

Arguments

  • PSHubContext

ou

  • Url

  • ApplicationKey

  • ApplicationSecre

Description

Si PSHubContext est fourni, essayer de se connecter à Devolutions Hub avec.

ou

Si PSHubContext n'est pas fourni, créer un PSHubContext avec les informations reçues et tenter 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://windjammer.devolutions.xyz"}
Connect-HubAccount -PSHubContext $PSHubContext
Connect-HubAccount -Url https://windjammer.devolutions.xyz -ApplicationKey "24526a88-7f18-4356-95bd-11690f7bc59b;468ce2d5-ea4b-42ff-bc02-d93c71b4e554" -ApplicationSecret U4nmdOjqPAcL0GfbvNC2u8e0FCZjhEJFTnn6YHpIZDY=

ou

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

Disconnect-HubAccount

Arguments

  • ApplicationKey

ou

  • Tous

Description

Si ApplicationKey est fourni, déconnecter et supprimer PSHubContext de la session PowerShell.

ou

Si Tout est fourni, déconnecter et retirer tous les PSHubContext de la session PowerShell.

Contexte

Get-HubContext

Arguments

  • ListAvailable

Description

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

ou

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

Set-HubContext

Arguments

  • PSHubContext

Description

Définir le PSHubContext actuel sur celui fourni.

Select-HubContext

Arguments

  • ApplicationKey

Description

Sélectionner 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

    • Mot de passe

Description

Enregistrer le PSHubContext actuel dans un fichier .json à l'emplacement reçu.

Si PSHubContext est fourni, l'enregistrer dans un fichier .json.

Si Force est fourni, écraser le fichier si le chemin existe déjà.

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

ou

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

Exemple de code

Enregistrer un PSHubContext standard.

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

Pour sécuriser l'enregistrement d'un PSHubContext avec mot de passe, procéder de 2 manières :

Avec un mot de passe passé par arguments.

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

ou

Avec un argument SecurePassword qui invitera à entrer le mot de passe sécurisé.

Save-HubContext -Path “C:\PATH\TO\YOUR\FILE\file.json“ -SecurePassword
Password: [INSERT YOUR PASSWORD]

Import-HubContext

Arguments

  • Chemin

  • SecurePassword

  • Mot de passe

Description

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

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

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

Exemple de code

Importer un contexte PSHub standard.

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

Si vouloir importer un fichier protégé par mot de passe, pouvoir le faire de 2 manières :

Avec un mot de passe passé par arguments.

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

ou

Avec un argument SecurePassword qui invitera à entrer le mot de passe sécurisé.

Import-HubContext -Path “C:\PATH\TO\YOUR\FILE\file.json“ -SecurePassword
Password: [INSERT YOUR PASSWORD]

Paramètres du système

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

Get-HubSystemSettings

Description

Obtenir l'objet PSSystemSettings.

Set-HubSystemSettings

Arguments

  • PSSystemSettings

Description

Définir les paramètres système fournis dans Devolutions Hub.

Exemple de code

Changer 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

  • IdGroupe

  • PSVaultRole | SystemVaultPermission

Description

Ajouter l'autorisation du coffre système fournie aux paramètres du système. Si un utilisateur ou un groupe existe déjà, l'autorisation sera écrasée.

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

ou

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

Exemple de code

$newSystemVaultPermission = [Devolutions.Hub.Clients.VaultPermissionRole]@{ AddEntries = $true }
New-HubSystemVaultPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4 -SystemVaultPermission $newSystemVaultPermission

Remove-HubSystemVaultPermission

Arguments

  • UserId

ou

  • IdGroupe

Description

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

ou

Si GroupId est fourni, supprimer l'autorisation de coffre système de ce groupe des paramètres du système.

Get-HubSystemVaultPermission

Arguments

  • UserId

ou

  • IdGroupe

Description

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

ou

Si GroupId est fourni, récupérer l'autorisation système de ce groupe à partir des paramètres système.

Exemple de code

Obtenir un systemVaultPermission d'un utilisateur pour créer un nouveau 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

  • IdGroupe

  • PSVaultRole | SystemVaultPermissions

Description

Fixer une autorisation de coffre système fournie.

Si UserId est fourni, définir un PSVaultRole prédéfini ou une autorisation de coffre système personnalisée pour cet utilisateur.

ou

Si GroupId est fourni, attribuer un PSVaultRole prédéfini ou une autorisation de coffre système personnalisée à 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

  • PermissionSystème

    • UserId
      ou

    • IdGroupe

Description

Ajouter l'autorisation système fournie aux paramètres système.

Si UserId est fourni, définir l'autorisation système pour cet utilisateur.

ou

Si l'ID de groupe est fourni, définir l'autorisation 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

  • IdGroupe

Description

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

ou

Si GroupId est fourni, retirer cette permission système du groupe des paramètres du système.

Get-HubSystemPermission

Arguments

  • UserId

ou

  • IdGroupe

Description

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

ou

Si GroupId est fourni, récupérer l'autorisation système de ce groupe à partir des paramètres système.

Exemple de code

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

$systemPermissionFromUserA = Get-HubSystemPermission -UserId 2d9221d6-3cbe-4161-b3aa-387f18a7f8c4
New-HubSystemPermission -UserId 152c06cf-cce6-4116-97e1-34aadeab9984 -SystemPermission $systemPermissionFromUserA

Set-HubSystemPermission

Arguments

  • UserId

  • PermissionSystème

ou

  • IdGroupe

  • PermissionSystème

Description

Définir une permission système fournie.

Si UserId est fourni, définir l'autorisation système pour cet utilisateur.

ou

Si l'ID de groupe est fourni, définir l'autorisation 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

Ajouter un nouveau Devolutions Gateway à Devolutions Hub.

Exemple de code

$newDevolutionsGateway = [Devolutions.Hub.CryptoUtilsPowerShell.Entities.ModelsHub.PSDecryptedGateway]@{ PsMetadata = [Devolutions.Hub.PowerShell.CryptoUtilsEntities.ModelsHub.PSGatewayMetadata]@{ Name = 'Test Gateway From PS' }}
New-HubGateway -PSDecryptedGateway $newDevolutionsGateway

Remove-HubGateway

Arguments

  • GatewayId

Description

Supprimer le Devolutions Gateway avec l'ID fourni.

Set-HubGateway

Arguments

  • PsDecryptedGateway

Description

Configurer 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érer le Devolutions Gateway avec l'ID fourni.

New-HubGatewaySettings

Description

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

Set-HubGatewaySettings

Description

Définir les paramètres Devolutions Gateway fournis.

Get-HubGatewaySettings

Description

Récupérer les paramètres de Devolutions Gateway.

Coffres

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

New-HubVault

Arguments

  • VaultName

  • Description du coffre

Description

Ajouter un nouveau coffre.

Exemple de code

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

Remove-HubVault

Arguments

  • VaultId

Description

Supprimer ce coffre de Devolutions Hub.

Get-HubVault

Arguments

  • VaultId

Description

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

Si l'ID du coffre n'est pas fourni, récupérer tous les coffres auxquels vous avez accès.

Set-HubVault

Arguments

  • VaultId

  • PSVault

Description

Définir le coffre fourni sur le VaultId mentionné.

Exemple de code

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

Arguments

  • IDDuCoffre

    • UserId

    • VaultRoleId | VaultPermission

    ou

    • IdGroupe

    • VaultRoleId | VaultPermission

Description

Ajouter l'autorisation de coffre fournie à un coffre spécifique. Si un utilisateur ou un groupe existe déjà, l'autorisation sera écrasée. Si UserId est fourni, définir un rôle PSVault prédéfini ou une autorisation de coffre personnalisée pour cet utilisateur. Si GroupId est fourni, définir un rôle PSVault prédéfini ou une autorisation de coffre personnalisée pour ce groupe.

Exemple de code

Avec une autorisation personnalisée du coffre :

$newVaultPermission = [Devolutions.Hub.Clients.VaultPermissionRole]@{ 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

  • IDDuCoffre

    • UserId

    ou

    • IdGroupe

Description

Si UserId est fourni, retirer la permission de ce coffre d'utilisateur du coffre spécifique.

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

Get-HubVaultPermission

Arguments

  • IDDuCoffre

    • UserId

    ou

    • IdGroupe

Description

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

Exemple de code

Obtenir un vaultPermission d'un utilisateur pour créer un nouveau 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

Arguments

  • IDDuCoffre

    • UserId

    • VaultRoleId | VaultPermission

    ou

    • IdGroupe

    • VaultRoleId | VaultPermission

Description

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

Exemple de code

Avec une autorisation personnalisée du coffre :

$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érer le rôle de coffre par ID.

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

Utilisateurs

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

New-HubUser

Arguments

  • CourrielUtilisateur

  • LocaleUtilisateur

  • Est-ce que le mot de passe temporaire est envoyé par courriel

Description

Ajouter un nouvel utilisateur Devolutions ou inviter 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é.

NouvelUtilisateurOrganisationHub

Arguments

  • Courriel

  • AllowOfflineInRDM

  • Configuration de l'envoi de message utilisateur

ou

  • PSInvitation

Description

Inviter un utilisateur d'une organisation de compte Devolutions définie dans votre hub.

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

  • Si PSInvitation est fourni, permettre de définir manuellement plus d'un courriel et attribuer des groupes. Cette commande fonctionnera uniquement si Activer SSO avec l'organisation de compte Devolutions a été activé dans votre hub et qu'une organisation de compte Devolutions valide a été sélectionnée.

Exemple de code

Ajouter avec une PSInvitation.

$psInvitation = [Devolutions.Hub.PowerShell.CryptoUtilsEntities.ModelsHub.PSInvitation]@{AllowOfflineInRDM = $true; UserSendMessageConfiguration = [Devolutions.Hub.Clients.UserSendMessagePermission]::MessagesWithEntries; Groups = @("1f017956-1d36-4787-acaa-22b16c73cce5"); Emails = @("nathan.lachance@devolutions.net");}
New-HubOrganizationUser -PSInvitation $psInvitation

Remove-HubUser

Arguments

  • UserId

Description

Retirer cet utilisateur de Devolutions Hub.

Get-HubUser

Arguments

  • UserId

Description

Si UserId est fourni, récupérer l'utilisateur par ID.

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

Set-HubUser

Arguments

  • UserId

  • PSUser

Description

Définir l'utilisateur fourni sur l'ID 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

  • IdentifiantsGroupeUtilisateur

Description

Ajouter un nouveau groupe au Hub avec des utilisateurs, si fourni.

Remove-HubGroup

Arguments

  • IdGroupe

Description

Retirer ce groupe du hub.

Get-HubGroup

Arguments

  • IdGroupe

Description

Si l'ID de groupe est fourni, récupérer le groupe par ID.

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

Set-HubGroup

Arguments

  • IdGroupe

  • GroupePS

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

  • IdGroupe

  • UserIds

Description

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

Remove-HubGroupUser

Arguments

  • IdGroupe

  • UserIds

Description

Retirer 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

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

Exemple de code

$t = [Devolutions.Hub.PowerShell.CryptoUtilsEntities.ModelsHub.PSDecryptedEntry]@{ PsMetadata = [Devolutions.Hub.CryptoUtilsPowerShell.Entities.ModelsHub.PSEntryMetadata]@{ Name = "Test Cred"; ParentId = "9df41856-125a-490a-8589-93afc3059924"; ConnectionType = [Devolutions.GeneratedRemoteDesktopManager.Enums.ConnectionType]::Credential }; Connection = [Devolutions.GeneratedRemoteDesktopManager.ModelsBusiness.Connection]@{ Credentials = [Devolutions.GeneratedRemoteDesktopManager.ModelsBusiness.CredentialsConnection]@{ CredentialType = [Devolutions.Generated.EnumsRemoteDesktopManager.CredentialResolverConnectionType]::Default; Password = "passworddepowershell" } } }
New-HubEntry -VaultId d334f44c-fb84-4559-b576-e1e8b68baf65 -PSDecryptedEntry $t

Remove-HubEntry

Arguments

  • VaultId

  • IdEntrée

Description

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

Get-HubEntry

Arguments

  • VaultId

  • IdEntrée

Description

Si EntryId est fourni, récupérer cette entrée d'un coffre spécifique. Si EntryId n'est pas fourni, récupérer toutes les entrées d'un coffre spécifique. Les entrées auront des mots de passe sensibles si vous avez la permission.

Set-HubEntry

Arguments

  • VaultId

  • IdEntrée

  • PSDecryptedEntry

Description

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

Exemple de code

Modifier les informations d'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

Get-HubEntryResolved

Arguments

  • VaultId

  • IdEntrée

  • ResolveSensitives

  • ResolvePasswords

Description

Obtenir l'entrée et résoudre les informations sensibles ou les mots de passe selon les options.

Exemple de code

$entry = Get-HubEntryResolved -VaultID "98b693f6-c77b-434e-a02b-8beed4b7b343" -EntryID "7b4eeb29-e885-4461-aff7-15d2b45b89fb" -ResolveSensitives -ResolvePasswords

Format-HubEntryResolved

Arguments

  • Entrée

  • ResolveSensitives

  • ResolvePasswords

Description

Résoudre les informations sensibles ou les mots de passe d'une entrée déjà déchiffrée.

Exemple de code

$entry = Get-HubEntry -VaultId 3beb6536-95d2-405b-bc69-70751cc55ca1 -EntryId eb3b079e-b763-4657-bfac-ec83998015c1
Format-HubEntryResolved -Entry $entry -ResolvePasswords

New-HubEntryPermission

Arguments

  • VaultId

  • IdEntrée

    • UserId

    • PSEntryRole | EntryPermission

    ou

    • IdGroupe

    • PSEntryRole | EntryPermission

Description

Ajouter une autorisation d'entrée fournie à une entrée spécifique. Si un utilisateur ou un groupe existe déjà, l'autorisation sera écrasée.

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

ou

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

Exemple de code

Avec une autorisation d'entrée personnalisée :

$newEntryPermission = [Devolutions.Hub.Clients.EntryPermissionRole]@{ 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

  • IdEntrée

    • UserId

    ou

    • IdGroupe

Description

Si UserId est fourni, supprimer l'autorisation d'entrée de cet utilisateur d'une entrée spécifique.

ou

Si GroupId est fourni, supprimer l'autorisation d'entrée de ce groupe d'une entrée spécifique.

Get-HubEntryPermission

Arguments

  • VaultId

  • IdEntrée

    • UserId

    ou

    • IdGroupe

Description

Si l'ID d'utilisateur est fourni, récupérer l'autorisation d'entrée de cet utilisateur pour une entrée spécifique.

ou

Si GroupId est fourni, récupérer l'autorisation d'entrée de ce groupe à partir d'une entrée spécifique.

Exemple de code

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

  • IdEntrée

    • UserId

    • PSEntryRole | EntryPermission

    ou

    • IdGroupe

    • PSEntryRole | EntryPermission

Description

Définir une autorisation 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 à cet utilisateur.

ou

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

Exemple de code

Avec une autorisation 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, obtenir le rôle de l'entrée par ID.

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

Get-HubEntriesForExport

Arguments

  • IDDuCoffre

Description

$vaultid = "2d42cac4-3419-494e-aa2a-33b2fdf37a06"
$entries = Get-HubEntriesForExport -VaultId $vaultid
Devolutions Forum logo Donnez-nous vos commentaires