updates to readme

Author: PowerShellCrack

README.md

@@ -1,28 +1,33 @@
 # vRAGuestInstaller
 Install guest agent on vRA 7.4/7.5 automatically....sort of
 
-Be sure the read the README.md in the scripts folder
+## REASON
+Each time ther is an issue with deploying a blueprint its always something with the template. For instance, vRA is upgraded or certs have changed and the agents need to be updated. 
+Also each month the templates need to updated with the latest patches. 
 
-# Reason
-Each time I have tempalte issues or we've upgrade vRA or certs have changed we need to update the agents in out Templates. 
-On top of that we also need to update the templates to the latest patches. So I wrote a few batch files to launch on the desktop or in command line. 
+I wrote a few scripts to automate and solve these issues quickly. 
 
-## InstallAgentAsDarwin.bat
+Be sure the read the [README.md](Scripts/README.md) in the scripts folder
+
+## SCRIPTS
+**InstallAgentAsDarwin.bat**
 This script id designed to install the VRA Guest Agent and VRA Appd Agent using the script provide by vRA (with little modification )
- 1. Change the variable in the top section of the script for vRA App, mgr and cert thumbprints
- 2. Copy entire project and subfolder to c: drive. 
+ 1. Change the variables in the top section of the script for vRA App, mgr and cert thumb prints
+ 2. Copy entire project and sub folder to c: drive. 
  3. Right click this InstallAgentAsDarwin.bat and select runas administrator
  4. Type in Darwins password
  5. shutdown when done
 
+### Process: 
 The script prompts in the beginning for the Darwin's password. After that it will auto create the account and ensure no residual account profiles exists (if deleted before).
 It also set the local account to not expire and as a administrator
 If all variables are correct, script will download and install the agents
-After completed, it promtps to be shutdown. If left alone for 30sec, it will auto shutdown
+After completed, it prompts to be shutdown. If left alone for 30sec, it will auto shutdown
 
-## InstallAgentAsSYSTEM.bat
+**InstallAgentAsSYSTEM.bat**
 Does exactly as the Darwin script above does but instead uses the bulletin SYSTEMS account (no password required). Fully automated
 
+##Additions
 In addition to the above script installing the agents, it also copied a vbscript to a scripts folder folder for vRA Guest Agent. This script I wrote to manage local user accounts settings and passwords. Its has a bunch of switches that allow you to automatically add user to admin groups and administer the admin account. This is especially useful during vRA deployment. 
 
 To do this
