PowerShell Batchfile
Clone or download
Latest commit 4b58d32 Jul 14, 2018


Donate GitHub Release GitHub Release Date GitHub Issues

To Download go to -> Black Viper Script -Release

Current Version
Script: 5.0.7 (July 14, 2018)
Service: 4.0 (May 29, 2018) -April 2018 Update


This script lets you set Windows 10's services based on Black Viper's Service Configurations, your own Service Configuration (If in a proper format), a backup of your Service Configurations made by this script, or a Custom Configuration using the script.

Black Viper's Service Configurations from http://www.blackviper.com/

Note: This Script is ment for Windows 10 Home x64 / Windows 10 Pro x64.. With Creator's Update or newer Installed

PS. Don't forget to check out my other Repo https://github.com/madbomb122/Win10Script

PPS. My Thanks goes out to all that have helped in any way.

Requirements (Make sure to LOOK at this)

Recommended Requirements AT YOUR OWN RISK* (See Note Below)
OS Windows 10
Bit 64-bit (x64) 32-bit (x86)
Edition Pro or Home All Others
Build Creator's Update Pre-Creator's Update

Need Files
BlackViper-Win10.ps1 (Script) -Size about 101.0 KB
BlackViper.csv (Service Configurations) -Size about 6.84 KB (Not the same as the one on BlackViper's Website)

Recommended Files
Update.bat (Script will use to update script if available) -Size about 11.7 KB
_Win10-BlackViper.bat (To run script easier) -Size about 5.49 KB
README.md (This Readme)

You can do a save as on the filenames above to save them to you computer, you cannot do a save as on github's file list

1. Run the script on x86 (32-bit) ,But shows a warning
2. Skip the check for
---A. Home/Pro ($Script:Edition_Check variable in script or use -sec switch)
---B. Creator's Update ($Script:Build_Check variable in script or use -sbc switch)

How to Use/Run

Download/Save the release file in - Black Viper Script -Release
Next follow the Basic Usage or Advanced Usage

Youtube Video

Someone found a Youtube video about my script on how to use it and I thought it might be useful.
Video brought to you by Britec09


Run the Script by bat file _Win10-BlackViper.bat (Recommended)
powershell.exe -NoProfile -ExecutionPolicy Bypass -File c:/BlackViper-Win10.ps1
For the above, Please note you need change the c:/ to the fullpath of your file
Select desired Services Configuration
Select the options you want and then click run script


Use one of the following Methods you can

  1. Run script or bat file with one (or more) of the switches below
  2. Edit the script (bottom of file) to change the values
  3. Edit the bat file (top of file) to change the values to add the switch
Switch Description Notes
-atos Accepts the ToS
-auto Runs the script to be Automated.. Closes on User input, Errors, End of Script) Implies -atos
-default Runs the script with Services to Default Configuration
-safe Runs the script with Services to Black Viper's Safe Configuration
-tweaked Runs the script with Services to Black Viper's Tweaked Configuration
-all Every windows services will change
-min Just the services different from the default to safe/tweaked list
-bscc Backup Current Service Configuration (CSV file) Filename will be COMPUTERNAME-Service-Backup.csv
-bscr Backup Current Service Configuration (REG file) Filename will be COMPUTERNAME-Service-Backup.reg
-bscB Backup Current Service Configuration (CSV and REG file) Filename will be COMPUTERNAME-Service-Backup.FILETYPE
-lcsc File.csv Loads Custom Service Configuration File.csv Name of backup/custom file
-sec Skips Edition Check (Home/Pro), Sets edition as Pro USE AT YOUR OWN RISK
-secp Skips Edition Check (Home/Pro), Sets edition as Pro USE AT YOUR OWN RISK
-sech Skips Edition Check (Home/Pro), Sets edition as Home USE AT YOUR OWN RISK
-sbc Skips Build Check (Creator's Update) USE AT YOUR OWN RISK
-sxb Skips Change to All Xbox Services It keeps current setting
-sic Skips Internet Check (If checking for update) Tests by pinging github.com
-usc Checks for Update to Script file before running Auto downloads and runs if found
-use Checks for Update to Service file before running Auto downloads and uses if found
-snis Shows not installed services (that can be changed)
-sss Show Skipped Services
-diag Shows some diagnostic information on error messages Stops automation
-log Makes a log file (Logs Notices, Errors, & Services changed) Log file Script.log (default)
-baf File of all the services before and after the script Services-Before.log and Services-After.log
-dry Runs script and shows what will be changed if ran normaly No Services are changes
-devl Makes a log file with various Diagnostic information No Services are changes
-help Lists of all the switches Alt -h

Switch Examples:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File BlackViper-Win10.ps1 -lcsc MyComp-Service-Backup.csv
powershell.exe -NoProfile -ExecutionPolicy Bypass -File BlackViper-Win10.ps1 -Set Default
powershell.exe -NoProfile -ExecutionPolicy Bypass -File BlackViper-Win10.ps1 -auto -use -tweaked -sec
_Win10-BlackViper.bat -Set Default
_Win10-BlackViper.bat -auto -use -tweaked -sec


This file is EXACTLY the same as the one in my other Repo

This file will

  1. Allow you to download my Black Viper Script or my Win 10 Script and the needed files (if any).
  2. The script will use to Download updates (to replace the old file, instead of creating a new file, so you dont have to rename the file or edit the bat file). (If this script is present)
Switch Description
-Help Shows the list of switches
-BV Downloads My Black Viper Script
-W10 Downloads My Windows 10 Script
-Both Downloads My Black Viper Script & My Windows 10 Script
-Test Downloads The Test Version of the Script
-Run Run the Script after Downloading (Does not work with -both)
-Bat Download the bat file to run script easier


Q: The script file looks all messy in notepad, How do i view it?
A: Try using wordpad or what I recommend, Notepad++ https://notepad-plus-plus.org/

Q: Do you accept any donations?
A: If you would like to donate to me Please pick an item/giftcard from my amazon wishlist or Contact me about donating, Thanks. BTW The giftcard amount can be changed to a min of $1.
Wishlist: https://www.amazon.com/gp/registry/wishlist/YBAYWBJES5DE/

Q: Are You or Black Viper the developer?
A: Black Viper is the creator of the service configuration. I am the developer of the script, the blackviper.csv file uses black viper's configuration.

Q: How can I contact you?
A: If it's an issue or suggestion please post under issue tab. Otherwise you can email me @ madbomb122@gmail.com. Before contacting me make sure you have ALL the needed files and the size is right (Look above under requirements).

Q: The Run button is disabled what do i do?
A: Look in the script option and skip the appropriate check (Build for Build, Edition for Edition).

Q: The script wont run, can you help me?
A: Yes, but first if you are using automation.. turn off automation and see if it gives and error that you can correct.

Q: Please E-Mail me if you are getting an Edition error when running Home/Pro?
A: E-Mail me what your edition is and what edition it says you are using, so I can add it to the list, Until then use -secp (for Pro) or -sech (for Home), Thanks.

Q: The script window closes or gives an error saying script is blocked, what do i do?
A: By default windows blocks ps1 scripts, you can use one of the following
1. Use the bat file to run the script (recommended)
2. On an admin powershell console Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted

Q: Who do I contact about the Service Configurations or an issue with the configuration?
A: Any "technical" issues (or why something is set one way or another) can be directed to Black Viper himself.

Q: Why does you script not change the service BLAH?
A: You didnt select the All option, it's not a default windows service, cant be changed, or some other good reason.

Q: I have an issue with the script, what do I do?
A: Post it as an issue using github's issues tab up top.

Q: Can I run the script safely?
A: Yes/No, it's safe to change the services back to default. Using the Safe or Tweaked option may cause problems for a program(s) that is depended on one of those services.

Q: Can I run the script repeatedly?
A: Yes, with same or different settings.

Q: I've run the script and it did BLAH, can I undo it?
A: Yes, run the script again and select again or load the backup configuration (if you made one).

Q: Can I use the script or modify it for my / my company's needs?
A: Sure. Just don't forget to include copyright notice as per the license requirements, and leave any Copyright in script too, if you make money from using it please consider a donation as thanks.

Q: The script messed up my computer because it did BLAH.
A: Any problems you have/had is your own problem.

Q: Are you going to add support for other editions of Windows 10 other than Pro or Home?
A: Sorry, I only support the windows 10 configuration listed on Black Viper's website, you can still use it on other edition but any problems you have are your own.

Q: Are you going to add support for builds before the "Creator's Update"?
A: Sorry, since I dont have Black Viper's configuration from before the "Creator's Update" I can't add it. You can use the configuration for Creator's Update, but at your own risk of possible issues.
Note: If you have Black Viper's configuration for pre-Creator's update please contact me, thanks.

Q: Will you make a script for any windows before windows 10?
A: No.

Q: What do the letters mean in the release tab after the version number?
A: The letter indicates that something other than the script was updated when the script version hasn't changed.. B = Bat file, S = Service file, U = Update Bat file, M = Misc or Multiple Changes

Q: Can I download the csv file from Black Viper's website and use that?
A: No, my file is not the same.

Q: Can I add a service to be changed or stop one from changing?
A: Yes, to add/remove edit the file BlackViper.csv or use the gui and uncheck the services you dont want changed
---to remove a service remove the line or put something to change service name, other than symbols (# is fine)
---to add put it in the proper format
Note: Number meaning 0 -Not Installed/Skip, 1 -Disable, 2 -Manual, 3 -Automatic, 4 -Auto (Delayed)

Q: I have a suggestion for the script, how do I suggest it?
A: Do a pull request with the change or submit it as an issue with the suggestion.

Q: How long are you going to maintain the script?
A: No Clue.

Q: When do you update the services file 'BlackViper.csv'?
A: When I get told or see there has been an update to the services. Some updates may take a while if changes in the script it required, like from Window's Big Update Patches.