Méthodes de connectivité PowerShell à Devolutions Server

Les méthodes suivantes décrivent comment se connecter à Devolutions Server en utilisant PowerShell.

Méthode 1 : Utiliser les Cmdlets de Remote Desktop Manager

1. Suivre les instructions dans le module Devolutions.PowerShell Core pour installer correctement le module.
2. Créer une nouvelle source de données Devolutions Server en utilisant une clé d'application et un secret d'application avec le script suivant. Ce script doit être utilisé une seule fois pour éviter de créer de nombreuses nouvelles sources de données. Remplacer les valeurs des quatre variables par vos propres informations, puis exécuter le script.

$dsname = "DVLS PowerShell"
$dsurl = "https://your_dvls_url"
$appkey = "your_appkey"
$appsecret = "your_appsecret"

$ds = New-RDMDataSource -DVLS -Name $dsname -Server $dsurl -ScriptingTenantID $appkey -ScriptingApplicationPassword $appsecret -SetDatasource -WarningAction SilentlyContinue
Set-RDMDataSource $ds

3. Pour se connecter à la source de données, utiliser ces lignes dans tous vos scripts.

$dsname = "DVLS PowerShell"
$ds = Get-RDMDataSource -Name $dsname
Set-RDMCurrentDataSource $ds

Méthode 2 : Utiliser les applets de commande Devolutions Server

1. Suivre les instructions dans le module Devolutions.PowerShell Core pour installer correctement le module.
2. Le script nécessite une clé d'application et un secret d'application et une URL à définir dans les variables d'environnement. Puisque stocker des identifiants dans les scripts est déconseillé, adapter un fichier local pour exécuter vos propres tests.

$env:DS_URL= "http://localhost/dvls"
$env:DS_USER = "your_appkey"
$env:DS_PASSWORD = "your_appsecret"

3. Le script d'exemple suivant peut être utilisé pour se connecter en utilisant une Clé d'Application et un Secret d'Application.

[string]$Username = $env:DS_USER
[string]$Password = $env:DS_PASSWORD
[string]$DVLSUrl = $env:DS_URL

[securestring]$SecPassword = ConvertTo-SecureString $Password -AsPlainText -Force
[pscredential]$Creds = New-Object System.Management.Automation.PSCredential ($Username, $SecPassword)

$Response = New-DSSession -Credential $Creds -BaseURI $DVLSUrl -AsApplication

4. Une fois le script terminé et toutes les tâches remplies, fermer la session en utilisant l'Close-DSSession cmdlet.

Close-DSSession | out-null
Write-Output " "
Write-Output "...Done!"
Write-Output " "