Skip to content

Commit e025a35

Browse files
committed
Updates
1 parent c7868c9 commit e025a35

File tree

1 file changed

+44
-13
lines changed

1 file changed

+44
-13
lines changed

support/windows-client/windows-tss/collect-data-analyze-troubleshoot-hyperv-scenarios.md

Lines changed: 44 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -24,40 +24,71 @@ Refer to [Introduction to TroubleShootingScript toolset (TSS)](introduction-to-t
2424
### TSS cmdlet
2525

2626
```powershell
27-
.\TSS.ps1 -Scenario HyperV
27+
.\TSS.ps1 -SDP HyperV
2828
```
2929

3030
### TSS cmdlet description
3131

3232
To gather information for Hyper-V related issues, follow these steps:
3333

34-
1. Download the latest version of the TSS tool from the Microsoft website.
35-
2. Open an elevated PowerShell window.
36-
3. Navigate to the folder where the TSS tool is located.
37-
4. Run the command
34+
1. Download [TSS](https://aka.ms/getTSS) and extract it in the *C:\\tss* folder.
35+
2. Open the *C:\\tss* folder from an elevated PowerShell command prompt.
36+
> [!NOTE]
37+
> Don't use the Windows PowerShell Integrated Scripting Environment (ISE).
38+
3. Run the following cmdlets:
39+
40+
```powershell
41+
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
42+
```
43+
44+
```powershell
45+
.\TSS.ps1 -SDP HyperV
46+
```
47+
48+
4. Enter *A* for "Yes to All" for the execution policy change.
49+
50+
> [!NOTE]
51+
>
52+
> - 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.
53+
> - 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.
3854
3955
#### Optional parameters
4056
4157
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.
4258
43-
- This cmdlet collect only the logs without running diagnostics.
59+
- This cmdlet skips running the Best Practices Analyzer and makes the collection faster.
60+
61+
```powershell
62+
.\TSS.ps1 -SDP HyperV -SkipSDPList skipBPA
63+
```
64+
65+
- This cmdlet skips some small collection items that may fail in a regular collection and makes the script more reliable.
66+
67+
```powershell
68+
.\TSS.ps1 -SDP HyperV -SkipSDPList skipHang
69+
```
70+
71+
- This cmdlet skips some additional collection parameters that may not be needed.
4472
4573
```powershell
46-
.\TSS.ps1 -Scenario HyperV -CollectOnly
74+
.\TSS.ps1 -SDP HyperV -SkipSDPList skipTS
4775
```
4876
49-
- This cmdlet prevents uploading the collected data to Microsoft.
77+
- This cmdlet skips testing Server Message Block (SMB) connectivity to any Cluster Shared Volumes (CSVs) in the failover cluster.
5078
5179
```powershell
52-
.\TSS.ps1 -Scenario HyperV -NoUpload
80+
.\TSS.ps1 -SDP HyperV -SkipSDPList skipCsvSMB
5381
```
5482
55-
- This cmdlet specifies the output folder for the collected data.
83+
- This cmdlet skips any data collection related to Hyper-V Replica data and slightly speeds up the collection process.
5684
5785
```powershell
58-
.\TSS.ps1 -Scenario HyperV -OutputPath <path>
86+
.\TSS.ps1 -SDP HyperV -SkipSDPList skipHVreplica
5987
```
6088
6189
> [!NOTE]
62-
> The TSS tool may take several minutes to complete depending on the system configuration and the amount of data being collected.
63-
> After the tool finishes running, it creates a compressed file (.zip) that contains all the collected information.
90+
> You can combine multiple skip parameters with comma-separated items, such as the following example:
91+
>
92+
> ```powershell
93+
> .\TSS.ps1 -SDP HyperV -SkipSDPList skipBPA,skipHang,skipTS,skipCsvSMB,skipHVreplica
94+
> ```

0 commit comments

Comments
 (0)