Przejdź do głównej zawartości
Wersja: 2023 R3

Uruchom skrypt PowerShell

Akcja może wykonać dowolną komendę Windows PowerShell, a po aktywacji określonych dodatków Powershell (Exchange, Lync, Azure, Sharepoint) każda operacja systemowa, która może być wykonana przez PowerShell, może być również wykonana za pośrednictwem tej akcji.

Przykłady operacji
  • tworzenie nowych katalogów na dysku,
  • tworzenie nowych skrzynek odbiorczych na serwerze Exchange,
  • aktywacja konta Lync,
  • tworzenie kont użytkownika w Office 365,
  • tworzenie nowych witryn SharePoint.

Przygotowanie środowiska​

Aby akcja działała prawidłowo, wymagane jest przygotowanie serwera, na którym skrypty PowerShell będą wykonywane.

Wymagane operacje na serwerze:
Enable-PSRemoting [–Force] – konfiguracja komputera jako odbiorcy komend PowerShell wysyłanych poprzez technologię
„WS-Management”. Szczegółowe informacje: https://technet.microsoft.com/en-us/library/hh849694.aspx
Enable-WSManCredSSP [–RoleServer] – aktywacja uwierzytelnienia „Credential Security Support Provider” (CredSSP). Szczegółowe informacje: https://technet.microsoft.com/en-us/library/hh849872.aspx
Set-PSSessionConfiguration [–Name Microsoft.PowerShell1132] [–showSecurityDescriptorUI] – zmiana konfiguracji sesji na komputerze lokalnym. Szczegółowe informacje: https://technet.microsoft.com/en-us/library/hh849726.aspx

Instalacja​

Uprawnienia użytkownika​

Akcja Uruchom skrypt PowerShell jest wykonywana przez WEBCON BPS Service w kontekście użytkownika, na którym działa serwis.
Aby uruchomić skrypty w kontekście innego użytkownika, należy skorzystać z parametrów Login oraz Hasło dostępnych w konfiguracji akcji, a następnie w skrypcie skorzystać ze zmiennych $username oraz $password, by utworzyć obiekt PSCredential. Obiekt ten może być bezpiecznie używany w poleceniach cmdlet wymagających uwierzytelnienia.

uwaga

Ze względów bezpieczeństwa zaleca się zawsze uruchamiać skrypty w kontekście dedykowanego do tego celu użytkownika, ze ściśle określonymi uprawnieniami.

Podejście, w którym dodatkowych uprawnień wymaganych do prawidłowego działania skryptów udziela się użytkownikowi, w kontekście którego działa WEBCON BPS Service, nie jest zalecane.

Konfiguracja akcji​

Uruchom skrypt PowerShell

1. Dane użytkownika​

Wartości parametrów Login oraz Hasło zostaną przekazane do skryptu PowerShell jako zmienne $username oraz $password. Z tych zmiennych należy skorzystać by uruchamiać polecenia PowerShell w kontekście użytkownika z odpowiednimi uprawnieniami.

2. Szablon​

Pozwala wybrać jeden z domyślnych szablonów, z którego wstawiony zostanie skrypt PowerShell.
Dostępne szablony:

  • Exchange: AddMailbox to existing user,
  • LynOnline: Enable Lync for user,
  • 0365: AddMailbox to existing user.

Wybrany szablon zostanie załadowany po naciśnięciu przycisku Wczytaj.

3. Skrypt PowerShell​

Umożliwia wprowadzenie skryptu, który zostanie wykonany przez akcję. Alternatywnie okno prezentuje całość skryptu PowerShell zaimportowanego z Szablonu, które można następnie edytować. Skrypt może zawierać tagi (wartości dynamiczne) z Edytora zmiennych.

4. Edytor zmiennych​

Dynamicznie zbudowane drzewo wszystkich zmiennych dostępnych w bieżącej lokalizacji Designer Studio. Informacje o tym, jak działają zmienne w WEBCON BPS oraz listę zmiennych można znaleźć tutaj.

wskazówka

Aby użyć zmiennej BPS odnoszącej się do wartości atrybutu, np. {123} wewnątrz bloku, najpierw musi być on przypisany do zmiennej w kodzie.

$attValue = '{123}'
$block = {
$attValue
}