Share via

Exchange PowerShell et CmdLet distante

  • Article

Passons en revue les différentes méthodes pour passer des commandes PowerShell à un serveur distant...

 

Méthode 1 : Sans l'environnement Exchange

Pour envoyer rapidement une commande sur un serveur distant, la méthode "Invoke-Command" est simple et rapide à utiliser :

1. Construire la commande dans un environnement PowerShell, elle sera directement exécutée sur le serveur distant spécifié sous l'identité de l'utilisateur qui l'a lancée :

Invoke-Command -ComputerName DISTANT_SERVER

-ScriptBlock {COMMAND_TO_EXECUTE_REMOTELY}

2. Pour aller plus loin et envoyer des variables en paramètre de la commande à injecter, utiliser "ArgumentList" :

 Invoke-command -ComputerName DISTANT_SERVER

-ScriptBlock {COMMAND_TO_EXECUTE_REMOTELY  -Param1 $args[0] -Param2 $args[1]}

-ArgumentList $Var1,$Var2

Dans ce cas, une association est créée entre la liste des arguments récupérés dans "ArgumentList" puis transmis dans le "ScriptBlock" selon leur position dans la liste (1,2,3,4, …) :

" $Var1" correspond ici l'argument numéro 0 nommé " $Args[0] "

" $Var2" correspond ici l'argument numéro 1 nommé " $Args[1] "

Méthode 2 : Avec l'environnement Exchange

La méthode suivante est la plus connue :

1. Enregistrer une paire de Login/Password chiffré dans une variable :

$Creds = Get-Credential

2. Inscrire dans une variable les paramètres d'une session PowerShell contenant ntoamment le FQDN du serveur distant et l'identité à utiliser :

$session = New-PSSession -ConfigurationName Microsoft.Exchange

–ConnectionUri https://EXCHANGE_SERVER_FQDN/powershell

-Credential $Creds

3. Enfin, importer la session distante contenue dans la variable précédente :

Import-PSSession $session

4. Vue d'ensemble :

Méthode 3 : Avec l'environnement Exchange

Pour initialiser un environnement Exchange PowerShell distant rapidement, la CmdLet "CreateOrGetExchangeSession" est elle moins connue. A noter toutefois que cette dernière vient avec l'environnement Exchange PowerShell et qui devient donc un prérequis indispensable localement. Vue détaillée...

1. Lancer une console Exchange PowerShell locale :

2. Construire une session distante :

 

$session = CreateOrGetExchangeSession -FQDN EXCHANGE_SERVER_FQDN

3. Construire la commande à envoyer et l'injecter dans la session : 

Invoke-command -ScriptBlock {COMMAND_TO_EXECUTE_REMOTELY} -Session $Session

 Dans ce dernier exemple, il est aussi possible de passer des paramètres de la même manière qu'expliqué dans la méthode 1.

Méthode 3 bis : Pour aller plus loin avec l'environnement Exchange

Sur la même base que la méthode 3, essayons d'aller encore plus loin  ...

1. Lancer une console Exchange PowerShell locale

2. Construire une session distante :

$session = CreateOrGetExchangeSession -FQDN EXCHANGE_SERVER_FQDN

3. Injecter dans la session un script complet : 

     Invoke-command -ScriptBlock {

Param($Param_1,$Param_2,$Param_3)Function Foo ($Param_Func_1,$Param_Func_2) { Write-host "param 1 is {0}" –f $Param_Func_1 }

        Foo –Param_Func_1 $Param_1}

      -ArgumentList $Var_1,$Var_2 

      -Session $Session

Dans cet exemple, 3 variables de l'environnement local sont transmises dans la session distante : " $Var_1", " $Var_2" et " $Var_3".

Une correspondance directe est faite avec les "Param" transmis à l'intérieur du "ScriptBlock" et donc avec : " $Param_1", " $Param_2" et " $Param_3".

Une fonction "Foo" est transmise dans la session distante, cette dernière s'appuie sur des 2 paramètres " $Param_Func_1" et " $Param_Func_2".

Enfin, la fonction "Foo" est appelée à distance et le paramètre " $Param_1" lui est transmis. Ce paramètre provient donc lui même de la session locale transmis via la variable " $Var_1".

Comments

  • Anonymous
    January 01, 2003
    Great article !
  • Anonymous
    January 01, 2003
    thank you
  • Anonymous
    January 01, 2003
    Nice article