Removes a trusted application computer.
Syntax
Remove-CsTrustedApplicationComputer -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
XdsGlobalRelativeIdentity |
The fully qualified domain name (FQDN) of the computer to remove. |
|
Confirm |
Optional |
SwitchParameter |
Prompts you for confirmation before executing the command. |
|
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 host trusted applications. (These pools can contain other computers, but it is recommended that you create separate pools for trusted application computers.) Use this cmdlet to remove a trusted application computer.
When you use this cmdlet to remove a trusted application computer, it will be removed not only from the list of trusted application computers but from the list of computers available on Communications Server. In other words, if you call Get-CsTrustedApplicationComputer or Get-CsComputer the computer will no longer be listed. You cannot remove a trusted application computer if it’s the only computer on the pool. If you want to remove the only computer on a pool you must remove the entire pool (which can be done by calling Remove-CsTrustedApplicationPool).
Return Types
This cmdlet does not return a value. It removes an object of type Microsoft.Rtc.Management.Xds.DisplayComputer.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Remove-CsTrustedAppicationComputer -Identity Trust1.litwareinc.com |
|
This example removes the computer with the FQDN Trust1.litwareinc.com.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
Get-CsTrustedApplicationComputer -Filter Trust* | Remove-CsTrustedApplicationComputer |
|
This example removes all trusted computers that have FQDNs beginning with the string Trust. The example begins by calling the Get-CsTrustedApplicationComputer cmdlet, passing the Filter parameter the value Trust*. This will retrieve all trusted application computers with an FQDN beginning with Trust and ending with any set of characters. That collection of computers is then piped to the Remove-CsTrustedApplicationComputer cmdlet, which removes each item (each computer) in the collection. Keep in mind that this won’t remove the computers from a pool if removing those computers would result in an empty pool.