Remove-CsMeetingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Mit Remove-CsMeetingConfiguration kann eine vorhandene Auflistung von Besprechungskonfigurationseinstellungen gelöscht werden. Konfigurationseinstellungen für Besprechungen legen fest, welche Arten von Besprechungen (auch "Konferenzen" genannt) Benutzer erstellen können. Zusätzlich steuern sie, wie (bzw. ob) anonyme Benutzer und Benutzer von Einwahlkonferenzen an diesen Besprechungen teilnehmen können.

Syntax

Remove-CsMeetingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Onlinebesprechungen (auch "Konferenzen" genannt) sind ein integraler Bestandteil von Microsoft Lync Server 2010. Mit den CsMeetingConfiguration-Cmdlets können Administratoren steuern, welche Arten von Besprechungen Benutzer erstellen können, und festlegen, welche Rechte anonyme Benutzer und Benutzer von Einwahlkonferenzen in Besprechungen erhalten. Sie können beispielsweise Besprechungen so konfigurieren, dass alle Teilnehmer, die sich über das Telefonfestnetz einwählen, automatisch für die Besprechung zugelassen werden. Alternativ können Sie Besprechungen so konfigurieren, dass Einwählbenutzer nicht automatisch für die Besprechung zugelassen werden, sondern in den Wartebereich für die Konferenz umgeleitet werden. Diese Einwählbenutzer verbleiben im Wartebereich, bis ein Referent sie für die Besprechung zulässt.

Besprechungskonfigurationseinstellungen können global, auf Standort- und Dienstebene zugewiesen werden. Wenn Sie neue Einstellungen auf Standort- oder Dienstebene erstellen, können Sie diese Einstellungen später mit dem Cmdlet Remove-CsMeetingConfiguration entfernen. Remove-CsMeetingConfiguration kann auch für die globalen Besprechungseinstellungen ausgeführt werden. In diesem Fall werden die Einstellungen jedoch nicht entfernt, da die globalen Einstellungen nicht entfernt werden können. Stattdessen werden alle Eigenschaften in der globalen Auflistung auf die Standardwerte zurückgesetzt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID für die Besprechungskonfigurationseinstellungen, die entfernt werden sollen. Verwenden Sie diese Syntax, um die globalen Einstellungen zu "entfernen": -Identity global. (Wie bereits erwähnt, können Sie die globalen Einstellungen nicht wirklich entfernen. Sie können ausschließlich die Eigenschaften auf ihre Standardwerte zurücksetzen.) Verwenden Sie eine Syntax wie die folgende, um die Einstellungen auf Standortebene zu entfernen: -Identity site:Redmond. Diensteinstellungen können mit folgender Syntax entfernt werden: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können.

Force

Optional

Switch-Parameter

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

Tenant

Optional

GUID

Dieser Parameter wird mit der lokalen Version von Lync Server 2010 nicht verwendet.

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.MeetingConfiguration-Objekt. Remove-CsMeetingConfiguration akzeptiert weitergeleitete Instanzen des Konfigurationsobjekts für Besprechungen.

Rückgabetypen

Keine. Mit Remove-CsMeetingConfiguration werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration" gelöscht.

Beispiel

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

Remove-CsMeetingConfiguration -Identity site:Redmond

In Beispiel 1 werden nur die Besprechungskonfigurationseinstellungen mit dem Identitätswert "site:Redmond" entfernt. Wenn diese Einstellungen vom Standort "Redmond" entfernt werden, erben die Benutzer dieses Standorts automatisch die globalen Besprechungskonfigurationseinstellungen.

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

Get-CsMeetingConfiguration -Filter "site:*" | Remove-CsMeetingConfiguration

Der Befehl in Beispiel 2 entfernt alle Besprechungseinstellungen, die auf Standortebene konfiguriert wurden. Der Befehl ruft zunächst Get-CsMeetingConfiguration mit dem Parameter "Filter" auf. Mit dem Filterwert "site:*" wird sichergestellt, dass nur die Einstellungen ausgewählt werden, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsMeetingConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.

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

Get-CsMeetingConfiguration | Where-Object {$_.AdmitAnonymousUsersByDefault -eq $True} | Remove-CsMeetingConfiguration

Mit dem vorstehenden Befehl wird jede Auflistung von Besprechungskonfigurationseinstellungen gelöscht, bei denen die Eigenschaft "AdmitAnonymousUsersbyDefault" den Wert "True" aufweist. Hierzu ruft der Befehl zunächst Get-CsMeetingConfiguration auf, um eine Auflistung aller derzeit verwendeten Besprechungskonfigurationseinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "AdmitAnonymousUsersByDefault" den Wert "True" aufweist. Diese gefilterte Auflistung wird anschließend an Remove-CsMeetingConfiguration weitergeleitet, um alle Elemente in dieser gefilterten Auflistung zu entfernen.