Skip to content

Sets Win 10 Services based on Black Viper's Service Configurations

License

Notifications You must be signed in to change notification settings

madbomb122/BlackViperScript

Repository files navigation

NOTICES

  1. BlackViper is no longer releasing service configurations and His Service Configuration is now Public Domain.

Thank you

Donate GitHub Release GitHub Release Date GitHub Issues

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

  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
-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 @ madbomb122@gmail.com.
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