Adds a trusted application to a pool.
Syntax
New-CsTrustedApplication -ApplicationId <String> -Port <Int32> -TrustedApplicationPoolFqdn <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]] |
New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] -Port <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Optional |
ExternalApplicationIdentity |
A unique identifier for the trusted application on the pool. Identity values must be entered in the format <pool FQDN>/<application ID>, where pool FQDN is the fully qualified domain name (FQDN) of the pool on which the application resides, and application ID is the name of the application. The application ID must be unique for a given pool. If you enter an Identity, you cannot specify values for the ApplicationId or TrustedApplicationPoolFqdn parameters. |
|
ApplicationId |
Required |
String |
The name of the application. This must be a string that is unique within the pool that is specified in the TrustedApplicationPoolFqdn parameter. If you supply a value for ApplicationId, you must also supply a value for the TrustedApplicationPoolFqdn parameter. You cannot specify an ApplicationId and an Identity. |
|
TrustedApplicationPoolFqdn |
Required |
String |
The FQDN of the trusted application pool on which the application will reside. |
|
Port |
Required |
Int32 |
The port number on which the application will run. The port must be unique within a given pool. In other words, no other applications that use this same port can be defined on the specified pool. |
|
LegacyApplicationName |
Optional |
String |
If you don’t specify a value for this parameter, the value of the Application ID will automatically be inserted. |
|
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
A trusted application is an application developed by another party that is given trusted status to run as part of Microsoft Communications Server 2010 but that is not a built-in part of the product. This cmdlet adds a trusted application to a trusted application pool and assigns a port to the external service that runs the application.
Trusted applications need to be associated with Globally Routable User Agent URIs (GRUUs), both service GRUUs and computer GRUUs. This cmdlet automatically generates these values based on the computers and services associated with the pool on which this application is homed.
When you use this cmdlet to create a trusted application, you must supply values either for the Identity parameter or for the ApplicationID and TrustedApplicationPoolFqdn parameters. The Identity is the TrustedApplicationPoolFqdn followed by a slash (/) followed by the ApplicationID. For example, TrustPool.litwareinc.com/tapp2, where TrustPool.litwareinc.com is the TrustedApplicationPoolFqdn and tapp2 is the ApplicationID.
Note that when you enter an application ID (either as part of the Identity parameter or in the ApplicationID parameter) you need to enter only the name of the application. However, the full application ID will be automatically prefixed with the string urn:application:. For example, if you enter the value tapp2 for the ApplicationID, that ID will be stored as urn:application:tapp2. Similarly, if you enter an Identity of TrustPool.litwareinc.com/tapp2, the Identity will be stored in the system as TrustPool.litwareinc.com/urn:application:tapp2.
Return Types
Creates an object of type Microsoft.Rtc.Management.Xds.DisplayTrustedApplication.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000 |
|
This example creates a trusted application with the Application ID tapp1. We use the TrustedApplicationPoolFqdn parameter to designate the trusted application pool this application will be on, in this case the pool with the FQDN TrustPool.litwareinc.com. We also must specify a port for the application; in this example we used port 6000. Note that running this cmdlet by specifying an ApplicationId and a TrustedApplicationPoolFqdn will automatically generate an Identity that can later be used to retrieve, modify, or remove this application.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100 |
|
This example creates a trusted application with the Identity TrustPool.litwareinc.com/tapp2 on Port 6100. Notice the format of the Identity. This value must be in the format <trusted pool FQDN>/<Application ID>.