Improved errors readability and NetworkAdaptersSavePower function

farag2 · Oct 29, 2024 · 614a050 · 614a050
1 parent 0b75297
commit 614a050
Show file tree

Hide file tree

Showing 101 changed files with 1,740 additions and 1,175 deletions.
diff --git a/README.md b/README.md
@@ -92,6 +92,98 @@
 > [!IMPORTANT]
 > Sophia Script for Windows is the largest PowerShell module on `GitHub` for `Windows 10` & `Windows 11` for fine-tuning and automating the routine tasks. It offers more than 150 unique tweaks, and shows how Windows can be configured without making any harm to it.
 
+## How to use
+
+# Windows 11
+
+https://github.com/user-attachments/assets/2654b005-9577-4e56-ac9e-501d3e8a18bd
+
+# Windows 10
+
+https://github.com/user-attachments/assets/f5bda68f-9509-41dc-b3b1-1518aeaee36f
+
+***
+
+* Choose the right script version for your `Windows`;
+* Download [up-to-date version](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest);
+* Expand the archive;
+* Open folder with the expanded archive;
+* Look through the `Sophia.ps1` file to configure functions that you want to be run;
+  * Place the "#" char before function if you don't want it to be run.
+  * Remove the "#" char before function if you want it to be run.
+* Copy the whole path to `Sophia.ps1`
+  * On `Windows 10` press and hold the <kbd>Shift</kbd> key, right click on `Sophia.ps1`, and click on `Copy as path`;
+  * On `Windows 11` right click on `Sophia.ps1` and click on `Copy as path`.
+* Open `Windows PowerShell`
+  * On `Windows 10` click `File` in the File Explorer, hover over `Open Windows PowerShell`, and select `Open Windows PowerShell as Administrator` [(how-to with screenshots)](https://www.howtogeek.com/662611/9-ways-to-open-powershell-in-windows-10/)
+  * On `Windows 11` right-click on the <kbd>Windows</kbd> icon and open `Windows Terminal (Admin)`;
+* Set execution policy to be able to run scripts only in the current PowerShell session;
+
+```powershell
+  Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
+```
+
+* Run `Sophia.ps1`
+  * On `Windows 10` paste copied path to `Sophia.ps1` from the previous step (with [&](https://en.wikipedia.org/wiki/Ampersand));
+
+   ```powershell
+   & <path_from_buffer>
+   ```
+
+  * On `Windows 11`
+
+   ```powershell
+   .\Sophia.ps1
+   ```
+
+## How to download Sophia Script via PowerShell
+
+* Download the always latest Sophia Script archive by invoking (`not as administrator too`) in PowerShell
+
+```powershell
+iwr script.sophia.team -useb | iex
+```
+
+* The command will download and expand the latest Sophia Script archive (`without running`) according which Windows and PowerShell versions it is run on. If you run it on, e.g., Windows 11 via PowerShell 5.1, it will download Sophia Script for `Windows 11 PowerShell 5.1`.
+
+## How to use Wrapper
+
+* Download and expand the archive;
+* Run `SophiaScriptWrapper.exe` and import `Sophia.ps1`;
+  * `Sophia.ps1` has to be in `Sophia Script` folder;
+  * The Wrapper has a real time UI rendering;
+* Configure every function;
+* Open the `Console Output` tab and press `Run PowerShell`.
+
+***
+
+### How to run the specific function(s)
+
+To run the specific function(s) [dot source](https://docs.microsoft.com/ru-ru/powershell/module/microsoft.powershell.core/about/about_operators#dot-sourcing-operator) the `Functions.ps1` file first:
+
+```powershell
+# With a dot at the beginning
+. .\Functions.ps1
+```
+
+* Now you can do like this (the quotation marks required)
+
+```powershell
+Sophia -FunctionsTAB
+Sophia -Functions temp<TAB>
+Sophia -Functions unin<TAB>
+Sophia -Functions uwp<TAB>
+Sophia -Functions "DiagTrackService -Disable", "DiagnosticDataLevel -Minimal", UninstallUWPApps
+
+UninstallUWPApps, "PinToStart -UnpinAll"
+```
+
+Or use an old-style format without the TAB functions autocomplete (the quotation marks required)
+
+```powershell
+.\Sophia.ps1 -Functions CreateRestorePoint, "ScheduledTasks -Disable", "WindowsCapabilities -Uninstall"
+```
+
 ## Before running
 
 > [!CAUTION]
@@ -205,89 +297,6 @@ https://user-images.githubusercontent.com/10544660/253818031-b7ce6bf1-d968-41ea-
 
 [![YT](https://img.youtube.com/vi/8E6OT_QcHaU/1.jpg)](https://youtu.be/8E6OT_QcHaU?t=370) [![YT](https://img.youtube.com/vi/091SOihvx0k/1.jpg)](https://youtu.be/091SOihvx0k?t=490)
 
-## How to use
-
-* Choose the right script version for your `Windows`;
-* Download [up-to-date version](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest);
-* Expand the archive;
-* Open folder with the expanded archive;
-* Look through the `Sophia.ps1` file to configure functions that you want to be run;
-  * Place the "#" char before function if you don't want it to be run.
-  * Remove the "#" char before function if you want it to be run.
-* Copy the whole path to `Sophia.ps1`
-  * On `Windows 10` press and hold the <kbd>Shift</kbd> key, right click on `Sophia.ps1`, and click on `Copy as path`;
-  * On `Windows 11` right click on `Sophia.ps1` and click on `Copy as path`.
-* Open `Windows PowerShell`
-  * On `Windows 10` click `File` in the File Explorer, hover over `Open Windows PowerShell`, and select `Open Windows PowerShell as Administrator` [(how-to with screenshots)](https://www.howtogeek.com/662611/9-ways-to-open-powershell-in-windows-10/)
-  * On `Windows 11` right-click on the <kbd>Windows</kbd> icon and open `Windows Terminal (Admin)`;
-* Set execution policy to be able to run scripts only in the current PowerShell session;
-
-```powershell
-  Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
-```
-
-* Run `Sophia.ps1`
-  * On `Windows 10` paste copied path to `Sophia.ps1` from the previous step (with [&](https://en.wikipedia.org/wiki/Ampersand));
-
-   ```powershell
-   & <path_from_buffer>
-   ```
-
-  * On `Windows 11`
-
-   ```powershell
-   .\Sophia.ps1
-   ```
-
-## How to use Wrapper
-
-* Download and expand the archive;
-* Run `SophiaScriptWrapper.exe` and import `Sophia.ps1`;
-  * `Sophia.ps1` has to be in `Sophia Script` folder;
-  * The Wrapper has a real time UI rendering;
-* Configure every function;
-* Open the `Console Output` tab and press `Run PowerShell`.
-
-***
-
-### How to run the specific function(s)
-
-To run the specific function(s) [dot source](https://docs.microsoft.com/ru-ru/powershell/module/microsoft.powershell.core/about/about_operators#dot-sourcing-operator) the `Functions.ps1` file first:
-
-```powershell
-# With a dot at the beginning
-. .\Functions.ps1
-```
-
-* Now you can do like this (the quotation marks required)
-
-```powershell
-Sophia -FunctionsTAB
-Sophia -Functions temp<TAB>
-Sophia -Functions unin<TAB>
-Sophia -Functions uwp<TAB>
-Sophia -Functions "DiagTrackService -Disable", "DiagnosticDataLevel -Minimal", UninstallUWPApps
-
-UninstallUWPApps, "PinToStart -UnpinAll"
-```
-
-Or use an old-style format without the TAB functions autocomplete (the quotation marks required)
-
-```powershell
-.\Sophia.ps1 -Functions CreateRestorePoint, "ScheduledTasks -Disable", "WindowsCapabilities -Uninstall"
-```
-
-***
-
-## How to download Sophia Script via PowerShell
-
-* Download the always latest Sophia Script archive by invoking (`not as administrator too`) in PowerShell
-
-```powershell
-iwr script.sophia.team -useb | iex
-```
-
-* The command will download and expand the latest Sophia Script archive (`without running`) according which Windows and PowerShell versions it is run on. If you run it on, e.g., Windows 11 via PowerShell 5.1, it will download Sophia Script for `Windows 11 PowerShell 5.1`.
 
 ## How to translate
 

diff --git a/README_de-de.md b/README_de-de.md
@@ -92,6 +92,69 @@
 > [!IMPORTANT]
 > Sophia Script für Windows ist das größte PowerShell-Modul auf `GitHub` für `Windows 10` & `Windows 11` zur Feinabstimmung und Automatisierung von Routineaufgaben. Es bietet mehr als 150 einzigartige Tweaks und zeigt, wie Windows konfiguriert werden kann, ohne Windows dabei zu schaden.
 
+## Verwendung
+
+# Windows 11
+
+https://github.com/user-attachments/assets/2654b005-9577-4e56-ac9e-501d3e8a18bd
+
+# Windows 10
+
+https://github.com/user-attachments/assets/f5bda68f-9509-41dc-b3b1-1518aeaee36f
+
+***
+
+* Wählen Sie die richtige Skriptversion für Ihr "Windows";
+* Download [aktuelle Version](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest);
+* Das Archiv extrahieren;
+* Order mit extrahiertem Archiv öffnen;
+* Schauen Sie sich die Datei `Sophia.ps1` an, um die Funktionen zu konfigurieren, die Sie ausführen möchten;
+  * Setzen Sie das "#"-Zeichen vor die Funktion, wenn Sie nicht möchten, dass sie ausgeführt wird.
+  * Entfernen Sie das "#"-Zeichen vor der Funktion, wenn sie ausgeführt werden soll.
+* Kopieren Sie den gesamten Pfad zu `Sophia.ps1`.
+  * Mit `Windows 10` drücke und halte die <kbd>Shift</kbd> Taste, Rechtsklick auf `Sophia.ps1`, anschließend `als Pfad kopieren` auswählen;
+  * Mit `Windows 11` Rechtsklick auf `Sophia.ps1` und `als Pfad kopieren` auswählen.
+* Öffnen Sie `Windows PowerShell`
+  * Klicken Sie unter `Windows 10` im Datei-Explorer auf "Datei", bewegen Sie den Mauszeiger über "Windows PowerShell öffnen" und wählen Sie "Windows PowerShell als Administrator öffnen" [(Anleitung mit Screenshots)](https://www.howtogeek.com/662611/9-ways-to-open-powershell-in-windows-10/)
+  * Unter `Windows 11` klicken Sie mit der rechten Maustaste auf das Symbol <kbd>Windows</kbd> und "Windows Terminal (Admin)" auswählen;
+* Legen Sie die Ausführungsrichtlinie so fest, dass Skripts nur in der aktuellen PowerShell-Sitzung ausgeführt werden können;
+
+```powershell
+  Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
+```
+
+* Führe `Sophia.ps1` aus
+  * Unter `Windows 11` fügen Sie den kopierten Pfad zu "Sophia.ps1" aus dem vorherigen Schritt ein (mit [&](https://en.wikipedia.org/wiki/Ampersand));
+
+   ```powershell
+   & <path_from_buffer>
+   ```
+
+  * On `Windows 10`
+
+   ```powershell
+   .\Sophia.ps1
+   ```
+
+## Sophia script downloaden mit PowerShell
+
+* Laden Sie das stets aktuelle Sophia-Script-Archiv herunter, indem Sie die PowerShell aufrufen (`auch als nicht-Administrator`)
+
+```powershell
+iwr script.sophia.team -useb | iex
+```
+
+* Der Befehl lädt das neueste Sophia Script-Archiv herunter und extrahiert es (`ohne Ausführung`) entsprechend der Windows- und PowerShell-Version, unter der er ausgeführt wird. Wenn Sie es z. B. unter Windows 11 über PowerShell 5.1 ausführen, wird Sophia Script für `Windows 11 PowerShell 5.1` heruntergeladen.
+
+## Verwendung: Wrapper
+
+* Downloade und extrahiere das Archiv;
+* Führe `SophiaScriptWrapper.exe` aus und importiere `Sophia.ps1`;
+  * `Sophia.ps1`muss im `Sophia Script` Ordner enthalten sein;
+  * Der Wrapper hat ein Echtzeit-UI-Rendering;
+* Konfiguriere jede Funktion;
+* Öffne das `Console Output` Tab und drücke `Run PowerShell`.
+
 ## Vor der Ausführung
 
 > [!CAUTION]
@@ -205,51 +268,6 @@ https://user-images.githubusercontent.com/10544660/253818031-b7ce6bf1-d968-41ea-
 
 [![YT](https://img.youtube.com/vi/8E6OT_QcHaU/1.jpg)](https://youtu.be/8E6OT_QcHaU?t=370) [![YT](https://img.youtube.com/vi/091SOihvx0k/1.jpg)](https://youtu.be/091SOihvx0k?t=490)
 
-## Verwendung
-
-* Wählen Sie die richtige Skriptversion für Ihr "Windows";
-* Download [aktuelle Version](https://github.com/farag2/Sophia-Script-for-Windows/releases/latest);
-* Das Archiv extrahieren;
-* Order mit extrahiertem Archiv öffnen;
-* Schauen Sie sich die Datei `Sophia.ps1` an, um die Funktionen zu konfigurieren, die Sie ausführen möchten;
-  * Setzen Sie das "#"-Zeichen vor die Funktion, wenn Sie nicht möchten, dass sie ausgeführt wird.
-  * Entfernen Sie das "#"-Zeichen vor der Funktion, wenn sie ausgeführt werden soll.
-* Kopieren Sie den gesamten Pfad zu `Sophia.ps1`.
-  * Mit `Windows 10` drücke und halte die <kbd>Shift</kbd> Taste, Rechtsklick auf `Sophia.ps1`, anschließend `als Pfad kopieren` auswählen;
-  * Mit `Windows 11` Rechtsklick auf `Sophia.ps1` und `als Pfad kopieren` auswählen.
-* Öffnen Sie `Windows PowerShell`
-  * Klicken Sie unter `Windows 10` im Datei-Explorer auf "Datei", bewegen Sie den Mauszeiger über "Windows PowerShell öffnen" und wählen Sie "Windows PowerShell als Administrator öffnen" [(Anleitung mit Screenshots)](https://www.howtogeek.com/662611/9-ways-to-open-powershell-in-windows-10/)
-  * Unter `Windows 11` klicken Sie mit der rechten Maustaste auf das Symbol <kbd>Windows</kbd> und "Windows Terminal (Admin)" auswählen;
-* Legen Sie die Ausführungsrichtlinie so fest, dass Skripts nur in der aktuellen PowerShell-Sitzung ausgeführt werden können;
-
-```powershell
-  Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
-```
-
-* Führe `Sophia.ps1` aus
-  * Unter `Windows 11` fügen Sie den kopierten Pfad zu "Sophia.ps1" aus dem vorherigen Schritt ein (mit [&](https://en.wikipedia.org/wiki/Ampersand));
-
-   ```powershell
-   & <path_from_buffer>
-   ```
-
-  * On `Windows 10`
-
-   ```powershell
-   .\Sophia.ps1
-   ```
-
-## Verwendung: Wrapper
-
-* Downloade und extrahiere das Archiv;
-* Führe `SophiaScriptWrapper.exe` aus und importiere `Sophia.ps1`;
-  * `Sophia.ps1`muss im `Sophia Script` Ordner enthalten sein;
-  * Der Wrapper hat ein Echtzeit-UI-Rendering;
-* Konfiguriere jede Funktion;
-* Öffne das `Console Output` Tab und drücke `Run PowerShell`.
-
-***
-
 ### Verwendung von spezifischen Funktionen
 
 Um spezifische Funktionen auszuführen [dot source](https://docs.microsoft.com/ru-ru/powershell/module/microsoft.powershell.core/about/about_operators#dot-sourcing-operator) die `Functions.ps1` datei zuerst:
@@ -279,16 +297,6 @@ Oder verwenden Sie ein Format im alten Stil ohne die TAB-Funktionen zum automati
 
 ***
 
-## Sophia script downloaden mit PowerShell
-
-* Laden Sie das stets aktuelle Sophia-Script-Archiv herunter, indem Sie die PowerShell aufrufen (`auch als nicht-Administrator`)
-
-```powershell
-iwr script.sophia.team -useb | iex
-```
-
-* Der Befehl lädt das neueste Sophia Script-Archiv herunter und extrahiert es (`ohne Ausführung`) entsprechend der Windows- und PowerShell-Version, unter der er ausgeführt wird. Wenn Sie es z. B. unter Windows 11 über PowerShell 5.1 ausführen, wird Sophia Script für `Windows 11 PowerShell 5.1` heruntergeladen.
-
 ## How To: Übersetzen
 
 * Holen Sie sich die Sprache der Benutzeroberfläche Ihres Betriebssystems, indem Sie "$PSUICulture" in PowerShell aufrufen;