Descripción general de Devolutions PowerShell

Los productos de Devolutions integran completamente Microsoft PowerShell, lo que ofrece potentes capacidades de scripting y automatización. Puede controlar los propios productos de Devolutions y, a través de Remote Desktop Manager, ejecutar scripts de PowerShell en todo su entorno. Teniendo esto en cuenta, así es como se utiliza PowerShell en la plataforma de Devolutions.

Integración	Finalidad	Referencia
Módulo Devolutions.PowerShell	Este módulo de PowerShell se utiliza para interactuar directamente con los productos de Devolutions.	PowerShell Gallery
Acciones de Remote Desktop Manager	Puede definir un script de PowerShell para ejecutarlo como acción por lotes en uno o varios hosts.	Comandos personalizados de PowerShell Edición por lotes con PowerShell Modificar el origen de un sincronizador
Informes de Remote Desktop Manager	Este tipo de entrada admite la ejecución de un script de PowerShell para generar un informe.	Informe personalizado de PowerShell
Tipos de entradas de Remote Desktop Manager	Tanto el tipo de entrada PowerShell local como PowerShell remoto admiten la ejecución de scripts.
Proveedores de gestión de accesos privilegiados (PAM) y propagación de contraseñas	En Devolutions Server y Devolutions Cloud, PowerShell impulsa los proveedores PAM personalizados y los scripts de propagación de contraseñas.	Proveedor PAM personalizado de Devolutions Server Scripts de propagación de contraseñas PAM de Devolutions Server

Primeros pasos con el módulo Devolutions.PowerShell

El módulo Devolutions.PowerShell requiere PowerShell 7.4 o posterior y es compatible con los sistemas operativos Windows, macOS y Linux.

Windows PowerShell o las versiones anteriores de PowerShell 7 no son compatibles porque el módulo se compila a partir del mismo núcleo que Remote Desktop Manager y, por lo tanto, requiere una versión de PowerShell que utilice una versión compatible del entorno de ejecución .NET (.NET 9).

PowerShell Gallery (recomendado)

El módulo Devolutions.PowerShell está disponible en PowerShell Gallery y es el método de instalación predeterminado recomendado:

Install-Module Devolutions.PowerShell -Force

Dado que PowerShell Gallery suele ser un repositorio marcado como no confiable (los paquetes no se seleccionan ni se revisan), es necesario usar -Force para evitar el mensaje de confirmación.

Cloudsmith

Como alternativa a PowerShell Gallery, ofrecemos un repositorio de Devolutions PowerShell alojado por Cloudsmith.

1. Registre el repositorio de Devolutions PowerShell, que puede marcarse como confiable:

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

2. Desinstale las versiones anteriores del módulo Devolutions.PowerShell instaladas desde PowerShell Gallery:

   Uninstall-Module Devolutions.PowerShell -AllVersions

3. Instale el módulo Devolutions.PowerShell explícitamente desde el repositorio "Devolutions":

   Install-Module Devolutions.PowerShell -Repository Devolutions

4. Confirme que el repositorio de origen de instalación del módulo Devolutions.PowerShell es "Devolutions" y no "PSGallery":

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

Dado que el módulo Devolutions.PowerShell está disponible en más de un repositorio registrado, el parámetro -Repository pasa a ser obligatorio. Sin embargo, si ha marcado el repositorio "Devolutions" como confiable, no es necesario usar -Force para evitar el mensaje de confirmación.

Sin conexión

Si necesita instalar el módulo Devolutions.PowerShell en un sistema con acceso limitado a Internet o sin acceso, puede hacerlo siguiendo estos pasos:

1. Cree un nuevo repositorio de PowerShell llamado "local" en el directorio que elija; en el ejemplo siguiente se utiliza 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. Descargue el fichero .nupkg del módulo Devolutions.PowerShell mediante el botón Download the raw nupkg file que se encuentra en Manual Download en PowerShell Gallery. Copie el fichero .nupkg en el directorio del repositorio local de PowerShell creado anteriormente.
3. Desinstale las versiones anteriores del módulo Devolutions.PowerShell instaladas desde otras fuentes.

   Uninstall-Module Devolutions.PowerShell -AllVersions

4. Instale el módulo Devolutions.PowerShell explícitamente desde el repositorio local.

   Install-Module Devolutions.PowerShell -Repository local

5. Confirme que el origen de instalación del módulo Devolutions.PowerShell es local.

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

Como alternativa, se puede utilizar un directorio en un recurso compartido de red en lugar de un directorio local, lo que facilita la distribución del módulo de PowerShell en una red local.

Ejemplos

Para empezar rápidamente con algunos ejemplos habituales del módulo Devolutions.PowerShell, siga leyendo a continuación.

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'

Desinstalar el módulo Devolutions.PowerShell

Desinstale todas las versiones del módulo Devolutions.PowerShell:

Uninstall-Module Devolutions.PowerShell -AllVersions

Si el módulo se ha instalado a través de Cloudsmith, puede anular el registro del repositorio "Devolutions" de la siguiente manera:

Unregister-PSRepository Devolutions

Por último, si ha instalado el módulo sin conexión, puede anular el registro del repositorio "local" basado en ficheros y eliminar el directorio asociado (el nombre de su directorio puede ser diferente):

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