diff --git a/README.md b/README.md index 2edd6c1c..d9075eb2 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,50 @@ +## English + +## Contents + - [Description](#description) + - [Usage](#usage) + - [FAQ](#faq) + - [Supported Windows version](#supported-windows-version) + - [PS](#ps) + +## Description +This PowerShell script is for initial setup after fresh installation of Windows 10 and partially Windows Server 2016/2019. The script is a set of tweaks for fine-tuning the OS and automating the routine tasks. + +## Usage +To run the script: +- Download [up-to-date version](https://github.com/farag2/Setup-Windows-10) as .ps1 file; +- Change encoding to "UTF-8 with BOM" and run it through powershell.exe. + +or + +- Copy the script code and paste it into [PowerShell ISE](https://docs.microsoft.com/ru-ru/powershell/scripting/components/ise/windows-powershell-integrated-scripting-environment--ise-). + +**NB** +- PowerShell and PowerShell ISE must be run with elevated privileges; +- Set PowerShell [execution](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) policy to be able to run .ps1 file. + + +## FAQ +Read the code you run carefully. Some functions are presented as an example only. You must be aware of the meaning of the functions in the code. **If you're not sure what the script does, do not run it.** + +If you're not sure: +- Open new [issue](https://github.com/farag2/Setup-Windows-10/issues); +- Ask a question in [forum](http://forum.ru-board.com/topic.cgi?forum=62&topic=30617); +- [PM](http://forum.ru-board.com/profile.cgi?action=show&member=farag) me. + +The script was written for PowerShell 5.1 and for the current version of Windows 10 Pro x64. Some of its functions can be run also on LTSB/LTSC and on older versions of Windows and PowerShell (also on 32bit systems). + +## Supported Windows version +| Version | Code name | Marketing name | Build | +| :-----: | -------------| ---------------------- | :---: | +| 1903 | 19H1 | May 2019 Update | 18362 | + +## PS +Collection of useful [scripts](https://gist.github.com/farag2) + +  + +## Русский ## Содержание - [Описание](#описание) - [Использование](#использование) @@ -6,28 +53,26 @@ - [PS](#ps) ## Описание - -PowerShell-скрипт предназначен для первоначальной настройки Windows 10 и частично Windows Server 2016/2019. Скрипт представляет собой набор твиков (улучшений) для тонкой настройки ОС и автоматизации рутинных задач по ее настройке. +PowerShell-скрипт предназначен для первоначальной настройки Windows 10 после чистой установки и частично Windows Server 2016/2019. Скрипт представляет из себя набор твиков (улучшений) для тонкой настройки ОС и автоматизации рутинных задач. ## Использование Чтобы запустить скрипт: -- Скачать [актуальную версию](https://github.com/farag2/Setup-Windows-10) в виде файла ps1. -- Изменить кодировку на "UTF-8 с BOM" и запустить через powershell.exe +- Скачать [актуальную версию](https://github.com/farag2/Setup-Windows-10) в виде файла .ps1; +- Изменить кодировку на "UTF-8 с BOM" и запустить через powershell.exe. -  или -  - Скопировать весь текст кода и вставить его в [PowerShell ISE](https://docs.microsoft.com/ru-ru/powershell/scripting/components/ise/windows-powershell-integrated-scripting-environment--ise-). -**PowerShell и PowerShell ISE необходимо запускать с правами Администратора**. +**NB** +- PowerShell и PowerShell ISE необходимо запускать с правами Администратора; +- Установите [политику](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) выполнения PowerShel-скриптов, чтобы иметь возможность запускать файлы .ps1. ## FAQ - -**NB:** Внимательно ознакомьтесь с кодом, который запускаете. Некоторые команды представлены лишь в качестве примера. Вы должно осознавать, какой смысл несут те или иные функции в коде. **Если вы не знаете, что делает код, не исполняете его.** +Внимательно ознакомьтесь с кодом, который запускаете. Некоторые команды представлены лишь в качестве примера. Вы должно осознавать, какой смысл несут те или иные функции в коде. **Если вы не знаете, что делает код, не исполняете его.** Если вы не уверены: -- Создайте новую [Issue](https://github.com/farag2/Setup-Windows-10/issues); +- Создайте новую [issue](https://github.com/farag2/Setup-Windows-10/issues); - Задайте вопрос на [форуме](http://forum.ru-board.com/topic.cgi?forum=62&topic=30617); - Напишите [личное сообщение](http://forum.ru-board.com/profile.cgi?action=show&member=farag).