Freigeben über


Get-CsUserServicesConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den in Ihrer Organisation verwendeten Konfigurationseinstellungen für Benutzerdienste zurück. Der Dienst für Benutzerdienste sorgt für die Verwaltung von Anwesenheitsinformationen und Konferenzen.

Syntax

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

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

Detaillierte Beschreibung

Microsoft Lync Server 2010 benötigt den Dienst für Benutzerdienste zum Verwalten von Anwesenheitsinformationen zu Benutzern sowie zum Verwalten von Besprechungen und Konferenzen. Die CsUserServicesConfiguration-Cmdlets wiederum werden zum Verwalten der Einstellungen für Benutzerdienste auf globaler, Standort- und Dienstebene verwendet. (Beachten Sie, dass der Dienst für Benutzerdienste als einziger Dienst die Konfigurationseinstellungen für Benutzerdienste hosten kann.) Anhand dieser Einstellungen können folgende Informationen festgelegt werden: die Anzahl der für einen Benutzer zulässigen Kontakte, die Anzahl von Besprechungen, die zu einem bestimmten Zeitpunkt für einen Benutzer geplant sein können, und die Zeitspanne, für die eine bestimmte Besprechung aktiv bleiben kann.

Das Cmdlet Get-CsUserServicesConfiguration bietet Administratoren eine Möglichkeit zum Abrufen von Informationen zu beliebigen (oder allen) derzeit verwendeten Konfigurationseinstellungen für Benutzerdienste.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zurückzugebenden Konfigurationseinstellungen für Benutzerdienste. Verwenden Sie folgende 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 Einstellungen auf Dienstebene zurückzugeben: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Bei Auslassung dieses Parameters werden mit Get-CsUserServicesConfiguration alle derzeit in Ihrer Organisation verwendeten Konfigurationseinstellungen für Benutzerdienste zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhaltern beim Abrufen einer oder mehrerer Auflistungen von Konfigurationseinstellungen für Benutzerdienste. Verwenden Sie beispielsweise folgende Syntax, um alle auf der Standortebene konfigurierten Einstellungen zurückzugeben. -Filter "site:*". Verwenden Sie folgende Syntax, um alle auf der Dienstebene konfigurierten Einstellungen zurückzugeben. -Filter "service:*".

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsUserServicesConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsUserServicesConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings" zurückgegeben.

Beispiel

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

Get-CsUserServicesConfiguration

Der Befehl in Beispiel 1 gibt alle derzeit in der Organisation verwendeten Konfigurationseinstellungen für Benutzerdienste zurück. Dazu wird Get-CsUserServicesConfiguration ohne Parameter aufgerufen.

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

Get-CsUserServicesConfiguration -Identity site:Redmond

In Beispiel 2 wird nur eine Auflistung von Konfigurationseinstellungen für Benutzerdienste zurückgegeben: die Auflistung mit dem Identitätswert "site:Redmond". Da Identitätswerte eindeutig sein müssen, kann dieser Befehl immer nur ein Element zurückgeben.

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

Get-CsUserServicesConfiguration -Filter "service:*"

In Beispiel 3 wird eine Auflistung aller Konfigurationseinstellungen für Benutzerdienste zurückgegeben, die auf Dienstebene gelten. Hierzu wird Get-CsUserServicesConfiguration zusammen mit dem Parameter "-Filter" aufgerufen. Mit dem Filterwert "service:*" werden die zurückgegebenen Daten auf Einstellungen beschränkt, deren Identitätswert mit der Zeichenfolge "service:" beginnt. Diese Einstellungen sind auf Dienstebene konfiguriert.

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

Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250}

Der vorstehende Befehl gibt alle Konfigurationseinstellungen für Benutzerdienste zurück, die Benutzern über 250 Kontakte erlauben. Hierzu ruft der Befehl zunächst Get-CsUserServicesConfiguration ohne zusätzliche Parameter auf, um eine Auflistung aller derzeit für die Verwendung konfigurierten Konfigurationseinstellungen für Benutzerdienste zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxContacts" größer als 250 ist.

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

Get-CsUserServicesConfiguration | Where-Object {$_.AnonymousUserGracePeriod -gt "00:10:00"}

In Beispiel 5 werden Informationen für die Konfigurationseinstellungen für Benutzerdienste zurückgegeben, bei denen die Kulanzfrist für anonyme Benutzer länger als 10 Minuten ist. Hierzu ruft der Befehl zunächst Get-CsUserServicesConfiguration ohne zusätzliche Parameter auf. Daraufhin wird eine Auflistung aller in der Organisation verwendeten Konfigurationseinstellungen für Benutzerdienste zurückgegeben. Diese Auflistung wird dann an Where-Object weitergeleitet, das nur die Einstellungen auswählt, deren Eigenschaft "AnonymousUserGracePeriod" auf mehr als 10 Minuten (0 Stunden: 10 Minuten: 0 Sekunden) festgelegt ist.