• Artikel

New-CsConferencingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-04-23

Erstellt eine neue Auflistung von Konferenzkonfigurationseinstellungen. Mit Konferenzeinstellungen werden z. B. die maximal zulässige Größe für Konferenzinhalte 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

New-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>] [-InMemory <SwitchParameter>] [-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 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. Beachten Sie, dass neue Einstellungen nur auf Standort- oder Dienstebene angewendet werden können. Sie können keine globale Auflistung von Konfigurationseinstellungen für Konferenzen erstellen. Darüber hinaus kann kein Standort oder Dienst mehr als eine Auflistung von Einstellungen hosten. Wenn Sie versuchen, neue Einstellungen für den Standort "Redmond" zu erstellen und der Standort "Redmond" bereits eine Auflistung von Konfigurationseinstellungen für Konferenzen hostet, tritt beim Ausführen des Befehls ein Fehler auf.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsConferencingConfiguration lokal ausfü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-CsConferencingConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zu ändernde Auflistung von Konferenzkonfigurationseinstellungen. 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". Beachten Sie, dass der Webkonferenzdienst der einzige Dienst ist, der diese Konfigurationseinstellungen hosten kann.

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 3 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 drei 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 einer Besprechung 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 Konferenzinhalte. "MaxContentStorageMb" kann auf einen beliebigen ganzzahligen Wert von 50 bis einschließlich 1024 (1 Gigabyte) festgelegt werden. Der Standardwert lautet 500.

Organization

Optional

Zeichenfolge

Name der Organisation, die die Konferenz hostet.

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.

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

Keine. New-CsConferencingConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsConferencingConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings" erstellt.

Beispiel

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

New-CsConferencingConfiguration -Identity site:Redmond -Organization Litwareinc

Mit dem vorstehenden Befehl wird eine neue Auflistung von Konfigurationseinstellungen für Konferenzen für den Standort "Redmond" (site:Redmond) erstellt. In diesem Beispiel wird ein zusätzlicher Parameter (Organization) verwendet, mit dem der Wert der Eigenschaft "Organization" auf "Litwareinc" festgelegt wird. Beachten Sie, dass bei diesem Befehl ein Fehler auftritt, wenn der Standort "Redmond" bereits über eine Auflistung von Konfigurationseinstellungen für Konferenzen verfügt. Der Grund hierfür ist, dass nur eine Auflistung pro Standort definiert werden kann.

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

$x = New-CsConferencingConfiguration -Identity site:Redmond -InMemory
$x.Organization = "Litwareinc"
Set-CsConferencingConfiguration -Instance $x

In Beispiel 2 wird eine neue Auflistung von Konfigurationseinstellungen für Konferenzen zunächst nur im Arbeitsspeicher erstellt. Diese virtuellen Einstellungen werden später auf den Standort "Redmond" angewendet. Dazu verwendet der erste Befehl im Beispiel das Cmdlet New-CsConferencingConfiguration, um eine neue Auflistung von in der Variablen "$x" gespeicherten Einstellungen im Arbeitsspeicher zu erstellen. Mit dem Parameter "InMemory" wird festgelegt, ob die Auflistung im Arbeitsspeicher erstellt werden soll, anstatt sie sofort auf den Standort "Redmond" anzuwenden.

Nachdem die Auflistung erstellt wurde, wird mit dem zweiten Befehl der Wert für die Eigenschaft "Organization" auf "Litwareinc" festgelegt. Der dritte Befehl verwendet schließlich Set-CsConferencingConfiguration, um die neuen Einstellungen auf den Standort "Redmond" tatsächlich anzuwenden. (Beim Ausführen dieses Befehls tritt ein Fehler auf, wenn bereits Konfigurationseinstellungen für Konferenzen auf "site:Redmond" angewendet wurden.) Wenn Set-CsConferencingConfiguration nicht aufgerufen wird, werden die neuen Einstellungen nicht übernommen. Stattdessen gehen sie verloren, sobald Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen.