This script has been tested to work on Windows Server/Workstation operating systems that use PowerShell version 4.0 or higher.
This script helps automate and simplify the Guest OS log collection process documented in Veeam KB1789.
Automated collection of Windows-based logs for troubleshooting of Veeam Backup jobs with Application Aware Processing enabled (ie. SQL/Exchange/Active Directory/SharePoint/Oracle).
Local Administrator permissions and permission to execute scripts in an elevated PowerShell console.
- Download the script (Right-click link > 'Save link as') and save it to the Windows machine where logs need to be collected.
- Open an Administrative PowerShell Console, and navigate to the directory where the script was saved.
- (NOTE: Running the script in PowerSell ISE is NOT supported due to the additional modules that PowerShell ISE loads that can conflict with the script's execution.)
- Run the following to execute the script: (Note: PowerShell's Execution Policy is set to RemoteSigned by default on Windows Server machines. This is the reason Unblock-File command is ran prior to calling the script.)
Unblock-File .\Collect-GuestLogs.ps1
.\Collect-GuestLogs.ps1
- While the script runs, the PowerShell console will display information about what's happening during each step of the process.
- Attach the generated .zip file to the Veeam support case.
This script will collect the following information from the machine:
- Collects GuestHelper, GuestIndexer and other logs located in _%ProgramData%\Veeam\Backup_ (or alternate configured directory)
- Collects output of various VSSAdmin commands: Writers/Shadows/ShadowStorage/Providers
- Collects output of SystemInfo.exe
- Collects various registry values (Veeam Backup and Replication, SCHANNEL and System hives specifically) to check for various settings that affect In-Guest Processing
- Checks for Veeam registry values which may have leading or trailing whitespace which would cause them not to work as intended
- Collects list of installed software
- Collects permissions for all SQL users for each database if one or more running SQL instances have been detected
- Collects information about connected volumes
- Collects list of accounts with Local Administrator permissions
- Collects status of Windows Services
- Checks if 'File and Printer Sharing' is enabled/disabled
- Collects Event Viewer logs
- Collects status of Windows Firewall profiles
- Collects settings of attached NICs
- Collects list of installed features/roles
Author: Chris Evans
Should you encounter any issues or bugs in the script, please submit an issue and provide details so it can be looked into further.
THIS SCRIPT IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.