Set-CsConferencingConfiguration
Letztes Änderungsdatum des Themas: 2012-04-23
Ändert eine vorhandene Auflistung von Konfigurationseinstellungen für Konferenzen. Mit Konferenzeinstellungen werden z. B. die maximal zulässige Größe für Besprechungsinhalte und -handzettel, die Kulanzfrist für Inhalte (d. h. der Zeitraum, in dem Inhalte gespeichert werden, bevor sie gelöscht werden) und die URLs für interne und externe Downloads des unterstützten Clients festgelegt.
Syntax
Set-CsConferencingConfiguration [-Identity <XdsIdentity>] [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Set-CsConferencingConfiguration [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-Instance <PSObject>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Bei der Verwaltung von Konferenzen werden zwei Cmdlet-Sätze verwendet. Wenn Sie festlegen möchten, welche Aufgaben Benutzer durchführen oder nicht durchführen können (z. B. Einladen anonymer Teilnehmer zu einer Konferenz, Berechtigung zum Freigeben von Anwendungen bzw. Dateiübertragungen innerhalb einer Konferenz), müssen Sie die CsConferencingPolicy-Cmdlets verwenden.
Administratoren verwalten nicht nur die Benutzeraktivitäten, sondern müssen auch den Webkonferenzdienst verwalten. Administratoren müssen z. B. die maximale Größe des für eine einzelne Konferenz vorgesehenen Inhaltsspeichers und die Kulanzfrist festlegen können, nach deren Ablauf Konferenzinhalte automatisch gelöscht werden. Sie müssen außerdem die Ports festlegen können, die für Aktivitäten wie z. B. Anwendungsfreigabe und Dateiübertragung verwendet werden.
Diese Aktivitäten können mit den CsConferencingConfiguration-Cmdlets verwaltet werden. Mit diesen Cmdlets können Sie die Server selbst verwalten. Mit den CsConferencingConfiguration-Cmdlets (die global, auf Standort- und Dienstebene angewendet werden können) wird nicht festgelegt, ob ein Benutzer während einer Konferenz Anwendungen freigeben kann. Wenn die Anwendungsfreigabe zulässig ist, können Sie mit diesen Cmdlets jedoch angeben, welche Ports für diese Aktivität verwendet werden sollen. Ebenso können Sie mit den Cmdlets Speicherbeschränkungen und Ablaufzeiträume sowie Verweise auf interne und externe URLs angeben, über die Benutzer Hilfe und Ressourcen zur Konferenzfunktion erhalten.
Beim Installieren von Microsoft Lync Server 2010 bietet das System eine einzelne Auflistung von Konfigurationseinstellungen für Konferenzen (die globale Auflistung) an. Wenn Sie benutzerdefinierte Einstellungen für einen Standort oder Dienst erstellen müssen, können Sie dies mit dem Cmdlet New-CsConferencingConfiguration tun. Nachdem diese benutzerdefinierten Einstellungen erstellt wurden, können Sie sie mithilfe des Cmdlets Set-CsConferencingConfiguration ändern (oder die globale Auflistung bearbeiten).
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-CsConferencingConfiguration 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-CsConferencingConfiguration"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Eindeutige ID für die zu ändernde Auflistung von Konferenzkonfigurationseinstellungen. Verwenden Sie folgende Syntax, um auf die globale Auflistung zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine Auflistung zu verweisen, die auf Standortebene konfiguriert ist: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um auf eine Auflistung zu verweisen, die auf Dienstebene konfiguriert ist: -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com". Der Webkonferenzdienst ist der einzige Dienst, der diese Konfigurationseinstellungen hosten kann. Wenn dieser Parameter nicht angegeben wird, ändert Set-CsConferencingConfiguration die globalen Einstellungen automatisch. |
Instance |
Optional |
ConfSettings-Objekt |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. |
ClientAppSharingPort |
Optional |
Ganze Zahl |
Stellt die erste Portnummer dar, die für die Anwendungsfreigabe verwendet wird. Für "ClientAppSharingPort" muss eine Portnummer zwischen 1024 und einschließlich 65535 verwendet werden. Der Standardwert lautet 5350. |
ClientAppSharingPortRange |
Optional |
Ganze Zahl |
Gibt die Gesamtanzahl der Ports an, die für die Anwendungsfreigabe verfügbar sind. (Der Standardwert lautet 40.) Verwenden Sie diesen Wert und den Wert "ClientAppSharingPort", um die für die Anwendungsfreigabe verwendeten tatsächlichen Ports zu bestimmen. Wenn beispielsweise "ClientAppSharingPort" auf 5350 und "ClientAppSharingPortRange" auf 3 festgelegt werden, sind die folgenden 3 Ports für die Anwendungsfreigabe verfügbar: 5350; 5351; 5352. |
ClientAudioPort |
Optional |
Ganze Zahl |
Stellt die erste Portnummer dar, die für Clientaudio verwendet wird. Für "ClientAudioPort" muss eine Portnummer von 1024 bis einschließlich 65535 verwendet werden. Der Standardwert lautet 5350. |
ClientAudioPortRange |
Optional |
Ganze Zahl |
Gibt die Gesamtanzahl der Ports an, die für Clientaudio verfügbar sind. (Der Standardwert lautet 40.) Verwenden Sie diesen Wert und den Wert "ClientAudioPort", um die für Clientaudio verwendeten tatsächlichen Ports zu bestimmen. Wenn z. B. "ClientAudioPort" auf 5350 und "ClientAudioPortRange" auf 3 festgelegt werden, sind die folgenden drei Ports für Clientaudio verfügbar: 5350; 5351; 5352. |
ClientFileTransferPort |
Optional |
Ganze Zahl |
Stellt die erste Portnummer dar, die für die Dateiübertragungen verwendet wird. Für "ClientFileTransferPort" muss eine Portnummer zwischen 1024 und einschließlich 65535 verwendet werden. Der Standardwert lautet 5350. |
ClientFileTransferPortRange |
Optional |
Ganze Zahl |
Gibt die Gesamtanzahl der Ports an, die für die Dateiübertragungen verfügbar sind. (Der Standardwert lautet 40.) Verwenden Sie diesen Wert und den Wert "ClientFileTransferPort", um die für die Dateiübertragungen verwendeten tatsächlichen Ports zu bestimmen. Wenn beispielsweise "ClientFileTransferPort" auf 5350 und "ClientFileTransferPortRange" auf 3 festgelegt werden, sind die folgenden drei Ports für die Dateiübertragungen verfügbar: 5350; 5351; 5352. |
ClientMediaPort |
Optional |
Ganze Zahl |
Stellt die erste Portnummer dar, die für Clientmedien verwendet wird. Verwenden Sie diesen Parameter für Microsoft Office Communicator 2007 R2-Clients. Für "ClientMediaPort" muss eine Portnummer von 1024 bis einschließlich 65535 verwendet werden. Der Standardwert lautet 5350. |
ClientMediaPortRange |
Optional |
Ganze Zahl |
Gibt die Gesamtanzahl der Ports an, die für Clientmedien verfügbar sind. (Der Standardwert lautet 40.) Verwenden Sie diesen Parameter für Office Communicator 2007 R2-Clients. Verwenden Sie diesen Wert und den Wert "ClientMediaPort", um die für Clientmedien verwendeten tatsächlichen Ports zu bestimmen. Wenn z. B. "ClientMediaPort" auf 5350 und "ClientMediaPortRange" auf 3 festgelegt werden, sind die folgenden drei Ports für Clientmedien verfügbar: 5350; 5351; 5352. |
ClientMediaPortRangeEnabled |
Optional |
Boolescher Wert |
Wenn "True" festgelegt ist, verwenden Clients den angegebenen Portbereich für den Mediendatenverkehr. Wenn "False" (der Standardwert) festgelegt ist, wird ein beliebiger verfügbarer Port (von Port 1024 bis Port 65535) für den Mediendatenverkehr verwendet. |
ClientSipDynamicPort |
Optional |
Ganze Zahl |
Stellt die erste Portnummer dar, die für den SIP-Datenverkehr verwendet wird. Für "ClientSipDynamicPort" muss eine Portnummer von 1024 bis einschließlich 65535 verwendet werden. Der Standardwert lautet 7100. |
ClientSipDynamicPortRange |
Optional |
Ganze Zahl |
Gibt die Gesamtanzahl der Ports an, die für den SIP-Datenverkehr verfügbar sind. (Der Standardwert lautet 3.) Verwenden Sie diesen Wert und den Wert "ClientSipDynamicPort", um die für den SIP-Datenverkehr verwendeten tatsächlichen Ports zu bestimmen. Wenn z. B. "ClientSipDynamicPort" auf 7100 und "ClientSipDynamicPortRange" auf 3 festgelegt werden, sind die folgenden 3 Ports für die Clientmedien verfügbar: 7100; 7101; 7102. |
ClientVideoPort |
Optional |
Ganze Zahl |
Stellt die erste Portnummer dar, die für Clientvideo verwendet wird. Für "ClientVideoPort" muss eine Portnummer zwischen 1024 und einschließlich 65535 verwendet werden. Der Standardwert lautet 5350. |
ClientVideoPortRange |
Optional |
Ganze Zahl |
Gibt die Gesamtanzahl der Ports an, die für die Clientvideo verfügbar sind. (Der Standardwert lautet 40.) Verwenden Sie diesen Wert und den Wert "ClientVideoPort", um die für Clientvideo verwendeten tatsächlichen Ports zu bestimmen. Wenn z. B. "ClientVideoPort" auf 5350 und "ClientVideoPortRange" auf 3 festgelegt werden, sind die folgenden drei Ports für Clientvideo verfügbar: 5350; 5351; 5352. |
ConsoleDownloadExternalUrl |
Optional |
Zeichenfolge |
URL, über die externe Benutzer einen unterstützten Client wie Microsoft Lync 2010 herunterladen können. Diese Einstellung gilt nur für Clients von Vorversionen (wie Microsoft Office Communicator 2007 R2), die sich bei einem Lync Server-Pool anmelden. |
ConsoleDownloadInternalUrl |
Optional |
Zeichenfolge |
URL, über die interne Benutzer einen unterstützten Client wie Microsoft Lync 2010 herunterladen können. Diese Einstellung gilt nur für Clients von Vorversionen (wie Microsoft Office Communicator 2007 R2), die sich bei einem Lync Server-Pool anmelden. |
ContentGracePeriod |
Optional |
TimeSpan |
Gibt den Zeitraum an, in dem Konferenzinhalte nach dem Ende der Konferenz auf dem Server aufbewahrt werden. "ContentGracePeriod" muss im Format "Tage.Stunden:Minuten:Sekunden" angegeben werden. Verwenden Sie die folgende Syntax, um z. B. die Kulanzfrist für Inhalte auf 30 Tage festzulegen: -ContentGracePeriod 30.00:00:00. Die Kulanzfrist für Inhalte kann auf einen beliebigen Wert zwischen 30 Minuten (00:30:00) und 180 Tagen (180:00:00) festgelegt werden. Der Standardwert lautet 15 Tage (15.00:00:00). |
HelpdeskExternalUrl |
Optional |
Zeichenfolge |
URL, an die externe Benutzer weitergeleitet werden, wenn sie während einer Konferenz auf "Hilfe" klicken. |
HelpdeskInternalUrl |
Optional |
Zeichenfolge |
URL, an die interne Benutzer weitergeleitet werden, wenn sie während einer Konferenz auf "Hilfe" klicken. |
MaxBandwidthPerAppSharingServiceMb |
Optional |
Ganze Zahl |
Gibt die maximale Bandbreite (in Megabyte) an, die für den Konferenzdienst zur Anwendungsfreigabe reserviert wird. "MaxBandwidthPerAppSharingServiceMb" kann auf einen beliebigen ganzzahligen Wert zwischen 50 und einschließlich 100000 festgelegt werden. Der Standardwert lautet 375 Megabyte. |
MaxContentStorageMb |
Optional |
Ganze Zahl |
Maximale Größe des Dateispeicherplatzes (in Megabyte) zum Speichern der Besprechungsinhalte. "MaxContentStorageMb" kann auf einen beliebigen ganzzahligen Wert zwischen 50 und einschließlich 1024 (1 Gigabyte) festgelegt werden. Der Standardwert lautet 500 Megabyte. |
Organization |
Optional |
Zeichenfolge |
Name der Organisation, die die Konferenz hostet. |
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.WebConf.ConfSettings-Objekt. Set-CsConferencingConfiguration akzeptiert weitergeleitete Instanzen von Konferenzkonfigurationsobjekten.
Rückgabetypen
Set-CsConferencingConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings" konfiguriert.
Beispiel
Beispiel 1
Set-CsConferencingConfiguration -Identity global -Organization Litwareinc
In Beispiel 1 ändert Set-CsConferencingConfiguration die globale Instanz der Konferenzkonfigurationseinstellungen; in diesem Fall setzt der Befehl den Wert der Eigenschaft "Organization" auf "Litwareinc". Dazu wird der Parameter "Organization", gefolgt vom Namen der Organisation, "Litwareinc", hinzugefügt.
Beispiel 2
Get-CsConferencingConfiguration | Set-CsConferencingConfiguration -Organization Litwareinc
Beispiel 2 ist eine Erweiterung zu Beispiel 1. In diesem Fall ändert der Befehl den Wert der Eigenschaft "Organization" für jede Auflistung der derzeit verwendeten Konferenzkonfigurationseinstellungen. Dazu ruft der Befehl zunächst mit Get-CsConferencingConfiguration eine Auflistung aller Konferenzkonfigurationseinstellungen ab. Diese Auflistung wird dann an das Cmdlet Set-CsConferencingConfiguration weitergeleitet, das den Wert der Eigenschaft "Organization" für jedes Element in der Auflistung in "Litwareinc" ändert.
Beispiel 3
Get-CsConferencingConfiguration -Filter site:* | Set-CsConferencingConfiguration -MaxContentStorageMb 50
Der Befehl in Beispiel 3 ändert den Wert der Eigenschaft "MaxContentStorageMb" für alle Konferenzkonfigurationseinstellungen, die auf Standortebene angewendet werden. Dazu ruft der Befehl zunächst Get-CsConferencingConfiguration mit dem Parameter "Filter" auf. Mit dem Filterwert "site:*" wird sichergestellt, dass nur die Einstellungen zurückgegeben werden, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Set-CsConferencingConfiguration weitergeleitet, das den Wert der Eigenschaft "MaxContentStorageMb" für jedes Element in der Auflistung in 50 ändert.
Beispiel 4
Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMb -gt 100} | Set-CsConferencingConfiguration -MaxContentStorageMB 100
In Beispiel 4 werden alle Konferenzkonfigurationseinstellungen geändert, die einen Inhaltsspeicher von mehr als 100 Megabyte ermöglichen, um den maximal zulässigen Inhaltsspeicher auf 100 Megabyte festzulegen. Dazu ruft der Befehl zunächst Get-CsConferencingConfiguration ohne Parameter auf, um eine Auflistung aller Konferenzkonfigurationseinstellungen zurückzugeben, die derzeit verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, deren Eigenschaft "MaxContentStorageMb" größer als 100 ist. Diese gefilterte Auflistung wird dann an Set-CsConferencingConfiguration weitergeleitet, das die Eigenschaft "MaxContentStorageMb" jedes Elements in der Auflistung auf 100 festlegt.
Beispiel 5
Set-CsConferencingConfiguration -Identity site:Redmond -ContentGracePeriod "22:00:00"
Mit dem vorstehenden Befehl werden die Konferenzkonfigurationseinstellungen für den Standort Redmond (-Identity site:Redmond) abgerufen, und der Wert der Eigenschaft "ContentGracePeriod" wird so geändert, dass die Kulanzfrist 22 Stunden beträgt (22 Stunden: 00 Minuten: 00 Sekunden).
Beispiel 6
Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Fabrikam"} | Set-CsConferencingConfiguration -Organization Litwareinc
In Beispiel 6 werden alle Konferenzkonfigurationseinstellungen geändert, die nicht "Fabrikam" als Organisation auflisten - alle diese Einstellungen werden Litwareinc als der neuen Organisation zugewiesen. Dazu ruft der Befehl zunächst Get-CsConferencingConfiguration ohne Parameter auf. Daraufhin wird eine Auflistung aller in der Organisation verwendeten Konferenzkonfigurationseinstellungen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das alle Einstellungen auswählt, bei denen die Eigenschaft "Organization" nicht den Wert "Fabrikam" aufweist (der Vergleichsoperator "-ne" steht für "not equal to"). Diese Auflistung wird dann an Set-CsConferencingConfiguration weitergeleitet. Set-CsConferencingConfiguration ändert den Wert der Eigenschaft "Organization" für jedes Element in der Auflistung in "Litwareinc".
Siehe auch
Weitere Ressourcen
Get-CsConferencingConfiguration
New-CsConferencingConfiguration
Remove-CsConferencingConfiguration