Freigeben über

  • Artikel

Get-CsTrustedApplication

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft die Einstellungen für eine vertrauenswürdige Anwendung ab.

Syntax

Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]

Get-CsTrustedApplication [-Filter <String>]

Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>]

Detaillierte Beschreibung

Eine vertrauenswürdige Anwendung ist eine von einem Drittanbieter entwickelte, jedoch nicht in das Produkt integrierte Anwendung, der ein Vertrauensstatus zugewiesen wurde, damit sie als Teil von Microsoft Lync Server 2010 ausgeführt wird. Mit diesem Cmdlet können Sie Port- und GRUU-Einstellungen (Globally Routable User Agent URI) für eine oder mehrere vertrauenswürdige Anwendungen abrufen.

Wenn Sie eine vertrauenswürdige Anwendung mit diesem Cmdlet abrufen, müssen Sie einen Wert für den Parameter "Identity" angeben. Der Identitätswert ist der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) des Pools, in dem sich die Anwendung befindet, gefolgt von einem Schrägstrich (/), auf den wiederum die Anwendungs-ID folgt, z. B. "TrustPool.litwareinc.com/tapp2". "TrustPool.litwareinc.com" ist in diesem Fall der Pool-FQDN und "tapp2" die Anwendungs-ID. Beachten Sie, dass Sie beim Abrufen einer Anwendung durch Aufrufen dieses Cmdlets eine ID wie die folgende erhalten: TrustPool.litwareinc.com/urn:application:tapp2. Wie Sie sehen, steht das Präfix "urn:application:" vor dem Anwendungsnamen (tapp2). Während dieses Präfix zwar Teil des Identitätswerts ist, ist es beim Angeben des Werts für den Parameter "Identity" nicht erforderlich.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsTrustedApplication lokal ausführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

ExternalApplicationIdentity

Eine eindeutige ID für die vertrauenswürdige Anwendung, die abgerufen werden soll. Identitätswerte müssen im Format <Pool-FQDN>/<Anwendungs-ID> eingegeben werden. Hierbei steht "Pool-FQDN" für den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Pools, in dem sich die Anwendung befindet, und "Anwendungs-ID" für den Namen der Anwendung. Beachten Sie, dass Sie beim Angeben eines Identitätswerts keine Werte für die Parameter "ApplicationID" oder "TrustedApplicationPoolFqdn" festlegen können.

Filter

Optional

Zeichenfolge

Eine Zeichenfolge mit Platzhalterzeichen, mit der vertrauenswürdige Anwendungen abgerufen werden können, deren Identitätswert mit der angegebenen Platzhaltersuchzeichenfolge übereinstimmt. Identitätswerte bestehen aus dem FQDN eines Pools vertrauenswürdiger Anwendungen gefolgt von einem Schrägstrich (/) und der ID der vertrauenswürdigen Anwendung. Der Filterwert stimmt mit einem beliebigen Teil des Identitätswerts – dem FQDN oder der Anwendungs-ID – überein.

ApplicationId

Optional

Zeichenfolge

Der Name der Anwendung. Dies kann das Anwendungs-ID-Präfix enthalten. Die "ApplicationId"-Werte "urn:application:tapp1" und "tapp1" geben beispielsweise beide die gleiche Anwendung zurück. Wenn Sie einen Wert für den Parameter "ApplicationId" angeben, können Sie keinen Wert für "Identity" festlegen, müssen aber einen Wert für "TrustedApplicationPoolFqdn" angeben.

TrustedApplicationPoolFqdn

Optional

Zeichenfolge

Der FQDN des Pools vertrauenswürdiger Anwendungen, in dem sich die Anwendung befindet. Wenn Sie einen Wert für den Parameter "TrustedApplicationPoolFqdn" angeben, können Sie keinen Wert für "Identity" festlegen, müssen aber einen Wert für "ApplicationId" angeben.

Eingabetypen

Keine.

Rückgabetypen

Gibt ein Objekt vom Typ "Microsoft.Rtc.Management.Xds.DisplayTrustedApplication" zurück.

Beispiel

-------------------------- Beispiel 1 --------------------------

Get-CsTrustedApplication

In diesem Beispiel werden Informationen zu allen vertrauenswürdigen Anwendungen abgerufen, die in der Lync Server 2010-Bereitstellung definiert sind.

-------------------------- Beispiel 2 --------------------------

Get-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2

In Beispiel 2 wird die vertrauenswürdige Anwendung mit dem Identitätswert "TrustPool.litwareinc.com/urn:application:tapp2" abgerufen. Beachten Sie, dass das Präfix "urn:application:" weggelassen werden konnte. Mit Get-CsTrustedApplication wird das Präfix automatisch hinzugefügt und die richtige Anwendung abgerufen.

-------------------------- Beispiel 3 --------------------------

Get-CsTrustedApplication -Filter *trust*

In Beispiel 3 werden alle vertrauenswürdigen Anwendungen entfernt, deren Identitätswerte mit der als Filterwert angegebenen Platzhalterzeichenfolge übereinstimmen. Da der Filterwert in diesem Fall "*trust*" lautet, ruft der Befehl alle vertrauenswürdigen Anwendungen ab, deren Identitätswert die Zeichenfolge "trust" enthält. Diese Zeichenfolge kann in einem beliebigen Teil des Identitätswerts, des Pool-FQDNs oder der Anwendungs-ID enthalten sein. Dieser Befehl ruft also vertrauenswürdige Anwendungen mit Identitätswerten wie "TrustedPool.litwareinc.com/urn:application:application1", "Pool1.litwareinc.com/urn:application:trustedapp" und "Pool1.litwareinc.com/urn:application:trust" ab.

-------------------------- Beispiel 4 --------------------------

Get-CsTrustedApplication -ApplicationId tapp2 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

In Beispiel 4 werden dieselben Ergebnisse zurückgegeben wie in Beispiel 2 (in dem der Identitätswert als einziger Parameter angegeben wurde). Der einzige Unterschied zwischen den beiden Beispielen besteht lediglich darin, dass das Abrufen der vertrauenswürdigen Anwendung in Beispiel 2 basierend auf dem Identitätswert erfolgt, der aus dem FQDN des Pools vertrauenswürdiger Anwendungen und der Anwendungs-ID besteht. In diesem Beispiel werden die Anwendungs-ID und der FQDN des Pools vertrauenswürdiger Anwendungen als Werte für zwei separate Parameter eingegeben: "ApplicationId" und "TrustedApplicationPoolFqdn".

-------------------------- Beispiel 5 --------------------------

Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "TrustPool.litwareinc.com"}

In Beispiel 5 werden alle vertrauenswürdigen Anwendungen im Pool "TrustPool.litwareinc.com" abgerufen. Dazu wird zunächst das Cmdlet Get-CsTrustedApplication aufgerufen. Daraufhin wird eine Auflistung aller vertrauenswürdigen Anwendungen zurückgegeben, die in der Lync Server-Bereitstellung definiert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Auflistung nach Elementen durchsucht, bei denen die Eigenschaft "TrustedApplicationPoolFqdn" den Wert "TrustPool.litwareinc.com" aufweist (der Vergleichsoperator "-eq" steht für "equal to").