New-CsUserServicesConfiguration
Letztes Änderungsdatum des Themas: 2012-04-23
Erstellt eine neue Auflistung von Benutzerdienste-Konfigurationseinstellungen. Der Dienst für Benutzerdienste sorgt für die Verwaltung von Anwesenheitsinformationen und Konferenzen.
Syntax
New-CsUserServicesConfiguration -Identity <XdsIdentity> [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 New-CsUserServicesConfiguration bietet Administratoren die Möglichkeit, eine neue Auflistung von Konfigurationseinstellungen für Benutzerdienste auf Standort- oder Dienstebene zu erstellen. (Neue Auflistungen können nicht global erstellt werden.) Beachten Sie, dass ein Standort oder Dienst nur eine Auflistung von Konfigurationseinstellungen für Benutzerdienste aufweisen kann. Beim Ausführen des Befehls tritt ein Fehler auf, wenn Sie z. B. Einstellungen für den Standort "Redmond" erstellen möchten und dieser Standort bereits über eine Auflistung von Konfigurationseinstellungen für Benutzerdienste verfügt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-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 "New-CsUserServicesConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eindeutige ID für die zu erstellenden Konfigurationseinstellungen für Benutzerdienste. Verwenden Sie eine Syntax wie die folgende, um Einstellungen auf Standortebene zu erstellen: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um Einstellungen auf Dienstebene zu erstellen: -Identity service:UserServer:atl-cs-001.litwareinc.com. |
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.Stunden:Minuten:Sekunden (Beispiel: 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 (1.00:00:00). |
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. Der Standardwert lautet 200. |
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. |
InMemory |
Optional |
Switch-Parameter |
Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen. |
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
Keine. New-CsUserServicesConfiguration akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit New-CsUserServicesConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings" erstellt.
Beispiel
-------------------------- Beispiel 1 ------------------------
New-CsUserServicesConfiguration -Identity site:Redmond -MaxContacts 500 -MaintenanceTimeOfDay "11:00 PM"
Der Befehl in Beispiel 1 erstellt eine neue Auflistung von Konfigurationseinstellungen für Benutzerdienste für den Standort "Redmond" (-Identity site:Redmond). Neben der Festlegung des Identitätswerts legt der Befehl auch die maximale Anzahl von Kontakten (-MaxContacts 500) und die Tageszeit fest, zu der die Wartung stattfindet (-MaintenanceTimeOfDay "11:00 PM"). Beachten Sie, dass beim Ausführen dieses Befehls ein Fehler auftritt, wenn für den Standort "Redmond" bereits Benutzerdiensteinstellungen konfiguriert wurden. Der Grund hierfür ist, dass Sie nur eine Auflistung von Einstellungen pro Standort haben können.
-------------------------- Beispiel 2 ------------------------
$x = New-CsUserServicesConfiguration -Identity site:Redmond -InMemory
$x.MaxContacts = 500
$x.MaintenanceTimeOfDay = "11:00 PM"
Set-CsUserServicesConfiguration -Instance $x
In Beispiel 2 wird ebenfalls eine neue Auflistung von Konfigurationseinstellungen für Benutzerdienste am Standort "Redmond" erstellt. Jedoch wird in diesem Beispiel die Auflistung zunächst nur im Arbeitsspeicher erstellt und später dem Standort "Redmond" zugewiesen. Hierzu verwendet der erste Befehl im Beispiel New-CsUserServicesConfiguration und den Parameter "InMemory", um eine neue Auflistung (mit dem Identitätswert "site:Redmond") zu erstellen, die nur im Arbeitsspeicher vorhanden ist. Da diese Auflistung nur im Arbeitsspeicher erstellt wird, muss das Benutzerdienstobjekt in einer Variablen gespeichert werden. In diesem Fall ist dies die Variable "$x".
Nach der Erstellung der virtuellen Auflistung dienen die Befehle 2 und 3 zum Ändern der Werte der Eigenschaften "MaxContacts" und "MaintenanceTimeOfDay". Der letzte Befehl in diesem Beispiel verwendet dann Set-CsUserServicesConfiguration, um diese virtuellen Einstellungen in eine tatsächliche Auflistung von Konfigurationseinstellungen für Benutzerdienste umzuwandeln, die auf den Standort "Redmond" angewendet werden. Der letzte Schritt ist entscheidend: Wenn Set-CsUserServicesConfiguration nicht aufgerufen wird, werden keine Einstellungen auf den Standort "Redmond" angewendet, und die virtuellen Einstellungen gehen verloren, sobald Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen.
Siehe auch
Weitere Ressourcen
Get-CsUserServicesConfiguration
Remove-CsUserServicesConfiguration
Set-CsUserServicesConfiguration