Panoramica di Devolutions PowerShell

I prodotti Devolutions integrano completamente Microsoft PowerShell, offrendo potenti funzionalità di scripting e automazione. È possibile controllare i prodotti Devolutions stessi e, tramite Remote Desktop Manager, eseguire script PowerShell in tutto il proprio ambiente. Tenendo presente questo, ecco come viene utilizzato PowerShell nella piattaforma Devolutions.

Integrazione	Scopo	Riferimento
Modulo Devolutions.PowerShell	Questo modulo PowerShell viene utilizzato per interagire direttamente con i prodotti Devolutions.	PowerShell Gallery
Azioni di Remote Desktop Manager	È possibile definire uno script PowerShell da eseguire come azione batch su uno o più host.	Comandi PowerShell personalizzati Modifica batch con PowerShell Modifica dell'origine di un sincronizzatore
Report di Remote Desktop Manager	Questo tipo di voce supporta l'esecuzione di uno script PowerShell per generare un report.	Report PowerShell personalizzato
Tipi di voce di Remote Desktop Manager	Sia il tipo di voce PowerShell locale sia quello PowerShell remoto supportano l'esecuzione di script.
Provider di gestione degli accessi privilegiati (PAM) e propagazione delle password	All'interno di Devolutions Server e Devolutions Cloud, PowerShell alimenta i provider PAM personalizzati e gli script di propagazione delle password.	Provider PAM personalizzato di Devolutions Server Script di propagazione delle password PAM di Devolutions Server

Introduzione al modulo Devolutions.PowerShell

Il modulo Devolutions.PowerShell richiede PowerShell 7.4 o versioni successive ed è supportato sui sistemi operativi Windows, macOS e Linux.

Windows PowerShell o le versioni precedenti di PowerShell 7 non sono supportati perché il modulo è costruito dallo stesso core di Remote Desktop Manager e richiede quindi una versione di PowerShell che utilizzi una versione compatibile del runtime .NET (.NET 9).

PowerShell Gallery (consigliato)

Il modulo Devolutions.PowerShell è disponibile in PowerShell Gallery ed è il metodo di installazione predefinito consigliato:

Install-Module Devolutions.PowerShell -Force

Poiché PowerShell Gallery è solitamente un repository contrassegnato come non attendibile (i pacchetti non sono curati né revisionati), l'uso di -Force è necessario per evitare la richiesta di conferma.

Cloudsmith

In alternativa a PowerShell Gallery, offriamo un repository Devolutions PowerShell ospitato da Cloudsmith.

1. Registrare il repository Devolutions PowerShell, che può essere contrassegnato come attendibile:

   Register-PSRepository -Name 'Devolutions' -SourceLocation 'https://nuget.cloudsmith.io/devolutions/powershell/v2/' -InstallationPolicy Trusted

2. Disinstallare le versioni precedenti del modulo Devolutions.PowerShell installate da PowerShell Gallery:

   Uninstall-Module Devolutions.PowerShell -AllVersions

3. Installare il modulo Devolutions.PowerShell esplicitamente dal repository "Devolutions":

   Install-Module Devolutions.PowerShell -Repository Devolutions

4. Verificare che il repository di origine dell'installazione del modulo Devolutions.PowerShell sia "Devolutions" e non "PSGallery":

   Get-InstalledModule Devolutions.PowerShell | Select-Object -Property Name, Repository
   
   Name                   Repository
   ----                   ----------
   Devolutions.PowerShell Devolutions

Poiché il modulo Devolutions.PowerShell è disponibile in più di un repository registrato, il parametro -Repository diventa obbligatorio. Tuttavia, se ha contrassegnato il repository "Devolutions" come attendibile, -Force non è necessario per evitare la richiesta di conferma.

Offline

Se deve installare il modulo Devolutions.PowerShell su un sistema con accesso a Internet limitato o assente, può farlo seguendo questi passaggi:

