• Artikel

Remove-CsTrustedApplication

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt eine vertrauenswürdige Anwendung aus dem zugehörigen vertrauenswürdigen Dienst.

Syntax

Remove-CsTrustedApplication -Identity <ExternalApplicationIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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 wird eine vertrauenswürdige Antwort aus einem vertrauenswürdigen Anwendungspool entfernt. Beachten Sie, dass nicht die Anwendung selbst, sondern nur die Zuordnung mit dem vertrauenswürdigen Anwendungspool und Dienst entfernt wird.

Wenn Sie eine vertrauenswürdige Anwendung mit diesem Cmdlet entfernen, 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 die Anwendung residiert, 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 Anzeigen einer bestehenden Anwendung durch Aufrufen des Cmdlets Get-CsTrustedApplication 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 Remove-CsTrustedApplication lokal ausführen: RTCUniversalServerAdmins. 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 "Remove-CsTrustedApplication\b"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

ExternalApplicationIdentity

Die eindeutige ID der vertrauenswürdigen Anwendung, die aus dem vertrauenswürdigen Anwendungspool entfernt wird. 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.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.Xds.DisplayTrustedApplication-Objekt. Akzeptiert eine weitergeleitete Eingabe von vertrauenswürdigen Anwendungsobjekten.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.Xds.DisplayTrustedApplication" entfernt.

Beispiel

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

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

In diesem Beispiel wird die vertrauenswürdige Anwendung mit dem Identitätswert "TrustPool.litwareinc.com/tapp2" aus dem zugehörigen vertrauenswürdigen Dienst entfernt.

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

Get-CsTrustedApplication -Filter *trust* | Remove-CsTrustedApplication

In Beispiel 2 werden alle vertrauenswürdigen Anwendungen entfernt, deren Identitätswerte die Zeichenfolge "trust" enthalten. Der Befehl ruft zunächst Get-CsTrustedApplication auf und gibt den Filterwert "*trust*" weiter. Dieser Befehl ruft alle vertrauenswürdigen Anwendungen ab, die die Zeichenfolge "trust" im Identitätswert enthalten. Die Auflistung der abgerufenen vertrauenswürdigen Anwendungen wird dann an das CmdletRemove-CsTrustedApplication weitergeleitet, das jede Anwendung als vertrauenswürdige Anwendung entfernt. (Beachten Sie, dass nicht die Anwendung selbst, sondern nur die Zuordnung mit dem vertrauenswürdigen Anwendungspool und Dienst entfernt wird.)