• Artikel

Get-CsConferencingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den in Ihrer Organisation verwendeten Konferenzkonfigurationseinstellungen zurück. 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

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

Get-CsConferencingConfiguration [-Filter <String>] [-LocalStore <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 Lync Server 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.

Das Cmdlet Get-CsConferencingConfiguration bietet Administratoren die Möglichkeit, Informationen zu allen Konferenzkonfigurationseinstellungen zurückzugeben, die derzeit in Ihrer Organisation verwendet werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die abzurufende Auflistung von Konferenzkonfigurationseinstellungen. Verwenden Sie folgende Syntax, um die globalen Einstellungen abzurufen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf Standortebene konfigurierte Einstellungen abzurufen: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um auf Dienstebene konfigurierte Einstellungen abzurufen: -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com".

Bei Auslassung dieses Parameters werden mit Get-CsConferencingConfiguration alle derzeit in Ihrer Organisation verwendeten Konferenzkonfigurationseinstellungen zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht es Ihnen, beim Angeben des Identitätswerts der Konferenzkonfigurationseinstellungen Platzhalter zu verwenden. Verwenden Sie beispielsweise folgende Syntax, um alle auf Standortebene konfigurierten Einstellungen zurückzugeben: -Filter "site:*". Verwenden Sie folgende Syntax, um alle auf Dienstebene konfigurierten Einstellungen zurückzugeben: -Filter "service:*".

Beachten Sie, dass Sie die Parameter "Identity" und "Filter" nicht in demselben Befehl verwenden können.

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsConferencingConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsConferencingConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings" zurückgegeben.

Beispiel

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

Get-CsConferencingConfiguration

In Beispiel 1 werden Informationen zu allen derzeit in Ihrer Organisation verwendeten Konferenzkonfigurationseinstellungen zurückgegeben. Dazu wird Get-CsConferencingConfiguration ohne Parameter aufgerufen.

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

Get-CsConferencingConfiguration -Identity site:Redmond

In Beispiel 2 werden nur Konfigurationsinformationen zu Konferenzen für den Standort "Redmond" (-Identity "site:Redmond) zurückgegeben. Da Identitätswerte eindeutig sein müssen, wird mit diesem Befehl immer nur maximal eine Auflistung von Konferenzkonfigurationseinstellungen zurückgegeben.

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

Get-CsConferencingConfiguration -Filter "site:*"

Der Befehl in Beispiel 3 gibt Informationen zu allen Konferenzkonfigurationseinstellungen zurück, die auf Standortebene angewendet wurden. Hierzu wird Get-CsConferencingConfiguration mit dem Parameter "Filter" aufgerufen. Mit dem Filterwert "site:*" wird sichergestellt, dass nur die Einstellungen zurückgegeben werden, deren Identitätswert mit der Zeichenfolge "site:" beginnt.

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

Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Litwareinc"}

Mit dem vorstehenden Befehl werden Informationen zu allen Konferenzkonfigurationseinstellungen zurückgegeben, bei denen die Organisation nicht auf "Litwareinc" festgelegt ist. Hierzu ruft der Befehl zunächst Get-CsConferencingConfiguration ohne Parameter auf. Dadurch wird eine Auflistung aller in der Organisation verwendeten Konferenzkonfigurationseinstellungen zurückgegeben. Die resultierende Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Einstellungen herausfiltert, bei denen die Eigenschaft "Organization" nicht den Wert "Litwareinc" aufweist.

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

Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMB -gt 100}

In Beispiel 5 werden Informationen nur für die Konferenzkonfigurationseinstellungen zurückgegeben, bei denen der maximale Inhaltsspeicher größer als 100 Megabyte ist. Hierzu ruft der Befehl zunächst Get-CsConferencingConfiguration ohne Parameter auf, um eine Auflistung aller Konferenzkonfigurationseinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen der Inhaltsspeicher größer als 100 Megabyte ist.