Adds a computer that hosts trusted applications to an existing pool.
Syntax
New-CsTrustedApplicationComputer -Identity <XdsGlobalRelativeIdentity> -Pool <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
XdsGlobalRelativeIdentity |
The FQDN of the computer that hosts the trusted application. |
|
Pool |
Required |
String |
The FQDN of the pool hosting the trusted application computer. You can find available pools by running the Get-CsTrustedApplicationPool cmdlet. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
|
InMemory |
Optional |
SwitchParameter |
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. |
|
WhatIf |
Optional |
SwitchParameter |
Describes what would happen if you executed the command without actually executing the command. |
Detailed Description
Trusted applications run on separate computers from the rest of the Microsoft Communications Server 2010 deployment. These computers are also added to separate pools that contain computers that home trusted applications. (These pools can contain other computers, but it is recommended that you create separate pools for trusted application computers.) By default, when you create a pool a computer with the same FQDN as the pool is also created. Use this cmdlet to create a new computer and add it to a pool.
The trusted application pool must already exist in order for this cmdlet to succeed. In addition, you can’t add an additional trusted application computer to a pool that contains service roles other than the ExternalServer role. For example, if the pool also supports Registrar or CentralMgmt roles, the pool can contain only one trusted application computer. In addition, if you did not specify a computer fully qualified domain name (FQDN) for the default computer when you created the pool (by calling New-CsTrustedApplicationPool), the computer will have the same FQDN as the pool and you cannot add another computer.
Return Types
Creates an object of type Microsoft.Rtc.Management.Xds.DisplayComputer.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
New-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com -Pool TrustPool.litwareinc.com |
|
This example adds a new computer with the FQDN Trust1.litwareinc.com to the pool TrustPool.litwareinc.com. We use the Identity parameter to specify the FQDN of the new computer, and the Pool parameter to specify the FQDN of the pool. The pool must exist and must be a trusted application pool. (Note: To create a trusted application pool, call the New-CsTrustedApplicationPool cmdlet.)