New-CsTrustedApplication
Letztes Änderungsdatum des Themas: 2012-03-26
Fügt einem Pool eine vertrauenswürdige Anwendung hinzu.
Syntax
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>]]
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 einem Pool mit vertrauenswürdigen Anwendungen eine vertrauenswürdige Anwendung hinzugefügt. Zudem wird dem externen Dienst, der die Anwendung ausführt, ein Port zugewiesen.
Vertrauenswürdige Anwendungen müssen Globally Routable User Agent URIs (GRUUs) zugeordnet sein, d. h. sowohl Dienst-GRUUs als auch Computer-GRUUs. Dieses Cmdlet generiert diese Werte automatisch basierend auf den Computern und Diensten, die dem Pool zugeordnet sind, in dem diese Anwendung gehostet wird.
Wenn Sie dieses Cmdlet verwenden, um eine vertrauenswürdige Anwendung zu erstellen, müssen Sie für den Parameter "Identity" oder für die Parameter "ApplicationId" und "TrustedApplicationPoolFqdn" Werte angeben. "Identity" entspricht "TrustedApplicationPoolFqdn", gefolgt von einem Schrägstrich (/) und dem Parameter "ApplicationId". Beispiel: "TrustPool.litwareinc.com/tapp2", wobei "TrustPool.litwareinc.com" der Wert des Parameters "TrustedApplicationPoolFqdn" und "tapp2" der Wert des Parameters "ApplicationId" ist.
Beachten Sie, dass Sie bei der Eingabe einer Anwendungs-ID (als Teil des Parameters "Identity" oder in Form des Parameters "ApplicationId") nur den Namen der Anwendung eingeben müssen. Die vollständige Anwendungs-ID erhält automatisch das Präfix "urn:application:". Beispiel: Wenn Sie für "ApplicationId" den Wert "tapp2" eingeben, wird die ID als "urn:application:tapp2" gespeichert. Und wenn Sie für den Parameter "Identity" den Wert "TrustPool.litwareinc.com/tapp2" eingeben, wird der Identitätswert im System als "TrustPool.litwareinc.com/urn:application:tapp2" gespeichert.
Wenn Sie mit diesem Cmdlet den Portwert festlegen, wird der Port nicht vom Cmdlet geöffnet. Sie müssen den Port in der Windows-Firewall und anderen Unternehmensfirewalls öffnen, damit die vertrauenswürdige Anwendung Netzwerke außerhalb der Firewall kontaktieren kann.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsTrustedApplication\b"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
ExternalApplicationIdentity |
Eine eindeutige ID für die vertrauenswürdige Anwendung im Pool. Identitätswerte müssen im Format <Pool-FQDN>/<Anwendungs-ID> eingegeben werden: "Pool-FQDN" ist der vollqualifizierte Domänenname (FQDN, Fully Qualified Domain Name) des Pools, in dem sich die Anwendung befindet, und "Anwendungs-ID" der Name der Anwendung. Die Anwendungs-ID muss für einen bestimmten Pool eindeutig sein. Wenn Sie einen Identitätswert eingeben, können Sie keine Werte für die Parameter "ApplicationId" oder "TrustedApplicationPoolFqdn" festlegen. |
ApplicationId |
Erforderlich |
Zeichenfolge |
Der Name der Anwendung. Dabei muss es sich um eine im Pool eindeutige Zeichenfolge handeln, die im Parameter "TrustedApplicationPoolFqdn" festgelegt wird. Die Zeichenfolge darf keine Leerzeichen enthalten. Wenn Sie für "ApplicationId" einen Wert angeben, müssen Sie auch einen Wert für den Parameter "TrustedApplicationPoolFqdn" festlegen. Sie können die Parameter "ApplicationId" und "Identity" nicht in demselben Befehl verwenden. |
Port |
Erforderlich |
Int32 |
Die von der Anwendung verwendete Portnummer. Der Port muss in einem bestimmten Pool eindeutig sein. Das heißt, es kann keine andere Anwendung für den angegebenen Pool definiert werden, die den gleichen Port verwendet. |
TrustedApplicationPoolFqdn |
Erforderlich |
Zeichenfolge |
Der FQDN des Pools mit vertrauenswürdigen Anwendungen, in dem sich die Anwendung befindet. Wenn Sie einen Wert für den Parameter "TrustedApplicationPoolFqdn" angeben, müssen Sie auch einen Wert für "ApplicationId" festlegen. Sie können jedoch keinen Wert für den Parameter "Identity" angeben. |
EnableTcp |
Optional |
Switch-Parameter |
Legt fest, dass die vertrauenswürdige Anwendung das TCP (Transmission Control Protocol) verwendet. Verwenden Sie diesen Parameter nur, wenn die vertrauenswürdige Anwendung keine Microsoft Unified Communications Managed-API (UCMA)-Anwendung ist, da UCMA-Anwendungen nur das MTLS-Protokoll (Mutual Transport Layer Security) unterstützen. Wenn Sie den Parameter "Force" nicht mit dem Parameter "EnableTcp" festlegen, wird eine Bestätigungsaufforderung angezeigt, bevor die neue vertrauenswürdige Anwendung erstellt wird. |
LegacyApplicationName |
Optional |
Zeichenfolge |
Verwenden Sie diesen Parameter nur, wenn die Anwendung von einer Microsoft Office Communications Server 2007 R2-Bereitstellung migriert wird. Dieser Wert muss mit dem GRUU-Typ der Office Communications Server 2007 R2-Version der Anwendung identisch sein, damit eine Zusammenarbeit möglich ist. Beachten Sie, dass das Festlegen des Parameters "ApplicationId" auf den GRUU-Typ ausreicht, um eine Zusammenarbeit der Anwendungen zu ermöglichen. Wenn der GRUU-Typ der Office Communications Server 2007 R2-Anwendung jedoch Zeichen enthält, die in "ApplicationId" unzulässig sind, muss dieser Wert im Parameter "LegacyApplicationName" angegeben werden. Wenn Sie für diesen Parameter keinen Wert angeben, wird der Wert für die Anwendungs-ID automatisch eingefügt (ohne Präfix "urn:application:"). |
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
Keine.
Rückgabetypen
Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.Xds.DisplayTrustedApplication".
Beispiel
-------------------------- Beispiel 1 --------------------------
New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000
In diesem Beispiel wird eine vertrauenswürdige Anwendung mit der Anwendungs-ID "tapp1" erstellt. Mit dem Parameter "TrustedApplicationPoolFqdn" wird der Pool mit vertrauenswürdigen Anwendungen festgelegt, in dem sich diese Anwendung befindet, d. h. in diesem Fall der Pool mit dem FQDN "TrustPool.litwareinc.com". Es muss auch ein Port für die Anwendung festgelegt werden, in diesem Beispiel der Port 6000. Beachten Sie, dass beim Ausführen des Cmdlets durch die Angabe der Parameter "ApplicationId" und "TrustedApplicationPoolFqdn" automatisch ein Identitätswert generiert wird, mit dem diese Anwendung später abgerufen, geändert oder entfernt werden kann.
-------------------------- Beispiel 2 --------------------------
New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100
In diesem Beispiel wird eine vertrauenswürdige Anwendung mit dem Identitätswert "TrustPool.litwareinc.com/tapp2" an Port 6100 erstellt. Beachten Sie das Format des Parameters "Identity". Dieser Wert muss das Format <FQDN des Pools mit vertrauenswürdigen Anwendungen>/<Anwendungs-ID> haben.
Siehe auch
Weitere Ressourcen
Remove-CsTrustedApplication
Set-CsTrustedApplication
Get-CsTrustedApplication