This article describes how to gather information by using the Microsoft Troubleshooting Support Script (TSS) for Hyper-V related issues.
Prerequisites
Refer to Introduction to TroubleShootingScript toolset (TSS) for prerequisites for the toolset to run properly.
Scenario: Virtualization and Hyper-V
TSS cmdlet
.\TSS.ps1 -SDP HyperV
TSS cmdlet description
To gather information for Hyper-V related issues, follow these steps:
-
Download TSS and extract it in the C:\tss folder.
-
Open the C:\tss folder from an elevated PowerShell command prompt.
[!NOTE] Don't use the Windows PowerShell Integrated Scripting Environment (ISE).
-
Run the following cmdlets:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass.\TSS.ps1 -SDP HyperV -
Enter A for "Yes to All" for the execution policy change.
Note:
- The time to collect this script on a given system may vary. It depends on system speed, system size, the number of virtual machines, the amount of data in logs, and so on. Depending on these factors, the average collection time is between 30 and 90 minutes, or even longer, especially if no skip commands are used.
- The collection is stored in a compressed file in the C:\MS_DATA folder. After a support case is created, this file can be uploaded to the secure workspace for analysis.
Optional parameters
You can use the following optional parameters with the TSS tool. These optional parameters can perform a quicker and more streamlined collection, which may help the script finish successfully if a certain section stops responding.
-
This cmdlet skips running the Best Practices Analyzer and makes the collection faster.
.\TSS.ps1 -SDP HyperV -SkipSDPList skipBPA -
This cmdlet skips some small collection items that may fail in a regular collection and makes the script more reliable.
.\TSS.ps1 -SDP HyperV -SkipSDPList skipHang -
This cmdlet skips some additional collection parameters that may not be needed.
.\TSS.ps1 -SDP HyperV -SkipSDPList skipTS -
This cmdlet skips testing Server Message Block (SMB) connectivity to any Cluster Shared Volumes (CSVs) in the failover cluster.
.\TSS.ps1 -SDP HyperV -SkipSDPList skipCsvSMB -
This cmdlet skips any data collection related to Hyper-V Replica data and slightly speeds up the collection process.
.\TSS.ps1 -SDP HyperV -SkipSDPList skipHVreplica
Note: You can combine multiple skip parameters with comma-separated items, such as the following example:
.\TSS.ps1 -SDP HyperV -SkipSDPList skipBPA,skipHang,skipTS,skipCsvSMB,skipHVreplica
Source: Microsoft Learn / IT Pro troubleshooting by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