1. Creare un nuovo repository PowerShell denominato "local" nella directory scelta; l'esempio seguente utilizza C:\PSRepo.

   $RepoPath = "C:\PSRepo"
   New-Item -Path $RepoPath -ItemType 'Directory' -Force | Out-Null
   Register-PSRepository -Name 'local' -SourceLocation $RepoPath -PublishLocation $RepoPath -InstallationPolicy Trusted

2. Scarichi il file .nupkg per il modulo Devolutions.PowerShell utilizzando il pulsante Download the raw nupkg file sotto Manual Download in PowerShell Gallery. Copi il file .nupkg nella directory del repository PowerShell locale creata in precedenza.
3. Disinstallare le versioni precedenti del modulo Devolutions.PowerShell installate da altre origini.

   Uninstall-Module Devolutions.PowerShell -AllVersions

4. Installare il modulo Devolutions.PowerShell esplicitamente dal repository local.

   Install-Module Devolutions.PowerShell -Repository local

5. Verificare che l'origine di installazione del modulo Devolutions.PowerShell sia local.

   Get-InstalledModule Devolutions.PowerShell | Select-Object -Property Name, Repository
   
   Name                   Repository
   ----                   ----------
   Devolutions.PowerShell local

In alternativa, è possibile utilizzare una directory su una condivisione di rete anziché una directory locale, facilitando la distribuzione del modulo PowerShell su una rete locale.

Esempi

Per iniziare rapidamente con alcuni esempi comuni del modulo Devolutions.PowerShell, continui a leggere qui sotto.

Remote Desktop Manager

# [Import module]
Import-Module Devolutions.PowerShell

# [Load workspace] Example for a local workspace (SQLite) or SQL Server
$DatasourceLocal = Get-RDMDataSource -Name "Local workspace"; Set-RDMCurrentDataSource $DatasourceLocal

$DatasourceSQL = Get-RDMDataSource -Name "SQL Server"; Set-RDMCurrentDataSource $DatasourceSQL

# [Create vault] Only the SQL Server workspace supports vaults (as do Devolutions Server and Devolutions Cloud)
$Vault = New-RDMRepository -Name 'MyVault' -Description 'My vault description' -SetRepository | Set-RDMCurrentRepository | Update-RDMUI

# [Retrieve vault]
Get-RDMRepository -Name 'MyVault'

# [Create entry] Example to create an RDP and Credential entry
$Entry = New-RDMSession -Host 'MyHost' -Type RDPConfigured -Name 'MyHost'; Set-RDMSession -Session $Entry -Refresh; Update-RDMUI

$Entry = New-RDMSession -Name 'MyCredential' -Type Credential; $Entry.Credentials.Username = 'Administrator'; Set-RDMSession $Entry -Refresh; Set-RDMSessionPassword -ID $Entry.ID -Password (ConvertTo-SecureString 'Test123$' -AsPlainText -Force)

# [Retrieve entries]
Get-RDMSession -GroupName 'MyFolder' -Name 'MyHost'

# [Update entry]
$Entry = Get-RDMSession -Name 'MyHost'; $Entry.Name = 'MyUpdatedHost'; Set-RDMSEssion $Entry | Update-RDMUI

# [Export entries]
$Entries = Get-RDMSession; $Entries | Select-Object * | Export-CSV 'C:\Export\FileName.csv' -NoTypeInformation

# [Remove entry]
Get-RDMSession -Name 'MyUpdatedHost' | Remove-RDMSession; Update-RDMUI

Devolutions Server

# [Import module]
Import-Module Devolutions.PowerShell

# [Load workspace]
New-DSSession -Credential (Get-Credential) -BaseURI 'https://MyServer/devolutions-server/'

# [Create vault]
$Vault = New-DSVault -Name 'MyVault' -Description 'My vault description'

# [Retrieve vault]
Get-DSVault -All | Where-Object DisplayName -EQ 'MyVault'

