• Artikel

Get-CsWebServiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den in Ihrer Organisation verwendeten Webdienste-Konfigurationseinstellungen zurück.

Syntax

Get-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Viele Microsoft Lync Server 2010-Komponenten sind webbasiert: Diese Komponenten verwenden zum Ausführen der Aufgaben entweder Webdienste oder Webseiten. Benutzer nutzen beispielsweise einen Webdienst, um im Adressbuch nach neuen Kontakten zu suchen oder um die Gruppenerweiterung zu verwenden, mit der einzelne Mitglieder einer Verteilergruppe angezeigt werden können. Gleichermaßen nutzen Komponenten, von Einwahlkonferenzen bis hin zu Microsoft Lync Server 2010-Systemsteuerung, Webseiten als Schnittstelle zwischen Lync Server 2010 und Benutzern.

Die CsWebServiceConfiguration-Cmdlets ermöglichen es Administratoren, die Webdienste-Konfigurationseinstellungen innerhalb der Organisation zu verwalten. Dazu gehören die Verwaltung der Gruppenerweiterung, Zertifikatseinstellungen und zulässigen Authentifizierungsmethoden. Da Sie unterschiedliche Einstellungen auf globaler Ebene sowie auf Standort- und Dienstebene (allerdings nur für den Dienst für die Webdienste) konfigurieren können, können Sie die Funktionen der Webdienste an die Anforderungen unterschiedlicher Benutzer und Standorte anpassen.

Mit dem Cmdlet Get-CsWebServiceConfiguration können Sie ausführliche Informationen zu den derzeit in Ihrer Organisation verwendeten Webdienste-Konfigurationseinstellungen zurückgeben.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID der zurückzugebenden Webdienste-Konfigurationseinstellungen. Verwenden Sie diese Syntax, um die globalen Einstellungen zurückzugeben: -Identity global. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierten Einstellungen zurückzugeben: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um die auf Dienstebene konfigurierten Einstellungen zurückzugeben: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Sie können die Parameter "Filter" und "Identity" nicht in demselben Befehl verwenden. Wenn Sie keinen der beiden Parameter festlegen, werden beim Ausführen von Get-CsWebServiceConfiguration alle derzeit in Ihrer Organisation verwendeten Webdienste-Einstellungsauflistungen zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der Auflistung (oder Auflistungen) der Webdienste-Konfigurationseinstellungen, die zurückgegeben werden soll(en). Verwenden Sie beispielsweise folgende Syntax, um alle auf Standortebene konfigurierten Einstellungen zurückzugeben: -Filter "site:*".

Sie können die Parameter "Filter" und "Identity" nicht in demselben Befehl verwenden.

LocalStore

Optional

Switch-Parameter

Ruft die Daten zur Webdienstekonfiguration aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsWebServiceConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsWebServiceConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings" zurückgegeben.

Beispiel

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

Get-CsWebServiceConfiguration

Mit dem vorstehenden Befehl werden Informationen zu allen derzeit in Ihrer Organisation verwendeten Webdienste-Konfigurationseinstellungen zurückgegeben.

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

Get-CsWebServiceConfiguration -Identity site:Redmond

Der Befehl in Beispiel 2 gibt Informationen zu den Webdienste-Konfigurationseinstellungen mit dem Identitätswert "site:Redmond" zurück.

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

Get-CsWebServiceConfiguration -Filter "site:*"

In Beispiel 3 werden alle Webdienste-Konfigurationseinstellungen zurückgegeben, die auf Standortebene zugewiesen wurden. Hierzu wird beim Aufrufen von Get-CsWebServiceConfiguration der Parameter "Filter" angegeben; durch Festlegen des Filterwerts "site:*" wird sichergestellt, dass nur die Einstellungen zurückgegeben werden, deren Identitätswert mit der Zeichenfolge "site:" beginnt.

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

Get-CsWebServiceConfiguration | Where-Object {$_.UsePinAuth -eq $False}

Mit dem Befehl in Beispiel 4 werden alle Webdienste-Konfigurationseinstellungen zurückgegeben, die keine PIN-Authentifizierung zulassen. Hierzu wird zunächst Get-CsWebServiceConfiguration aufgerufen, um alle derzeit verwendeten Webdienste-Konfigurationseinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "UsePinAuth" den Wert "False" aufweist.

-------------------------- Beispiel 5 --------------------------

Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}

Mit dem vorstehenden Befehl werden alle Webdienste-Konfigurationseinstellungen zurückgegeben, bei denen der Wert für die maximale Gruppenerweiterung größer als 100 ist. Hierzu ruft der Befehl zunächst Get-CsWebServiceConfiguration auf, um alle derzeit verwendeten Webdienste-Konfigurationseinstellungen zurückzugeben. Diese Informationen werden dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxGroupSizeToExpand" größer als 100 ist.