New-CsVideoInteropServerSyntheticTransactionConfiguration
Use the New-CsVideoInteropServerSyntheticTransactionConfiguration cmdlet to create a new Video Interop Server (VIS) synthetic transaction configuration.
The cmdlet can be applied at the Global, Site and Service levels.
Syntax
New-CsVideoInteropServerSyntheticTransactionConfiguration
[-Identity] <XdsIdentity>
[-Confirm]
[-Force]
[-InMemory]
[-WatcherNodeFqdns <PSListModifier>]
[-WhatIf]
[<CommonParameters>] Description
To return a list of all the Role-Based Access Control (RBAC) roles a cmdlet has been assigned to (including any custom RBAC roles you have created), run the following command from the Windows PowerShell prompt.
Get-CsAdminRole | Where-Object {$_.Cmdlets -Match "\<DesiredCmdletName\>"}
Examples
-------------------------- Example 1 --------------------------
New-CsVideoInteropServerSyntheticTransactionConfiguration -Identity "site:Redmond" -WatcherNodeFqdns "atl-cs-001.contoso.com", "atl-cs-002.contoso.com"This example creates a new Video Interop Server synthetic transaction configuration with two watcher nodes and scoped for the Redmond site.
Parameters
-Confirm
Prompts you for confirmation before executing the command.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-Force
Suppresses the display of any non-fatal error messages and completes the cmdlet operation.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
The Identity parameter specifies the Video Interop Server synthetic transaction configuration to create. Video Interop Server synthetic transaction configuration settings can be configured at the global, site, or service scope. To refer to the global instance, use this syntax:
-Identity "Global"
Use this syntax to refer to a collection at the site scope:
-Identity "site:Redmond"
Wildcard characters such as the asterisk (*) cannot be used with the Identity parameter.
| Type: | XdsIdentity |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-InMemory
Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet's matching Set- cmdlet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-WatcherNodeFqdns
Specifies the FQDN of the watcher node relevant to the synthetic transaction.
For example: -WatcherNodeFqdns "atl-cs-001.contoso.com".
Watcher nodes are computers that periodically use System Center Operations Manager and Skype for Business Server synthetic transactions to verify that Skype for Business Server components are working as expected.
For more information, see New-CsWatcherNodeConfiguration.
To enter multiple values and overwrite any existing entries, use the following syntax: \<value1\>,\<value2\>....
If the values contain spaces or otherwise require quotation marks, you need to use the following syntax: "\<value1\>","\<value2\>"....
To add or remove one or more values without affecting any existing entries, use the following syntax: @{Add="\<value1\>","\<value2\>"...; Remove="\<value1\>","\<value2\>"...}.
| Type: | PSListModifier |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
None
Outputs
Returns a VideoInteropServerSyntheticTransactionConfiguration object.