Freigeben über

  • Artikel

Get-CsTrustedApplicationEndpoint

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft Informationen zu einem oder mehreren vertrauenswürdigen Anwendungsendpunkten ab.

Syntax

Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]

Detaillierte Beschreibung

Ein vertrauenswürdiger Anwendungsendpunkt ist ein Active Directory-Kontaktobjekt, mit dem Anrufe an eine vertrauenswürdige Anwendung weitergeleitet werden können. Dieses Cmdlet ruft vorhandene Endpunktkontaktobjekte in Active Directory-Domänendienste (AD DS) ab.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsTrustedApplicationEndpoint lokal auszufü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-CsTrustedApplicationEndpoint"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

UserIdParameter

Identitätswert (Distinguished Name), SIP-Adresse oder Anzeigename des Anwendungsendpunkts, der geändert werden soll.

Filter

Optional

Zeichenfolge

Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Microsoft Lync Server 2010-spezifischen Attributen gefiltert werden. Beispielsweise können Sie die zurückgegebenen Daten auf Kontakte einschränken, deren Anzeigenamen oder SIP-Adressen einem bestimmten Platzhaltermuster entsprechen.

Der Parameter "Filter" verwendet dieselbe Windows PowerShell-Filterungssyntax wie das Cmdlet Where-Object. Mit folgendem Filter werden beispielsweise nur Kontakte zurückgegeben, die für Enterprise-VoIP aktiviert wurden: {EnterpriseVoiceEnabled -eq $True}. Dabei ist "EnterpriseVoiceEnabled" das Active Directory-Attribut, "-eq" der Vergleichsoperator ("equal to") und "$True" (eine integrierte Windows PowerShell-Variable) der Filterwert.

ApplicationId

Optional

Zeichenfolge

Die Anwendungs-ID der vertrauenswürdigen Anwendung für den Endpunkt, die Sie abrufen möchten.

Credential

Optional

PSCredential

Alternative Anmeldeinformationen zum Abrufen des Endpunkts. Sie können ein PSCredential-Objekt durch Aufrufen des Cmdlets Get-Credential abrufen.

DomainController

Optional

FQDN

Ermöglicht die Angabe eines Domänencontrollers. Wenn kein Domänencontroller angegeben ist, wird der erste verfügbare Domänencontroller verwendet.

OU

Optional

OUIdParameter

Die Organisationseinheit (Organizational Unit, OU), in der sich der Endpunkt befindet.

ResultSize

Optional

Unbeschränkt

Die maximale Anzahl von Endpunkteinträgen, die abgerufen werden soll.

TrustedApplicationPoolFqdn

Optional

Zeichenfolge

Der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) des vertrauenswürdigen Anwendungspools, der der Anwendung für den abzurufenden Endpunkt zugeordnet ist.

Eingabetypen

Zeichenfolge. Akzeptiert einen weitergeleiteten Zeichenfolgenwert, der den Identitätswert eines Benutzerkontos repräsentiert.

Rückgabetypen

Ruft ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact" ab.

Beispiel

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

Get-CsTrustedApplicationEndpoint

In diesem Beispiel werden Informationen zu allen vertrauenswürdigen Anwendungsendpunkten abgerufen, die in der Lync Server 2010-Bereitstellung definiert sind.

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

Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"

In Beispiel 2 werden Informationen über den Anwendungsendpunkt-Kontakt mit der SIP-Adresse "endpoint1@litwareinc.com" abgerufen. Beachten Sie, dass das Präfix "sip:" bei Verwendung einer SIP-Adresse als Identitätswert erforderlich ist.

-------------------------- Beispiel 3 --------------------------

Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}

In Beispiel 3 werden alle vertrauenswürdigen Anwendungsendpunkte abgerufen, die an beliebiger Stelle im Anzeigenamen die Zeichenfolge "endpoint" enthalten. Hierzu verwendet der Befehl den Parameter "Filter". Der Wert des Filterparameters zum Auffinden von Endpunktobjekten, deren Anzeigename (DisplayName) die Zeichenfolge "endpoint" enthält (die Platzhalterzeichenfolge "*endpoint*" gibt an, dass vor oder nach der Zeichenfolge "endpoint" beliebige Zeichen im Anzeigenamen enthalten sein können).

-------------------------- Beispiel 4 --------------------------

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn

In Beispiel 4 werden alle vertrauenswürdigen Anwendungsendpunkte zurückgegeben, die der Anwendung "tapp2" zugeordnet sind. Dies wird erreicht, indem die ID "tapp2" an den Parameter "ApplicationId" übergeben wird. Beachten Sie, dass kein Pool-FQDN angegeben wurde. Falls also eine Anwendung mit der ID "tapp2" in mehr als einem Pool vorhanden ist, werden die Endpunkte für sämtliche dieser Anwendungen abgerufen. Im nächsten Befehlsabschnitt werden die zurückgegebenen Objekte an das Cmdlet Select-Object weitergeleitet, das nur die Eigenschaften "SipAddress", "DisplayName" und "OwnerUrn" dieser Objekte anzeigt.