From ba609699290fc22c868d8e1e19ebbe67c2bfcc74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Doma=C5=84ski?= Date: Thu, 28 May 2026 11:43:39 +0000 Subject: [PATCH] May 28, 2026, 1:43 PM --- toolbox/README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 toolbox/README.md diff --git a/toolbox/README.md b/toolbox/README.md new file mode 100644 index 0000000..dbc25cb --- /dev/null +++ b/toolbox/README.md @@ -0,0 +1,53 @@ +# DBAToolBox - Narzędzie do Zarządzania MS SQL + +DBAToolBox to prosta aplikacja okienkowa (WPF) napisana w PowerShellu, służąca do szybkiego sprawdzania połączenia z serwerami MS SQL Server oraz pobierania podstawowych informacji o instancji. + +## Funkcje + +- **Testowanie połączenia:** Sprawdza dostępność serwera SQL. +- **Informacje o instancji:** Wyświetla wersję, edycję oraz status serwera po udanym połączeniu. +- **Logowanie zdarzeń:** Panel logów wyświetlający przebieg operacji w czasie rzeczywistym. +- **Persystencja ustawień:** Automatycznie zapamiętuje ostatnio używaną nazwę serwera. +- **Interfejs graficzny:** Przejrzysty interfejs zbudowany w technologii WPF. + +## Wymagania + +Aby korzystać z narzędzia, system musi spełniać poniższe wymagania: +1. **PowerShell 5.1 lub nowszy** (w tym PowerShell 7+). +2. **Moduł dbatools:** Aplikacja wykorzystuje ten moduł do komunikacji z SQL Server. + - Instalacja: `Install-Module dbatools -Scope CurrentUser` +3. **Uprawnienia:** Odpowiednie uprawnienia sieciowe i bazodanowe do łączenia się z docelowymi serwerami. + +## Struktura Projektu + +- `DBAToolBox.ps1` - Główny skrypt uruchomieniowy aplikacji. +- `Modules/SQLManager.psm1` - Logika biznesowa i funkcje pomocnicze. +- `UI/MainWindow.xaml` - Definicja interfejsu użytkownika (XAML). +- `Config/settings.json` - Plik konfiguracyjny przechowujący ustawienia użytkownika. + +## Uruchomienie + +1. Otwórz PowerShell w folderze projektu. +2. Uruchom skrypt główny: + ```powershell + .\DBAToolBox.ps1 + ``` + +## Konfiguracja + +Ustawienia są przechowywane w pliku `Config/settings.json`. Obecnie wspierane klucze: +- `LastServer`: Nazwa ostatnio wpisanego serwera. +- `Theme`: Motyw aplikacji (domyślnie "Light"). + +## Rozwiązywanie problemów + +Jeśli aplikacja nie uruchamia się: +1. Upewnij się, że moduł `dbatools` jest zainstalowany. +2. Sprawdź, czy Twoja polityka wykonywania skryptów (Execution Policy) pozwala na uruchamianie lokalnych skryptów: + ```powershell + Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process + ``` + +--- +Autor: Gemini CLI +Data: Maj 2026