• Artikel

New-CsTrustedApplicationEndpoint

 

Letztes Änderungsdatum des Themas: 2012-03-25

Erstellt einen neuen Endpunktkontakt für eine vertrauenswürdige Anwendung.

Syntax

New-CsTrustedApplicationEndpoint -ApplicationId <String> -TrustedApplicationPoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Ein vertrauenswürdiger Anwendungsendpunkt ist ein Active Directory-Kontaktobjekt, mit dem Anrufe an eine vertrauenswürdige Anwendung weitergeleitet werden können. Mit diesem Cmdlet wird ein neues Endpunktkontaktobjekt für eine angegebene Anwendung in Active Directory-Domänendienste (AD DS) erstellt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsTrustedApplicationEndpoint 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-CsTrustedApplicationEndpoint"}

Parameter

Parameter Erforderlich Typ Beschreibung

ApplicationId

Erforderlich

Zeichenfolge

Die Anwendungs-ID der vertrauenswürdigen Anwendung, für die der Endpunktkontakt erstellt wird. Eine Anwendung mit dieser ID muss bereits vorhanden sein. Beachten Sie, dass Sie nur den Namensteil der Anwendungs-ID aufnehmen können, die Präfixinformationen müssen nicht unbedingt angegeben werden. Wenn die Anwendungs-ID z. B. "urn:application:TrustedApp1" lautet, muss nur die Zeichenfolge "TrustedApp1" an diesen Parameter übergeben werden.

TrustedApplicationPoolFqdn

Erforderlich

Fqdn

Der vollqualifizierte Domänenname (FQDN) des vertrauenswürdigen Anwendungspools, der der Anwendung zugeordnet ist. Um den Endpunkt erstellen zu können, muss die Anwendung diesem Pool bereits zugeordnet sein.

SipAddress

Optional

Zeichenfolge

Eine SIP-Adresse für das neue Kontaktobjekt. Wenn Sie für diesen Parameter keinen Wert angeben, wird automatisch eine SIP-Adresse mit dem Format "sip:RtcApplication-<GUID>.<Domäne>" generiert. Beispiel: sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Die Domäne ist die Standard-SIP-Domäne.

DisplayName

Optional

Zeichenfolge

Der Anzeigename des Endpunktkontaktobjekts.

DisplayNumber

Optional

Zeichenfolge

Die im Adressbuch angezeigte Telefonnummer des Kontakts.

LineURI

Optional

Zeichenfolge

Die Telefonnummer des Kontakts. Die Nummer muss mit dem Format "TEL:<Nummer>" angegeben werden. Beispiel: TEL:+14255551212.

PrimaryLanguage

Optional

Int32

Die primäre Sprache, die für die vertrauenswürdige Anwendung verwendet wird. Die Sprache muss über einen gültigen Sprachcode konfiguriert werden, z. B. "en-US" (US-Englisch), "fr-FR" (Französisch) etc.

SecondaryLanguages

Optional

Int32[]

Eine Auflistung von Sprachen, die auch für vertrauenswürdige Anwendungen verwendet werden können. Werte müssen als durch Trennzeichen getrennte Werteliste von Sprachcodes konfiguriert werden. Beispielsweise werden durch die folgende Syntax kanadisches Französisch und Französisch als sekundäre Sprachen festgelegt: -SecondaryLanguages "fr-CA","fr-FR".

Tenant

Optional

GUID

Die GUID (Globally Unique Identifier) des Objekts. Dieser Parameter wird für lokale Bereitstellungen nicht verwendet.

PassThru

Optional

Switch-Parameter

Gibt die Ergebnisse dieses Befehls zurück. Bei Ausführung dieses Cmdlets wird das neu erstellte Objekt angezeigt. Da diese Ausgabe durch den Parameter nur wiederholt wird, ist die Verwendung des Parameters nicht nötig.

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.ADConnect.Schema.OCSADApplicationContact".

Beispiel

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com

In diesem Beispiel wird ein vertrauenswürdiger Anwendungsendpunkt für die Anwendung mit der ID "tapp1" im Pool "TrustPool.litwareinc.com" erstellt. "ApplicationID" und "TrustedApplicationPoolFqdn" sind die einzigen erforderlichen Parameter, um einen vertrauenswürdigen Anwendungsendpunkt zu erstellen. Bedenken Sie jedoch, dass automatisch eine SIP-Adresse für den Kontakt generiert wird, wenn nur für diese beiden Parameter ein Wert zugewiesen wird. Um sicherzustellen, dass die SIP-Adresse eindeutig ist, umfasst die automatisch generierte Adresse eine GUID (Globally Unique Identifier). Diese Adresse weist das folgende Format auf: sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com. Informationen zur Verwendung einer SIP-Adresse mit besserer Lesbarkeit finden Sie in Beispiel 2.

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

New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -SipAddress sip:endpoint1@litwareinc.com

Beispiel 2 ist insofern mit Beispiel 1 identisch, als ein vertrauenswürdiger Anwendungsendpunkt für die Anwendung mit der ID "tapp1" im Pool "TrustPool.litwareinc.com" erstellt wird. Im Gegensatz zu Beispiel 1 wird zum Erstellen des Endpunkts jedoch ein weiterer Parameter aufgenommen: SipAddress. Auf diese Weise wird die Generierung einer SIP-Adresse durch das System verhindert, und stattdessen wird die Adresse "endpoint1@litwareinc.com" angegeben.