• Artikel

Set-CsTrustedApplication

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert die Einstellungen für eine vertrauenswürdige Anwendung.

Syntax

Set-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Port <Int32>] [-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 können Sie die Portnummer des externen Diensts ändern, der die Anwendung ausführt.

Wenn Sie eine vertrauenswürdige Anwendung mit diesem Cmdlet ändern, 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 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 Set-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 –matches "Set-CsTrustedApplication\b"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

ExternalApplicationIdentity

Eine eindeutige ID für die vertrauenswürdige Anwendung, die geändert 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.

Port

Optional

Int32

Die von der Anwendung verwendete Portnummer.

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" geändert.

Beispiel

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

Set-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6200

In diesem Beispiel wird der Port für die vertrauenswürdige Anwendung mit dem Identitätswert "TrustPool.litwareinc.com/tapp2" in den Port 6200 geändert. Hierzu wird dem Cmdlet Set-CsTrustedApplication der Identitätswert "TrustPool.litwareinc.com/tapp2" übergeben. Dieser Identitätswert umfasst den Namen des Pools, in dem sich die Anwendung befindet, gefolgt von dem Namen (oder der ID) der Anwendung. Daraufhin wird der Parameter "Port" mit dem Wert 6200 angegeben, wodurch dieser Wert geändert wird.