-
Understanding the Citrix Virtual Apps and Desktops Administration Model
-
-
-
-
-
-
-
-
-
Start-EnvTestTask
-
-
-
-
-
-
-
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Start-EnvTestTask
Starts a new test task.
Syntax
Start-EnvTestTask
[-IgnoreRelatedObjects]
[-RunAsynchronously]
[-ExcludeNotRunTests]
[<CitrixCommonParameters>]
[<CommonParameters>]
<!--NeedCopy-->
Start-EnvTestTask
[-CultureName <String>]
-InputObject <PSObject[]>
[-IgnoreRelatedObjects]
[-RunAsynchronously]
[-ExcludeNotRunTests]
[<CitrixCommonParameters>]
[<CommonParameters>]
<!--NeedCopy-->
Start-EnvTestTask
-TestId <String>
[-TargetIdType <String>]
[-TargetId <String>]
[-CultureName <String>]
[-IgnoreRelatedObjects]
[-RunAsynchronously]
[-ExcludeNotRunTests]
[<CitrixCommonParameters>]
[<CommonParameters>]
<!--NeedCopy-->
Start-EnvTestTask
-TestSuiteId <String>
[-TargetIdType <String>]
[-TargetId <String>]
[-CultureName <String>]
[-IgnoreRelatedObjects]
[-RunAsynchronously]
[-ExcludeNotRunTests]
[<CitrixCommonParameters>]
[<CommonParameters>]
<!--NeedCopy-->
Description
Starts a new test task based on a set of criteria provided via parameters or piped input and either waits for the tests to run or returns immediately depending on how it is called. When running a test suite and providing a target object for that suite, the service will discover related objects by default, but this behavior may be disabled if desired.
Examples
EXAMPLE 1
Create and start a task with a single test and no target object.
$singleSimpleTestTask = Start-EnvTestTask -TestId Monitor_RegisteredWithConfigurationService
<!--NeedCopy-->
EXAMPLE 2
Create and start a task with a single test and no target object, with localized properties translated into Spanish.
$singleSimpleTestTaskInSpanish = Start-EnvTestTask -TestId Monitor_RegisteredWithConfigurationService -CultureName es-ES
<!--NeedCopy-->
EXAMPLE 3
Create and start a task with a single test suite and no target object.
$singleSimpleTestSuiteTask = Start-EnvTestTask -TestSuiteId Infrastructure
<!--NeedCopy-->
EXAMPLE 4
Create and start a task with a single test suite and a catalog target object.
$singleTestSuiteTask = Start-EnvTestTask -TestSuiteId Catalog -TargetIdType Catalog -TargetId $(Get-BrokerCatalog).Uuid
<!--NeedCopy-->
EXAMPLE 5
Create and start a task with a single test suite and a catalog target object, and return immediately not waiting for the tests to complete.
$singleTestSuiteTask = Start-EnvTestTask -TestSuiteId Catalog -TargetIdType Catalog -TargetId $(Get-BrokerCatalog).Uuid -RunAsynchronously
<!--NeedCopy-->
EXAMPLE 6
Create and start a task with a single test, a target object for that test, and no object discovery based on that target.
$adAccountPool = Get-AcctIdentityPool
$singleTestTaskWithNoObjectDiscovery = StartEnvTestTask -IgnoreRelatedObjects -TestId ADIdentity_IdentityPool_ValidatePoolIsUnlocked -TargetIdType IdentityPool -TargetId $adAccountPool.IdentityPoolUid
<!--NeedCopy-->
EXAMPLE 7
Create two different discovery target definitions, put them in an array, then start a task based on both via -InputObject.
$singleSimpleTestSuiteTaskTarget = New-EnvTestDiscoveryTargetDefinition -TestSuiteId Infrastructure
$singleTestSuiteTaskTarget = New-EnvTestDiscoveryTargetDefinition -TestSuiteId Catalog -TargetIdType Catalog -TargetId $(Get-BrokerCatalog).Uuid
$inputObjects = @($singleSimpleTestSuiteTaskTarget, $singleTestSuiteTaskTarget)
Start-EnvTestTask -InputObject $inputObjects
<!--NeedCopy-->
Parameters
-TestId
Test identifiers. If specified, do not specify -TestSuiteId.
| Type: | String |
| Position: | Named |
| Default value: | Empty |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TestSuiteId
Test suite identifiers. If specified, do not specify -TestId.
| Type: | String |
| Position: | Named |
| Default value: | Empty |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
One or more test targets defining the task, see Input Types for details about what kind of objects are permissible. Any valid object passed to this parameter may also be piped into this cmdlet.
| Type: | PSObject[] |
| Position: | Named |
| Default value: | Empty |
| Required: | True |
| Accept pipeline input: | True (ByValue) |
| Accept wildcard characters: | False |
-TargetIdType
Describes the type of corresponding object passed with -TargetId
| Type: | String |
| Position: | Named |
| Default value: | Empty |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetId
The Ids that object tests or tests suites will target. By default, other components are queried for objects related to these.
| Type: | String |
| Position: | Named |
| Default value: | Empty |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CultureName
The culture name in which to produce results. The culture name is in standard language/region-code format; for example “en-US”.
| Type: | String |
| Position: | Named |
| Default value: | The current user interface culture |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IgnoreRelatedObjects
Do not ask other components for objects related to a specified target.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Do not wait for the test run to complete, return immediately.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeNotRunTests
If set, tests that are not run because no object matching their requirements is found are NOT included in test counts and results.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False (include Not Run tests) |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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
Citrix.EnvTest.Sdk.EnvTestDiscoveryTargetDefinition
A single EnvTestDiscoveryTargetDefinition can be specified to target one test or test suite.
Citrix.EnvTest.Sdk.EnvTestDiscoveryTargetDefinition[]
An array of EnvTestDiscoveryTargetDefinition(s) can be specified to target any combination of tests and/or test suites.
PSCustomObject
A single PSCustomObject with properties matching the required EnvTestDiscoveryTargetDefinition properties can be specified to target one test or test suite.
PSCustomObject[]
An array of PSCustomObject(s) with properties matching the required EnvTestDiscoveryTargetDefinition properties can be specified to target any combination of tests and/or test suites.
Outputs
Ctrix.EnvTest.Sdk.EnvTestTask
The newly started task.
Related Links
Share
Share
In this article
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.