Write-DiagProgress Cmdlet
Writes a progress string to the troubleshooting client.
Write-DiagProgress [-Activity] <String> [[-Status] <String>]
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.
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 |
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 |
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 |
The following examples show how to use the cmdlet.
The following example shows how to specify the current activity being performed by the script.
PS:>Write-DiagProgress -Activity "Checking network connectivity"
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"