@@ -37,18 +42,21 @@ VirtualMachine.Software0.ScriptPath = cscript c:\VRMGuestAgent\scripts\UserAndGr
 VirtualMachine.Admin.UseGuestAgent = True
 `
 
- - Use the /admin swithc to configure the admin account name based on what the vm has (eg. newadmin)
+ - Use the /admin switch to configure the admin account name based on what the vm has (eg. newadmin)
  - in the blueprint, add the windows password property, with show in request enabled, to the virtual machine custom properties. 
  - in the blueprint, add the UserAndGroupControl property group to the virtual machine property group section. 
  - in the blueprint, configure the VM so it joins the domain (cloneSpec)
  - Publish and Entitle the blueprint
  - Request the item, and if done correctly the password and security group will be passed during deployment, changing the load admin password and adding the group. 
+ - If you need to debug the UserAndGroupControl vbscript, use the /debug switch. The log is place right next to the script and will display the password in plain text. 
 
 
-## UninstallAgent.bat
+**UninstallAgent.bat**
+ 1. Change the variables in the top section of the script for fqdn and wsus info
 This script will remove the old Agents if they exists and delete their folders. SHould be ran before any other if doing a cleanup
-It will also remove the Darwin account. However since the Darwin account was running as a service, it is considered to be in use even thought the active service has been removed. So there will be a residula folder residing in C:\Users folder. The InstallAgentAsDarwin.bat scritp will clean that up before creating a new Darwin account. 
+It will also remove the Darwin account. However since the Darwin account was running as a service, it is considered to be in use even thought the active service has been removed. So there will be a residual folder residing in C:\Users folder. The InstallAgentAsDarwin.bat script will clean that up before creating a new Darwin account. 
 
-## InstallUpdatesOnly.bat
+**InstallUpdatesOnly.bat**
 this script installs updates from WSUS point. It will also install PowerShell 5.1 on Windows 7, 8 , 8.1, 2012 and 2012r2. Unlike typical scripts where registry key are set. 
-This one use LGPO.exe to build the WSUS pointer locally. I did this so that it can be viewed and changed via gpedit.msc. There are a few prerequisites that must be done. Follow the README.md in the Updates folder
+This one use LGPO.exe to build the WSUS pointer locally. I did this so that it can be viewed and changed via gpedit.msc. There are a few prerequisites that must be done. 
+ - Follow the [README.md](Updates/README.md) in the Updates folder

Updates/README.md

@@ -1,6 +1,9 @@
 # Files needed to Powershell 5.1
-W2K12-KB3191565-x64.msu
-Win7-KB3191566-x86.msu
-Win7AndW2K8R2-KB3191566-x64.msu
-Win8.1-KB3191564-x86.msu
-Win8.1AndW2K12R2-KB3191564-x64.msu
+ - Get updates from: https://docs.microsoft.com/en-us/powershell/wmf/5.1/install-configure
+ 
+## Required update files
+    W2K12-KB3191565-x64.msu
+    Win7-KB3191566-x86.msu
+    Win7AndW2K8R2-KB3191566-x64.msu
+    Win8.1-KB3191564-x86.msu
+    Win8.1AndW2K12R2-KB3191564-x64.msu

scripts/README.md

@@ -1,35 +1,39 @@
 # Extract vRA PowerShell script from appliance for these files:
-`curl.exe
-openssl.exe
-prepare_vra_template.bat
-prepare_vra_template.ps1
-`
+    `
+    curl.exe
+    openssl.exe
+    prepare_vra_template.bat
+    prepare_vra_template.ps1
+    `
 
 Also need LGPO.exe for WSUS policy configurations
+ - https://www.microsoft.com/en-us/download/details.aspx?id=55319
 
 ## Edit PowerShell Script
 To get the PowerShell script to properly submit using Darwin's user-name and password modify these lines in prepare_vra_template.ps1
 
 Line: 549
 From 
 
-	`if ($NonInteractive)`
+    `if ($NonInteractive)`
 
 to
 
-	`
-	if ($NonInteractive -and !$SoftwarePassword)
-	`
+    `
+    if ($NonInteractive -and !$SoftwarePassword)
+    `
 
 The add a second Else statement in betweenthe else around line: 553
 
-	`
-	elseif($SoftwarePassword)
+    `
+    elseif($SoftwarePassword)
     {
         $SecurePassword = $SoftwarePassword | ConvertTo-SecureString -AsPlainText -Force
         $SoftwarePassword = [Runtime.InteropServices.Marshal]::PtrToStringAuto([Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecurePassword))
     }
-	`
+    `
 
-By doing this, you can now use the parameters at the very top of the script  in non-interactive mode. EG: 
+By doing this, you can now use the parameters at the very top of the script  in non-interactive mode. 
+
+eg: 
 `PowerShell.exe -noprofile -executionPolicy bypass -file "prepare_vra_template.ps1" -ApplianceHost vra-app.contoso.com -ManagerServiceHost vra-mgr.contoso.com -CloudProvider vSphere -SoftwareDomainUser .\Darwin -SoftwarePassword DarwinPassword -ManagerFingerprint "D4:2D:C5:BB:96:F0:A2:E1:69:96:12:C1:63:11:73:9B:FA:33:14:F4" -ApplianceFingerprint "D4:2D:C5:BB:96:F0:A2:E1:69:96:12:C1:63:11:73:9B:FA:33:14:F4" -Noninteractive -NoWindowsCheck`