Freigeben über

  • Artikel

Set-CsUserServicesConfiguration

 

Letztes Änderungsdatum des Themas: 2012-04-23

Ändert eine vorhandene Auflistung von Konfigurationseinstellungen für die Benutzerdienste. Der Dienst für Benutzerdienste sorgt für die Verwaltung von Anwesenheitsinformationen und Konferenzen.

Syntax

Set-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsUserServicesConfiguration [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<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 Set-CsUserServicesConfiguration bietet Administratoren eine Möglichkeit zum Abrufen von Informationen zu beliebigen (oder allen) derzeit verwendeten Konfigurationseinstellungen für den Benutzerdienst.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID der zu ändernden Konfigurationseinstellungen für die Benutzerdienste. Verwenden Sie folgende Syntax, um die globalen Einstellungen zu ändern: -Identity global. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierten Einstellungen zu ändern: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um Einstellungen auf Dienstebene zu ändern: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Instance

Optional

UserServicesSettings-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

AnonymousUserGracePeriod

Optional

TimeSpan

Stellt die Dauer dar, die ein anonymer (nicht authentifizierter) Benutzer in einer Besprechung verbleiben darf, ohne dass ein authentifizierter in derselben Besprechung vorhanden ist. Beispiel: Wenn dieser Wert auf 15 Minuten festgelegt ist, kann ein anonymer Benutzer maximal 15 Minuten in der Besprechung verbleiben, bevor ein authentifizierter Benutzer hinzukommen muss. Wenn kein authentifizierter Benutzer beitritt, bevor die Kulanzfrist abgelaufen ist, wird der anonyme Benutzer aus der Besprechung entfernt. Diese Einstellung gilt sowohl für geplante Besprechungen als auch Ad-hoc-Besprechungen, die durch Klicken auf Jetzt besprechen in Microsoft Lync erstellt werden.

"AnonymousUserGracePeriod" muss mit dem folgenden Format angegeben werden: Tage:Minuten:Sekunden (z. B. 0.00:30:00 für 30 Minuten). Die Kulanzfrist kann auf einen beliebigen Wert von 0 Sekunden bis einen Tag festgelegt werden. Der Standardwert lautet 90 Minuten (01:30:00).

DeactivationGracePeriod

Optional

TimeSpan

Die Dauer, die eine Besprechung maximal aktiv bleiben kann. Dieser Wert muss mit dem folgenden Format angegeben werden: Tage.Stunden:Minuten:Sekunden. Um beispielsweise eine Dauer von 60 Stunden für eine Besprechung zu aktivieren, wählen Sie dieses Format: 2.12:00:00 (2 Tage: 12 Stunden: 00 Minuten: 00 Sekunden).

Der Wert für "DeactivationGracePeriod" muss auf einen Wert von 8 Stunden bis einschließlich 365 Tagen festgelegt werden. Der Standardwert lautet 1 Tag.

DefaultSubscriptionExpiration

Optional

Ganze Zahl

Abonnements werden immer dann erstellt, wenn ein Benutzer Daten anfordert, z. B. Anwesenheitsinformationen. Sobald die Anforderung erfolgt ist, kann der Benutzer (oder genauer die Clientanwendung des Benutzers) die Dauer anfordern, die das Abonnement gültig bleibt, bevor es verlängert werden muss. Wird keine solche Anforderung gestellt, wird das Abonnement auf den von der Eigenschaft "DefaultSubscriptionExpiration" angegebenen Wert festgelegt.

Die Standarddauer des Abonnements kann auf einen beliebigen ganzzahligen Wert von 300 Sekunden (5 Minuten) bis 86400 Sekunden (24 Stunden) festgelegt werden. Der Standardwert lautet 28800 Sekunden (8 Stunden).

MaintenanceTimeOfDay

Optional

DateTime

Gibt die Uhrzeit an, an der regelmäßig geplante Datenbankwartungsaufgaben erfolgen (z. B. das Löschen veralteter Datensätze). Dieser Wert muss als Datum-/Uhrzeit-Wert angegeben werden. Sie können entweder das 24-Stunden-Format (z. B. 14:00) oder das 12-Stunden-Format (z. B. 2:00 PM) verwenden.

Der Standardwert für "MaintenanceTimeOfDay" ist 1:00 AM (01:00:00).

MaxContacts

Optional

Ganze Zahl

Die maximal zulässige Anzahl von Kontakten eines Benutzers; der Standardwert lautet 250. Die Eigenschaft "MaxContacts" stellt die maximal zulässige Anzahl von Kontakten eines Benutzers dar. Mit den CsClientPolicy-Cmdlets können Sie allerdings bestimmte Benutzer auf eine maximale Anzahl von Kontakten begrenzen, die kleiner als der Wert von "MaxContacts" ist.

MaxPersonalNotes

Optional

Ganze Zahl

Gibt die maximale Anzahl persönlicher Notizen an, die im Notizenverlauf des Benutzers gespeichert werden. Standardmäßig werden die letzten drei persönlichen Notizen im Notizenverlauf gespeichert. Der maximale Wert für diesen Parameter ist 10.

MaxScheduledMeetingsPerOrganizer

Optional

Ganze Zahl

Die Höchstanzahl von Besprechungen, bei denen ein Benutzer zu einem bestimmten Zeitpunkt als Organisator fungieren kann. Der Standardwert lautet 1000. Das bedeutet, wenn ein Benutzer bereits Organisator von 1000 Besprechungen ist, hat sein Versuch, eine neue Besprechung (mit der Nummer 1001) zu planen, keinen Erfolg.

MaxSubscriptionExpiration

Optional

Ganze Zahl

Abonnements werden immer dann erstellt, wenn ein Benutzer Daten anfordert, z. B. Anwesenheitsinformationen. Sobald die Anforderung erfolgt ist, kann der Benutzer (oder genauer die Clientanwendung des Benutzers) die Dauer anfordern, die das Abonnement gültig bleibt, bevor es verlängert werden muss. Die Eigenschaft "MaxSubscriptionExpiration" stellt die Höchstdauer dar, die Clients gewährt werden kann. Beispiel: Wenn die Höchstdauer auf 28800 Sekunden festgelegt ist und ein Client ein Timeoutintervall von 86400 Sekunden anfordert, wird dem Client der maximal zulässige Ablaufzeitraum zugewiesen: 28800 Sekunden.

Die Höchstdauer des Abonnements kann auf einen beliebigen ganzzahligen Wert von 300 Sekunden (5 Minuten) bis 86400 Sekunden (24 Stunden) festgelegt werden. Der Standardwert lautet 43200 Sekunden (12 Stunden).

MaxSubscriptions

Optional

Ganze Zahl

Die maximale Anzahl von SIP-Abonnementdialogfeldern, die ein Benutzer zu einem beliebigen Zeitpunkt geöffnet haben darf. Ein Abonnementdialogfeld stellt eine Anforderung von SIP-Ressourcen dar.

MinSubscriptionExpiration

Optional

Ganze Zahl

Abonnements werden immer dann erstellt, wenn ein Benutzer Daten anfordert, z. B. Anwesenheitsinformationen. Sobald die Anforderung erfolgt ist, kann der Benutzer (oder genauer die Clientanwendung des Benutzers) die Dauer anfordern, die das Abonnement gültig bleibt, bevor es verlängert werden muss. Die Eigenschaft "MinSubscriptionExpiration" stellt die Mindestdauer dar, die Clients gewährt werden kann. Beispiel: Wenn die Mindestdauer auf 1200 Sekunden festgelegt ist und ein Client ein Timeoutintervall von 200 Sekunden anfordert, wird dem Client der minimal zulässige Ablaufzeitraum zugewiesen: 1200 Sekunden.

Die Mindestdauer des Abonnements kann auf einen beliebigen ganzzahligen Wert von 300 Sekunden (5 Minuten) bis 86400 Sekunden (24 Stunden) festgelegt werden. Die Standardeinstellung ist 1200 Sekunden (20 Minuten).

SubscribeToCollapsedDG

Optional

Boolescher Wert

Wenn dieser Wert auf "True" (Standardwert) festgelegt ist, können Clientanwendungen Verteilergruppen abonnieren, die derzeit in der Kontaktliste nicht erweitert sind. Dadurch erhält der Client minutengenaue Anwesenheitsinformationen zu jedem Gruppenmitglied. Bei Festlegung auf "False" können Clientanwendungen keine "erweiterten" Gruppen abonnieren.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings-Objekt. Set-CsUserServicesConfiguration akzeptiert weitergeleitete Instanzen des Objekts für Benutzerdiensteinstellungen.

Rückgabetypen

Set-CsUserServicesConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings" konfiguriert.

Beispiel

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

Set-CsUserServicesConfiguration -Identity site:Redmond -AnonymousUserGracePeriod "00:30:00"

Der Befehl in Beispiel 1 ändert die Konfigurationseinstellungen für Benutzerdienste am Standort "Redmond" (-Identity site:Redmond). In diesem Beispiel wird der Parameter "AnonymousUserGracePeriod" auf 30 Minuten festgelegt (00 Stunden: 30 Minuten: 00 Sekunden).

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

Set-CsUserServicesConfiguration -Identity site:Redmond -MaintenanceTimeOfDay "13:30"

In Beispiel 2 wird die Eigenschaft "MaintenanceTimeOfDay" für die Konfigurationseinstellungen der Benutzerdienste am Standort "Redmond" geändert. Hierzu wird der Parameter "MaintenanceTimeOfDay" und der Parameterwert "13:30" verwendet. Die Uhrzeit für die Wartung wird auf 13:30 Uhr festgelegt.

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

Get-CsUserServicesConfiguration -Filter "service:*" | Set-CsUserServicesConfiguration -MaxContacts 300

Mit dem vorstehenden Befehl werden alle Konfigurationseinstellungen für die Benutzerdienste abgerufen, die auf Dienstebene gelten, und die zulässige Anzahl von Kontakten für jeden dieser Einträge geändert. Hierzu verwendet der Befehl zunächst das Cmdlet Get-CsUserServicesConfiguration und den Parameter "Filter", um alle auf Dienstebene konfigurierten Einstellungen abzurufen. Der Filterwert "service:*" begrenzt die zurückgegebenen Daten auf Einstellungen, deren Identitätswert mit der Zeichenfolge "service:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Set-CsUserServicesConfiguration weitergeleitet, das die Eigenschaft "MaxContacts" jedes Elements in der Auflistung auf 300 festlegt.

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

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

In Beispiel 4 werden alle Konfigurationseinstellungen für die Benutzerdienste geändert, die mehr als 300 Kontakte zulassen. Nachdem die Änderungen durchgeführt wurden, lassen die Einstellungen nicht mehr als 300 Kontakte zu. Hierzu ruft der Befehl zunächst Get-CsUserServicesConfiguration ohne Parameter auf. Dadurch wird eine Auflistung aller derzeit in der Organisation verwendeten Konfigurationseinstellungen für die Benutzerdienste zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, deren Eigenschaft "MaxContacts" größer als 300 ist. Diese gefilterte Auflistung wird dann wiederum an das Cmdlet Set-CsUserServicesConfiguration weitergeleitet, das die maximale Anzahl von zulässigen Kontakten für jedes Element in der Auflistung auf 300 festlegt.