# [Create entry]
New-DSRDPEntry -Name 'MyHost' -HostName 'MyHost' -Username 'Administrator' -Password 'Test123$' -Domain 'MyDomain' -VaultID 'VaultGUID'

New-DSCredentialEntry -Name 'MyCredential' -Username 'Administrator' -Password 'Test123$' -Domain 'MyDomain' -VaultID 'VaultGUID'

# [Retrieve entries]
Get-DSEntry -FilterBy 'Name' -FilterMatch 'StartsWith' -FilterValue 'MyHost' -SearchAllVaults

# [Update entry]
$Entry = Get-DSEntry -EntryId 'EntryGUID'; $Entry.Name = 'MyUpdatedHost'; Update-DSEntryBase -JsonBody (ConvertTo-JSON -InputObject $Entry -Depth 10)

# [Export entries]
$Entries = Get-DSEntry -SearchAllVaults; $Entries | Select-Object * | Export-CSV 'C:\Export\FileName.csv' -NoTypeInformation

# [Remove entry]
Remove-DSEntry -EntryID 'EntryGUID'

Devolutions Cloud

# [Import module]
Import-Module Devolutions.PowerShell

# [Load workspace]
Connect-HubAccount -Url 'https://mycloud.devolutions.app' -ApplicationKey 'ApplicationKey' -ApplicationSecret 'ApplicationSecret'

# [Create vault]
$Vault = New-HubVault -VaultName 'MyVault' -VaultDescription 'My vault description'

# [Retrieve vault]
Get-HubVault

# [Create entry]
$Entry = [Devolutions.Hub.PowerShell.Entities.Hub.PSDecryptedEntry]@{
    PsMetadata = [Devolutions.Hub.PowerShell.Entities.Hub.PSEntryMetadata]@{
        Name = 'MyHost'
        ConnectionType = [Devolutions.RemoteDesktopManager.ConnectionType]::Credential
    }
    Connection = [Devolutions.RemoteDesktopManager.Business.Connection]@{
        Credentials = [Devolutions.RemoteDesktopManager.Business.CredentialsConnection]@{
            CredentialType = [Devolutions.RemoteDesktopManager.CredentialResolverConnectionType]::Default
            UserName = 'Administrator'
            Password = 'Test123$'
        }
    }
}

New-HubEntry -VaultId 'VaultGUID' -PSDecryptedEntry $Entry

# [Retrieve entries]
Get-HubEntry -VaultId 'VaultGUID' | Where-Object { $PSItem.PSMetaData.Name -EQ 'MyHost' }

# [Update entry]
$Entry = Get-HubEntry -VaultId 'VaultGUID' -EntryId 'EntryGUID'; $Entry.PsMetadata.Name = 'MyUpdatedHost'; Set-HubEntry -VaultId 'VaultGUID' -EntryId $Entry.Entry.ID.Guid -PSDecryptedEntry $Entry

# [Export entries]
$Entries = Get-HubEntry -VaultId 'VaultGUID'; $Entries | Select-Object * | Export-CSV 'C:\Export\FileName.csv' -NoTypeInformation

# [Remove entry]
Remove-HubEntry -VaultId 'VaultGUID' -EntryId 'EntryGUID'

Disinstallazione del modulo Devolutions.PowerShell

Disinstallare tutte le versioni del modulo Devolutions.PowerShell:

Uninstall-Module Devolutions.PowerShell -AllVersions

Se il modulo è installato tramite Cloudsmith, può annullare la registrazione del repository "Devolutions" in questo modo:

Unregister-PSRepository Devolutions

Infine, se ha installato il modulo offline, può annullare la registrazione del repository "local" basato su file ed eliminare la directory associata (il nome della directory potrebbe essere diverso):

Unregister-PSRepository local
Remove-Item "C:\PSRepo" -Recurse -ErrorAction SilentlyContinue