Skrypty do automatyzacji w WinSCP: wsadowe, PowerShell, .NET

Pytanie

jakie są dodatkowe skrypty do winscp ?

Odpowiedź Sztucznej Inteligencji

Bezpośrednia odpowiedź na pytanie

• WinSCP nie udostępnia „paczki gotowych skryptów” jak wtyczki do przeglądarki. Dodatkową funkcjonalność realizuje się przez:
  • wbudowany silnik skryptów (Batch, PowerShell, .NET) • mechanizm Rozszerzeń (Extensions) – pojedyncze pliki *.wse dodające komendy do menu.
• Oficjalne rozszerzenia obejmują m.in. „Open in PuTTY”, „Unzip remote”, „Zip & download”, „Calculate Checksum” itd.
• WinSCP publikuje też zestaw „Useful Scripts” (szablony automatyzacji), a społeczność udostępnia własne repozytoria (GitHub, forum WinSCP).

Kluczowe punkty

1. Dwa sposoby „dodatkowych skryptów”: Extensions (GUI) i klasyczne skrypty (CLI/PowerShell/.NET).
2. Oficjalna galeria Extensions jest utrzymywana na stronie projektu i aktualizowana wraz z kolejnymi wersjami.
3. Jeśli potrzebujesz konkretnego zadania – generuj kod z GUI lub skorzystaj z gotowych „Useful Scripts”.

Szczegółowa analiza problemu

1. Architektura rozszerzania WinSCP

1.1 Silnik skryptów (WinSCP.com)

• Uruchomienie: winscp.com /script=plik.txt lub /command "open …" "put …" "exit"
• Obsługiwane języki pomocnicze: Batch/CMD, PowerShell, dowolny język zdolny uruchomić proces (Python, PHP, Go).
• Najczęstsze scenariusze: backupy, synchronizacja, deployment firmware, integracja z CI/CD.

1.2 Biblioteka .NET (WinSCPnet.dll)

• Udostępnia pełny model obiektowy – zdarzenia, obsługę wyjątków, transfer z postępem.
• Wykorzystywana w narzędziach DevOps (Azure Pipelines, GitHub Actions przez runner Windows).

1.3 Extensions (pliki .wse)

• Tekstowa deklaracja metadanych + komenda/ skrypt do wykonania.
• Instaluje się z poziomu: Preferencje → Rozszerzenia → Import.
• Rozszerzenie może uruchamiać:
  • komendy WinSCP, PuTTY, Plink, 7-Zip, PowerShell, .NET assembly.

2. Oficjalna galeria Extensions (stan: WinSCP 6.x, IV kw. 2023)

