次の方法で共有


New-CsTrustedApplication

 

トピックの最終更新日: 2012-03-26

プールに信頼されたアプリケーションを追加します。

構文

New-CsTrustedApplication -ApplicationId <String> -Port <Int32> -TrustedApplicationPoolFqdn <String> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]

New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] -Port <Int32> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]

解説

信頼されたアプリケーションとは、Microsoft Lync Server 2010 の一部として実行するために信頼された状態が付与されているが、製品の組み込み部分ではない、サードパーティによって開発されたアプリケーションのことです。このコマンドレットを実行すると、信頼されたアプリケーション プールに信頼されたアプリケーションが追加されて、そのアプリケーションを実行する外部サービスにポートが割り当てられます。

信頼されたアプリケーションは、グローバルにルーティング可能なユーザー エージェント URI (GRUU) に、サービスの GRUU とコンピューターの GRUU の両方で関連付ける必要があります。このコマンドレットを実行すると、このアプリケーションが所属するプールに関連付けられているコンピューターとサービスに基づいて、これらの値が自動的に生成されます。

このコマンドレットを使用して信頼されたアプリケーションを作成する場合、Identity パラメーターの値を指定するか、または ApplicationID パラメーターと TrustedApplicationPoolFqdn パラメーターの値を指定する必要があります。Identity は、TrustedApplicationPoolFqdn の後にスラッシュ (/) と ApplicationID を付けたものです。たとえば、TrustPool.litwareinc.com/tapp2 のようになります。ここで、TrustPool.litwareinc.com は TrustedApplicationPoolFqdn で、tapp2 は ApplicationID です。

アプリケーション ID を入力するときに (Identity パラメーターの一部として、または ApplicationID パラメーターとして)、アプリケーションの名前のみ入力する必要があります。ただし、完全なアプリケーション ID には、先頭に urn:application: という文字列が自動的に付加されます。たとえば、ApplicationID に値 tapp2 を入力すると、その ID は urn:application:tapp2 として格納されます。同様に、TrustPool.litwareinc.com/tapp2 という Identity を入力すると、その Identity は TrustPool.litwareinc.com/urn:application:tapp2 としてシステムに格納されます。

このコマンドレットを使用して Port 値を指定した場合、コマンドレットを実行してもポートは開かれません。信頼されたアプリケーションがファイアウォールの外のネットワークと通信するためには、Windows ファイアウォールおよび企業のファイアウォールでポートを開く必要があります。

このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、New-CsTrustedApplication コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplication\b"}

パラメーター

パラメーター 必須かどうか 説明

Identity

省略可能

ExternalApplicationIdentity

プール上の信頼されたアプリケーションの一意の識別子。ID 値は、<プールの FQDN>/<アプリケーション ID> の形式で入力する必要があります。ここで、プールの FQDN はアプリケーションが存在するプールの完全修飾ドメイン名 (FQDN) で、アプリケーション ID はアプリケーションの名前です。アプリケーション ID は、指定のプールに一意である必要があります。

Identity を入力する場合、ApplicationId パラメーターまたは TrustedApplicationPoolFqdn パラメーターの値を指定することはできません。

ApplicationId

必須

文字列

アプリケーションの名前。TrustedApplicationPoolFqdn パラメーターで指定されているプール内で一意の文字列である必要があります。文字列では空白を使用できません。ApplicationId の値を指定する場合、TrustedApplicationPoolFqdn パラメーターの値も指定する必要があります。ApplicationId と Identity を指定することはできません。

Port

必須

Int32

アプリケーションが実行されるポート番号。ポートは、指定のプール内で一意である必要があります。つまり、この同じポートを使用する他のアプリケーションを、指定のプールに定義することはできません。

TrustedApplicationPoolFqdn

必須

文字列

アプリケーションが存在する信頼されたアプリケーション プールの FQDN。TrustedApplicationPoolFqdn の値を指定する場合、ApplicationId の値も指定する必要がありますが、Identity パラメーターの値を指定することはできません。

EnableTcp

省略可能

SwitchParameter

信頼されたアプリケーションが伝送制御プロトコル (TCP) を使用することを指定します。このパラメーターは、信頼されたアプリケーションが Microsoft Unified Communications Managed API (UCMA) アプリケーションでない場合のみ使用します。UCMA アプリケーションでは、相互トランスポート層セキュリティ (MTLS) プロトコルのみサポートしているためです。Force パラメーターと EnableTcp パラメーターを指定しない場合、新しい信頼されたアプリケーションが作成される前に、確認メッセージが表示されます。

LegacyApplicationName

省略可能

文字列

このパラメーターは、アプリケーションが Microsoft Office Communications Server 2007 R2 の展開から移行中である場合にのみ使用します。アプリケーションが連動するには、この値と Office Communications Server 2007 R2 バージョンのアプリケーションの GRUU の型が同じである必要があります。

ほとんどの場合、ApplicationId パラメーターを GRUU の型と同じに設定することで、アプリケーションが連動するためには十分です。しかし、Office Communications Server 2007 R2 アプリケーションの GRUU の型に ApplicationId では有効でない文字が含まれている場合は、この値を LegacyApplicationName パラメーターに指定する必要があります。

このパラメーターの値を指定しない場合、アプリケーション ID の値が自動的に挿入されます (urn:application: プレフィックスなし)。

Force

省略可能

SwitchParameter

変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。

WhatIf

省略可能

SwitchParameter

実際にコマンドを実行せずに、コマンドの実行結果がわかります。

Confirm

省略可能

SwitchParameter

コマンドの実行前に確認メッセージを表示します。

入力の種類

なし。

戻り値の種類

Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 型のオブジェクトが作成されます。

-------------------------- 例 1 ------------------------

New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000

この例では、tapp1 というアプリケーション ID を持つ信頼されたアプリケーションを作成します。TrustedApplicationPoolFqdn パラメーターを使用して、このアプリケーションが存在する信頼されたアプリケーション プール (この場合、TrustPool.litwareinc.com という FQDN を持つプール) を指定します。また、アプリケーションにポートを指定する必要があります。この例では、ポート 6000 を使用しています。ApplicationId と TrustedApplicationPoolFqdn を指定してこのコマンドレットを実行すると、後でこのアプリケーションの取得、変更、または削除に使用できる ID が自動的に生成されます。

-------------------------- 例 2 ------------------------

New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100

この例では、ポート 6100 に TrustPool.litwareinc.com/tapp2 という Identity を持つ信頼されたアプリケーションを作成します。Identity の形式に注意してください。この値は、<信頼されたプールの FQDN>/<アプリケーション ID>の形式にする必要があります。