Write-DiagProgress Cmdlet

Writes a progress string to the troubleshooting client.

Syntax

Write-DiagProgress [-Activity] <String> [[-Status] <String>]

Detailed Description

The progress strings are in the form of an activity string that describes the activity being performed and an optional status string that describes the status of that activity (for example, if the activity is copying files, the status might be the current file being copied).

Typically, you should use this cmdlet if the activity takes more than one second to complete.

Parameters

-Activity String

A localized string that describes the activity that the script is performing (for example, Initializing or Copying files). Activity strings should describe long-running operations.

Attribute	Value
Required?	true
Position?	0
Default value	None
Accept pipeline input?	false
Accept wildcard characters?	false
Alias	a

 

-Status String

A localized string that describes the current status of the activity defined by the Activity parameter (for example, if the activity is copying files, the status could be the name of the file being copied). Status strings should be used to update the status of a long running activity.

Attribute	Value
Required?	false
Position?	1
Default value	None
Accept pipeline input?	false
Accept wildcard characters?	false
Alias	s

 

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

Type	Description
Input type	None
Return type	None

 

Examples

The following examples show how to use the cmdlet.

Example 1

The following example shows how to specify the current activity being performed by the script.

PS:>Write-DiagProgress -Activity "Checking network connectivity"

Example 2

The following example shows how to specify the status of the current activity being performed by the script.

PS:>Write-DiagProgress -Activity "Checking network connectivity" -Status "Contacting Microsoft.com"