Les méthodes suivantes décrivent comment se connecter à Devolutions Server en utilisant PowerShell.
Méthode 1 : Utilisation des Cmdlets Remote Desktop Manager
Cette nouvelle source de données créée avec PowerShell n'existera que dans le contexte utilisateur dans lequel elle a été créée.
- Suivre les instructions dans Devolutions.PowerShell Core Module pour installer correctement le module.
- Créer une nouvelle source de données Devolutions Server en utilisant une Clé d'Application et Secret d'Application avec le script suivant. Ce script ne devrait être utilisé qu'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<area>://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
- 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 : Utilisation des Cmdlets Devolutions Server
- Suivre les instructions dans Devolutions.PowerShell Core Module pour installer correctement le module.
- Le script suppose que vos identifiants Devolutions Server et URL soient définis dans des variables d'environnement. Puisque stocker des identifiants dans des scripts est déconseillé, adapter un fichier local pour exécuter vos propres tests.
$env:DS_URL= "http<area>://localhost/dvls"
$env:DS_USER = "your_user"
$env:DS_PASSWORD = "your_password"
- Le script d'exemple suivant peut être utilisé pour se connecter en utilisant une Clé d'Application et 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
- Une fois le script terminé et toutes les tâches accomplies, fermer la session en utilisant le cmdlet
Close-DSSession.
Close-DSSession | out-null
Write-Output " "
Write-Output "...Done!"
Write-Output " "