Get-CsAccessEdgeConfiguration
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den Konfigurationseinstellungen für Computer in Ihrer Organisation zurück, auf denen der Zugriffs-Edgedienst ausgeführt wird. (Diese werden auch als Zugriffs-Edgeserver bezeichnet). Mit Zugriffs-Edgeservern können Benutzer außerhalb des internen Netzwerks mit Benutzern des internen Netzwerks kommunizieren.
Syntax
Get-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAccessEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Zugriffs-Edgeserver werden auch als Zugriffsproxyserver bezeichnet und ermöglichen Ihnen die Erweiterung der Microsoft Lync Server 2010-Funktionen auf Personen, die nicht bei Ihrem internen Netzwerk angemeldet sind. Wenn Sie z. B. über Remotebenutzer verfügen (authentifizierte Benutzer, die sich nicht über das interne Netzwerk, sondern über das Internet bei Lync Server 2010 anmelden), muss ein Zugriffs-Edgeserver eingerichtet werden. Edgeserver werden ferner benötigt, wenn ein Partnerverbund mit einer anderen Organisation eingerichtet werden soll oder wenn Sie Benutzern die Berechtigung zum Kommunizieren mit Benutzern zuweisen möchten, die über Konten bei einem öffentlichen Instant Messaging-Dienst wie Yahoo!, AOL oder MSN verfügen. Zugriffs-Edgeserver werden im Umkreisnetzwerk bereitgestellt und zum Herstellen und Überprüfen von SIP-Verbindungen zwischen Benutzern innerhalb und außerhalb des internen Netzwerks verwendet.
In Lync Server werden Zugriffs-Edgeserver über eine einzige, globale Auflistung von Konfigurationseinstellungen verwaltet. Mit dem Cmdlet Get-CsAccessEdgeConfiguration können Informationen zu diesen globalen Einstellungen zurückgegeben werden. Beachten Sie, dass die von Get-CsAccessEdgeConfiguration zurückgegebenen Eigenschaftswerte abhängig vom Routingtyp variieren, der für Ihre Edgeserver konfiguriert ist. Einzelheiten finden Sie im Hilfethema Set-CsAccessEdgeConfiguration.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsAccessEdgeConfiguration lokal ausführen: RTCUniversalUserAdmins, 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 "Get-CsAccessEdgeConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eindeutige ID der zurückzugebenden Zugriffsedge-Konfigurationseinstellungen. Da nur eine einzige, globale Instanz dieser Einstellungen vorhanden sein kann, muss die Identität beim Aufruf von Get-CsAccessEdgeConfiguration nicht angegeben werden. Sie können jedoch die folgende Syntax verwenden, um die globalen Einstellungen abzurufen: -Identity global. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Verwendung von Platzhalterzeichen, wenn Sie die zurückzugebenden Konfigurationseinstellungen des Zugriffs-Edgeservers angeben. Da nur eine einzige, globale Instanz dieser Einstellungen vorhanden sein kann, ist die Verwendung des Parameters "Filter" wenig sinnvoll. Zum Abrufen der globalen Einstellungen kann bei Bedarf jedoch eine Syntax wie die folgende verwendet werden: -Identity "g*". |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Daten zur Zugriffs-Edgekonfiguration aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine. Get-CsAccessEdgeConfiguration akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Get-CsAccessEdgeConfiguration gibt Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDnsSrvRouting" oder des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDefaultRoute" zurück.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsAccessEdgeConfiguration
In Beispiel 1 wird die grundlegende Verwendung von Get-CsAccessEdgeConfiguration gezeigt: Beim Aufruf des Cmdlets ohne zusätzliche Parameter werden alle Eigenschaftswerte für Ihre Implementierung des Zugriffs-Edgeservers zurückgegeben. Beachten Sie, dass die Parameter "Identity" und "Filter" nicht angegeben werden müssen, da nur ein einziger Satz an Konfigurationsdaten für den Zugriffs-Edgeserver vorhanden ist.
-------------------------- Beispiel 2 ------------------------
Get-CsAccessEdgeConfiguration | Select-Object Allow*
Über den vorstehenden Befehl werden lediglich drei Eigenschaftswerte für Ihre Konfiguration des Zugriffs-Edgeservers zurückgegeben: "AllowAnonymousUsers", "AllowFederatedUsers" und "AllowOutsideUsers". Hierzu verwendet der Befehl zunächst Get-CsAccessEdgeConfiguration, um alle Eigenschaftswerte des Zugriffs-Edgeservers zurückzugeben. Diese Informationen werden anschließend an das Cmdlet Select-Object weitergeleitet, das lediglich die Eigenschaften auswählt, die mit dem Zeichenfolgenwert "Allow" beginnen. Dies sind die einzigen Eigenschaftswerte, die auf dem Bildschirm angezeigt werden.
-------------------------- Beispiel 3 ------------------------
(Get-CsAccessEdgeConfiguration).EnablePartnerDiscovery
Über den Befehl in Beispiel 3 wird der Wert einer einzigen Konfigurationseigenschaft des Zugriffs-Edgeservers zurückgegeben: EnablePartnerDiscovery. Hierzu wird zunächst Get-CsAccessEdgeConfiguration aufgerufen, um sämtliche Konfigurationseigenschaftswerte des Zugriffs-Edgeservers zurückzugeben. Der Aufruf von Get-CsAccessEdgeConfiguration ist in Klammern eingeschlossen. Dadurch wird sichergestellt, dass Windows PowerShell diesen Befehl abschließt, bevor weitere Aufgaben ausgeführt werden. Nach dem Zurückgeben aller Eigenschaftswerte wird zum Anzeigen des Werts einer einzelnen Eigenschaft die standardmäßige punktierte Schreibweise (Objektname, auf den ein Punkt und anschließend der Name einer Eigenschaft folgt) verwendet: EnablePartnerDiscovery.