(Pełna, aktualna lista: https://winscp.net/eng/docs/extension_gallery)

3. Useful Scripts – oficjalne szablony

• Emailing script results – wysyła log po zakończeniu zadania.
• Upload to multiple servers – parametryzowany skrypt wysyłający pliki w pętli.
• Cleanup remote directory – kasowanie plików starszych niż N dni.
• Keep remote directory up to date (wersja CLI) – watchdog katalogu.
  Każdy szablon to plik *.txt z komentarzami, gotowy do adaptacji.

4. Przykłady implementacji (wycinki kodu)

• Batch – szybki backup katalogu projektu:

winscp.com /command ^
 "open sftp://user@host/ -privatekey=""id_rsa.ppk""" ^
 "synchronize remote -delete C:\PCB_Designs /home/user/backup" ^
 "exit"

• PowerShell + .NET – upload nowego firmware i restart usługi:

Add-Type -Path "$Env:ProgramFiles\WinSCP\WinSCPnet.dll"
$opt = New-Object WinSCP.SessionOptions -Property @{
  Protocol = 'Sftp'; HostName='192.168.1.50'; UserName='root'
  SshPrivateKeyPath='C:\Keys\id_ed25519.ppk'
  GiveUpSecurityAndAcceptAnySshHostKey=$true
}
$session = New-Object WinSCP.Session
$session.Open($opt)
$session.PutFiles('build\fw.bin','/tmp/fw.bin').Check()
$session.ExecuteCommand('systemctl restart app.service')
$session.Dispose()

Aktualne informacje i trendy

• Od wersji 5.13 (2018) WinSCP posiada zarządcę Extensions; od wersji 6.x obsługuje protokół Amazon S3 i WebDAV, co znacząco poszerza pole zastosowań w chmurze.
• Coraz popularniejsze jest wywoływanie WinSCP w pipeline’ach CI/CD (GitHub Actions, Azure DevOps) zamiast tradycyjnego scp.
• Społeczność publikuje moduły PowerShell (np. PSWinSCP) ułatwiające składnię cmdletową.

Potencjalne przyszłe kierunki:
• rozszerzenia w formacie JSON manifest (ułatwiona dystrybucja),
• natywna wersja CLI dla Linux/WSL (dyskusja na forum projektu),
• wsparcie dla kluczy FIDO2 i post-quantum SSH.

Wspierające wyjaśnienia i detale

• Extension ≠ Script: Extension to „opakowany” skrypt z ikoną, opisem i deklaracją parametrów; pod spodem i tak działa WinSCP CLI lub zewnętrzne narzędzia.
• Skrypty CLI są bezstanowe; wszystkie dane sesji (hasło, klucze) należy przekazać:
  • dynamicznie (zmienne środowiskowe / parametry) lub
  • przez zapisane sesje w pliku konfiguracyjnym /ini.
• Bezpieczeństwo: unikaj twardego wpisywania haseł; preferuj uwierzytelnianie kluczem i skrypt winscp.com /ini=nul (brak zapisu konfiguracji).

Aspekty etyczne i prawne

• Przechowywanie haseł w skryptach narusza zasadę minimizacji danych (RODO/GDPR). Zastosuj Windows Credential Manager lub pliki kluczy z hasłem.
• WinSCP jest licencjonowany na licencji GPL v3 – dowolna automatyzacja jest dozwolona, ale dystrybucja zmodyfikowanego źródła wymaga udostępnienia kodu.
• Szyfruj logi, jeśli zawierają dane osobowe lub wrażliwe konfiguracje urządzeń.

Praktyczne wskazówki

1. Zacznij od „nagrania” operacji w GUI i wygenerowania kodu (Plik → Generator kodów).
2. Testuj skrypty z przełącznikiem -dryrun (symulacja) lub option confirm off/option batch on.
3. Integruj z Harmonogramem Zadań Windows albo systemd timers (w środowisku WSL)-– uruchamiaj pod użytkownikiem o ograniczonych uprawnieniach.
4. Loguj: /log="C:\Logs\winscp-%date%.log" i rotuj pliki (np. PowerShell Get-ChildItem … | Where-Object LastWriteTime…).

Ewentualne zastrzeżenia lub uwagi dodatkowe

• Mechanizm Extensions nie posiada oficjalnego „sklepu” – aktualizacja odbywa się ręcznie lub przez stronę projektu.
• Skrypty uruchamiane z uprawnieniami SYSTEM (np. z Task Scheduler) nie widzą kluczy SSH zapisanych dla aktualnego użytkownika.
• Brak natywnego odzyskiwania z przerwanych połączeń w prostych skryptach; wymaga obsługi wyjątków w PowerShell/.NET.

Sugestie dalszych badań

• Zapoznaj się z pełną dokumentacją Automate file transfers: https://winscp.net/eng/docs/guide_automation
• Przejrzyj kod przykładowy na GitHub: https://github.com/tberta/ps-winscp (PowerShell) i https://github.com/cavo789/tools_winscp.
• Jeśli pracujesz z IoT / embedded, rozważ integrację z balenaCI, GitLab CI z runnerem Windows i WinSCP CLI.
• Eksperymentuj z WinSCP .NET w środowisku PowerShell 7 + C# 10 (record types dla opisów plików).

Krótkie podsumowanie

WinSCP udostępnia dwa główne mechanizmy „dodatkowych skryptów”:

1. Silnik skryptów/WinSCP CLI – pełna, programatyczna automatyzacja transferów (Batch, PowerShell, .NET).
2. Extensions – gotowe, jednoplikowe moduły rozszerzające menu kontekstowe; można je instalować, edytować lub pisać samodzielnie.

Nie ma więc jednej, centralnej biblioteki „skryptów do pobrania”, lecz bogaty ekosystem przykładów, szablonów i rozszerzeń oficjalnych oraz społecznościowych. W praktyce najlepiej: nagraj czynność w GUI → wygeneruj kod → dopasuj → (ew.) zamknij w Extension, jeśli chcesz wygodnie uruchamiać z menu.