Get-CsTrustedApplication

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

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").

Siehe auch

Weitere Ressourcen

New-CsTrustedApplication
Remove-CsTrustedApplication
Set-CsTrustedApplication