NOTICES
- BlackViper is no longer releasing service configurations and His Service Configuration is now Public Domain.
Thank you
To Download go to -> Black Viper Script -Release
Current Version
Script: 6.2.3 (June 22, 2020)
Service: 5.0 (Febuary 25, 2019) -April 2018 Update
Contents
Description
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 meant 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, and to the people on /r/PowerShell who have helped me solve various things.
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 |
| Min Build | Creator's Update | Pre-Creator's Update |
| Max Build | April 2018 Update | Newer Than this |
Need Files
BlackViper-Win10.ps1 (Script) -Size about 111.0 KB
BlackViper.csv (Service Configurations) -Size about 7.34 KB (Not the same as the one on BlackViper's Website)
Recommended Files
_Win10-BlackViper.bat (To run script easier) -Size about 7.07 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
Note:
AT YOUR OWN RISK
1. Run the script on x86 (32-bit) ,But shows a warning
2. Skip the check for
---A. Home/Pro ($Edition_Check variable in script or use -sec switch)
---B. Min/Max Build ($Build_Check variable in script or use -sbc switch)
How to Use
Download/Save the release file in - Black Viper Script -Release
Note 1: DO NOT RENAME THE FILES
Note 2: HAVE THE FILES IN THE SAME DIRECTORY
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.
https://www.youtube.com/watch?v=AiL4E56t8YI
Video brought to you by Britec09
Usage
Run the Script by bat file _Win10-BlackViper.bat (Recommended)
or
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
Advanced Usage
Use one of the following Methods you can
- Run script or bat file with one (or more) of the switches below
- Edit the script (bottom of file) to change the values
- 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 | |
| -lcsc File.csv | Loads Custom Service Configuration | File.csv Name of backup/custom file, Implies -secp -sbc |
| -all | Every Windows Services in loaded file will change | |
| -min | Just the services different from the default to safe/tweaked list | |
| -sxb | Skips Change to All Xbox Services | |
| -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 |
| -sic | Skips Internet Check (If checking for update) | Tests by pinging GitHub.com |
| -log | Makes a log file using default name Script.log (default) |
Logs Notices, Errors, & Services changed |
| -log File.log | Makes a log file named File.log | Logs Notices, Errors, & Services changed |
| -baf | File of all the services before and after the script | Services-Before.log and Services-After.log |
| -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 |
| -sas | Show Already Set Services | |
| -snis | Shows NOT Installed Services | |
| -sss | Show Skipped Services | |
| -dry | Runs script and shows what will be changed if ran normaly | No Services are changes |
| -css | Change State of Service | From non BlackViper File Only |
| -sds | Stop Disabled Service | |
| -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 Min/Max Build Check | USE AT YOUR OWN RISK |
| -diag | Shows some diagnostic information on error messages | Stops automation |
| -diagf | Forced diagnostic information, Script does nothing else | No Services are changes |
| -devl | Makes a log file with various Diagnostic information | No Services are changes |
| -help | Lists of all the switches, Then exits script | Alt -h |
| -copy | Shows Copyright/License Information, Then exits script |
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 -default
powershell.exe -NoProfile -ExecutionPolicy Bypass -File BlackViper-Win10.ps1 -auto -use -tweaked -secp
_Win10-BlackViper.bat -default
_Win10-BlackViper.bat -auto -use -tweaked -secp
FAQ
Q: When do you update the services file 'BlackViper.csv'?
A: Due to BlackViper no longer releasing service configurations, the 'BlackViper.csv' will no longer be updated unless, it is for a bug fix or someone else releases a good service configuration.
Note: If you find a good configuration please contact me with link (Contact Info is bellow)
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 and the blackviper.csv file the script uses.
Q: I have a suggestion/Issue 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 can I contact you?
A: You can also PM me on reddit or email me
1. reddit /u/madbomb122 https://www.reddit.com/user/madbomb122
2. You can email me @ [email protected].
Note Before contacting me, please make sure you have ALL the needed files and the size is right (Look above under requirements).
Q: Can I run the script on newer/older builds then indicated?
A: Yes/No, you will get a build check error.. It just wont change any new services (if any) and any default services settings changed from will set incorrectly. So to be on the safe side encase you want to revert to the default make a backup of your services with the script.
Q: BLAH isn't working after I used your script.
A: Check over what services were changed and make sure it isn't tied to your issue.
Example WlanSvc is disabled when using safe/tweaked on desktops (but not laptops/tables). This service is needed for wifi on your computer.
Q: Can I use a Backup File(s) on another computer?
A: You can use/load them on another computer, but be careful.
Note I would NOT use the reg file on another computer, since it may not all the same services.
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 or Post an Issue, if you are getting an Edition error when running Home/Pro?
A: Please Provide the information the screen give, 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: 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 program(s) that depends 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..
Note: B = Bat file, S = Service 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 1: Number meaning 0 -Not Installed/Skip, 1 -Disable, 2 -Manual, 3 -Automatic, 4 -Auto (Delayed)
Note 2: Negative Numbers are the same as above but wont be used unless you select it or use the All Setting
Q: How long are you going to maintain the script?
A: I will no long be maintaining this script, I have made a new version of this script with support for win 7 to 11. https://github.com/madbomb122/WinServiceConfigurator