Get-CsApplicationEndpoint
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft Endpunkte für den Anwendungsdienst ab.
Syntax
Get-CsApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-PoolFqdn <String>] [-ResultSize <Unlimited>]
Detaillierte Beschreibung
Dieses Cmdlet ruft einen oder mehrere Anwendungskontakte aus Active Directory-Domänendienste (AD DS) ab. Diese Objekte werden in Active Directory im Container "Anwendungskontakte" des RTC-Diensts gespeichert.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsApplicationEndpoint lokal ausfü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-CsApplicationEndpoint"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
UserIdParameter |
Identität, SIP-Adresse oder Anzeigename des abzurufenden Anwendungsendpunkts. Die Identität umfasst den DN (Distinguished Name) des Endpunkts. Dieser enthält in der Regel eine GUID (Globally Unique Identifier) als Teil des allgemeinen Namens (Common Name, CN). Beispiel: CN={8811fefe-e0bb-4fab-ae39-7aaeddd423dc},CN=Application Contacts,CN=RTC Service,CN=Services,CN=Configuration,DC=Vdomain,DC=com. |
ApplicationId |
Optional |
Zeichenfolge |
Die Anwendungs-ID des Anwendungsendpunkts, den Sie abrufen möchten. Die Anwendungs-ID ist der Wert der Eigenschaft "OwnerUrn" für den Endpunkt. Wenn die Eigenschaft "OwnerUrn" beispielsweise den Wert "urn:application:Caa" aufweist, lautet die Anwendungs-ID "urn:application:Caa". Zum Abrufen des Endpunkts ist es jedoch ausreichend, nur das Suffix einzugeben, in diesem Fall "Caa". Beispiel: -ApplicationId Caa |
Credential |
Optional |
PSCredential |
Alternative Anmeldeinformationen, mit denen die Get-Operation ausgeführt wird. Sie können ein Objekt "PSCredential" abrufen, indem Sie das Windows PowerShell-Cmdlet Get-Credential aufrufen. |
DomainController |
Optional |
Fqdn |
Ermöglicht die Angabe eines Domänencontrollers. Wenn kein Domänencontroller angegeben ist, wird der erste verfügbare Domänencontroller verwendet. |
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. |
OU |
Optional |
OUIdParameter |
Die Organisationseinheit (Organizational Unit, OU), in der sich der Endpunkt befindet. |
PoolFqdn |
Optional |
Zeichenfolge |
Der vollqualifizierte Domänenname (FQDN) des Pools, in dem sich der Endpunkt befindet. |
ResultSize |
Optional |
Unbeschränkt |
Die maximale Anzahl von Endpunkteinträgen, die abgerufen werden soll. |
Eingabetypen
Zeichenfolge. Akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität des Anwendungspunkts repräsentiert.
Rückgabetypen
Ruft ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact" ab.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsApplicationEndpoint
In diesem Beispiel werden Informationen zu allen Anwendungsendpunkten abgerufen, die in der Lync Server 2010-Bereitstellung definiert sind.
-------------------------- Beispiel 2 ------------------------
Get-CsApplicationEndpoint -Identity "Call Park Service Contact"
In Beispiel 2 werden Informationen zum Anwendungsendpunktkontakt mit dem Anzeigenamen "Call Park Service Contact" abgerufen.
-------------------------- Beispiel 3 ------------------------
Get-CsApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
In Beispiel 3 werden alle 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-CsApplicationEndpoint -ApplicationId tapp2 | Select-Object Identity, SipAddress, DisplayName, OwnerUrn
In Beispiel 4 werden alle Anwendungsendpunkte zurückgegeben, die der Anwendung "urn:application: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 "Identity", "SipAddress", "DisplayName" und "OwnerUrn" dieser Objekte anzeigt.