Méthodes de connexion PowerShell à Devolutions Server

Les méthodes suivantes décrivent comment se connecter à Devolutions Server à l'aide de PowerShell.

Méthode 1 : utilisation des cmdlets Remote Desktop Manager

Ce nouvel espace de travail créé avec PowerShell n'existera que dans le contexte de l'utilisateur qui l'a créé.

1. Suivez les instructions du module Devolutions.PowerShell pour installer correctement le module.
2. Créez un nouvel espace de travail Devolutions Server à l'aide d'une clé d'application et d'un secret d'application avec le script suivant. Ce script ne doit être utilisé qu'une seule fois pour éviter la création de nombreux nouveaux espaces de travail. Remplacez les valeurs des quatre variables (lignes 7 à 10) par vos propres informations, puis exécutez le script.

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

# If the workspace doesn't exist, create it.
if ([string]::IsNullOrEmpty($ds))
{
  $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
}

Set-RDMCurrentDataSource $ds

1. Pour vous connecter à l'espace de travail, utilisez ces lignes dans tous vos scripts.

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

Méthode 2 : utilisation des cmdlets Devolutions Server

1. Suivez les instructions du module Devolutions.PowerShell pour installer correctement le module.
2. Le script attend qu'une clé d'application et un secret d'application ainsi qu'une URL soient définis dans des variables d'environnement. Étant donné que le stockage des identifiants dans les scripts est déconseillé, adaptez un fichier local pour exécuter vos propres tests.

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

1. L'exemple de script suivant peut être utilisé pour se connecter à l'aide d'une clé d'application et d'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

1. Une fois le script terminé et toutes les tâches accomplies, fermez la session à l'aide du cmdlet Close-DSSession.

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

Voir aussi

• Gérer les identités d'application