Switch-EnvTestTask
Sets the current task that will be returned by a call to Get-EnvTestTask with no parameters.
Syntax
Switch-EnvTestTask
[-SkipCertificateValidation]
[<CitrixCommonParameters>]
[<CommonParameters>]
Switch-EnvTestTask
[-Task <EnvTestTask>]
[-SkipCertificateValidation]
[<CitrixCommonParameters>]
[<CommonParameters>]
Switch-EnvTestTask
[-TaskId <Guid>]
[-SkipCertificateValidation]
[<CitrixCommonParameters>]
[<CommonParameters>]
Description
Sets the current task that will be returned by a call to Get-EnvTestTask with no parameters.
Examples
EXAMPLE 1
Switches the current task to another via its id, which is available from an existing task's \$task.TaskId property.
Switch-EnvTestTask -TaskId 50A4139F-2B55-4A97-A1BE-20EE4E124AA3
EXAMPLE 2
Switches the current task to the second in the list returned by Get-EnvTestTask -List.
$secondTask = $(Get-EnvTestTask -List)[1]
Switch-EnvTestTask -Task $switchTask
Parameters
-TaskId
Specifies the identifier of the task to be made current.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Task
The task object to be made current, retrieveable from the \$task.TaskId property.
| Type: | EnvTestTask |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipCertificateValidation
Forces the cmdlet to skip checking SSL certificates. By default, the cmdlet will check the certificate from the server. If the certificate is not valid, the cmdlet will not connect to the server.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Introduced in: | Citrix Virtual Apps and Desktop 7 2511 |
CitrixCommonParameters
This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
Objects containing the TaskId parameter can be piped to the Remove-EnvTestTask command.
Outputs
None
By default, this cmdlet returns no output.