Stops currently running Machine Creation Service tasks.
Stop-ProvTask [-TaskId] <Guid> [-LoggingId <Guid>] [-BearerToken <String>] [-TraceParent <String>] [-TraceState <String>] [-VirtualSiteId <String>] [-AdminAddress <String>] [<CommonParameters>]
Enables tasks currently running in the Machine Creation Service to be stopped. Once stopped, tasks cannot be resumed.
|Name||Description||Required?||Pipeline Input||Default Value|
|TaskId||Specifies the identifier for the task to be stopped.||true||true (ByPropertyName)|
|LoggingId||Specifies the identifier of the high-level operation this cmdlet call forms a part of. Citrix Studio and Director typically create high-level operations. PowerShell scripts can also wrap a series of cmdlet calls in a high-level operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets.||false||false|
|BearerToken||Specifies the bearer token assigned to the calling user||false||false|
|TraceParent||Specifies the trace parent assigned for internal diagnostic tracing use||false||false|
|TraceState||Specifies the trace state assigned for internal diagnostic tracing user||false||false|
|VirtualSiteId||Specifies the virtual site the PowerShell snap-in will connect to.||false||false|
|AdminAddress||The address of a Citrix Virtual Apps and Desktops controller the PowerShell snap-in will connect to. You can provide this as a host name or an IP address.||false||false||Localhost. Once a value is provided by any cmdlet, this value becomes the default.|
Objects containing the TaskId parameter can be piped to the Stop-ProvTask command.
If the command fails, the following errors can result.
InvalidWorkflow: The specified task could not be found.
InvalidWorkflowHost: The specified task is executing on a different server.
DatabaseError: An error occurred in the service while attempting a database operation.
DatabaseNotConfigured: The operation could not be completed because the database for the service is not configured.
DataStoreException: An error occurred in the service while attempting a database operation - communication with the database failed for various reasons.
PermissionDenied: You do not have permission to execute this command.
AuthorizationError: There was a problem communicating with the Citrix Delegated Administration Service.
ConfigurationLoggingError: The operation could not be performed because of a configuration logging error.
CommunicationError: There was a problem communicating with the remote service.
DatabaseError: There was a problem communicating with the database.
ExceptionThrown: An unexpected error occurred.
For more details, see the Windows event logs on the controller or the Citrix Virtual Apps and Desktops logs.
c:\PS>Get-ProvTask -active $true | Stop-ProvTask Success
Terminate all tasks currently executing on the Machine Creation Service.
c:\PS>Stop-ProvTask -TaskId bd52e688-e40d-4790-83de-9f7633481454 Success
Terminate the named task executing on the Machine Creation Service.