• Artikel

Remove-CsWebServiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt eine oder mehrere Auflistungen von Webdienste-Konfigurationseinstellungen.

Syntax

Remove-CsWebServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Viele Microsoft Lync Server 2010-Komponenten sind webbasiert: Diese Komponenten verwenden zum Ausführen der Aufgaben entweder Webdienste oder Webseiten. Benutzer nutzen beispielsweise einen Webdienst, um im Adressbuch nach neuen Kontakten zu suchen oder um die Gruppenerweiterung zu verwenden, mit der einzelne Mitglieder einer Verteilergruppe angezeigt werden können. Gleichermaßen nutzen Komponenten, von Einwahlkonferenzen bis hin zu Microsoft Lync Server 2010-Systemsteuerung, Webseiten als Schnittstelle zwischen Lync Server 2010 und Benutzern.

Die CsWebServiceConfiguration-Cmdlets ermöglichen es Administratoren, die Webdienste-Konfigurationseinstellungen innerhalb der Organisation zu verwalten. Dazu gehören die Verwaltung der Gruppenerweiterung, Zertifikatseinstellungen und zulässigen Authentifizierungsmethoden. Da Sie unterschiedliche Einstellungen auf globaler Ebene sowie auf Standort- und Dienstebene (allerdings nur für den Dienst der Webdienste) konfigurieren können, können Sie die Funktionen der Webdienste an die Anforderungen unterschiedlicher Benutzer und Standorte anpassen.

Wenn Sie benutzerdefinierte Webdienste-Konfigurationseinstellungen auf Standort- oder Dienstebene erstellen, können diese Einstellungen später mit dem Cmdlet Remove-CsWebServiceConfiguration entfernt werden. Beachten Sie, dass Sie Remove-CsWebServiceConfiguration auch für die globale Auflistung der Webdiensteeinstellungen ausführen können. In diesem Fall wird die globale Auflistung jedoch nicht entfernt, da in Lync Server keine globalen Einstellungen entfernt werden dürfen. Stattdessen werden alle Eigenschaften in der globalen Auflistung auf die Standardwerte zurückgesetzt. Nehmen Sie beispielsweise an, Sie haben den Wert für "MaxGroupSiteToExpand" auf 500 festgelegt. Da der Standardwert für die Eigenschaft 100 lautet, wird beim "Entfernen" der globalen Auflistung der Wert der Eigenschaft "MaxGroupSizeToExpand" auf 100 festgelegt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID der zu entfernenden Webdienste-Konfigurationseinstellungen. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene konfigurierten Einstellungen zu entfernen: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um die auf Dienstebene konfigurierten Einstellungen zu entfernen: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Remove-CsWebServiceConfiguration kann auch für die globale Auflistung ausgeführt werden. In diesem Fall wird die globale Auflistung jedoch nicht wirklich entfernt; vielmehr werden alle Eigenschaften in dieser Auflistung auf ihre Standardwerte zurückgesetzt. Verwenden Sie diese Syntax, um die globale Auflistung zurückzusetzen: -Identity global.

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

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings-Objekt. Remove-CsWebServiceConfiguration akzeptiert eine weitergeleitete Eingabe des Webdienste-Einstellungsobjekts.

Rückgabetypen

Keine. Mit Remove-CsWebServiceConfiguration werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings" gelöscht.

Beispiel

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

Remove-CsWebServiceConfiguration -Identity site:Redmond

Mit dem vorstehenden Befehl werden die Webdienste-Konfigurationseinstellungen für den Standort "Redmond" entfernt.

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

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

In Beispiel 2 werden alle auf Standortebene konfigurierten Webdiensteeinstellungen entfernt. Hierzu ruft der Befehl zunächst Get-CsWebServiceConfiguration mit dem Parameter "Filter" auf. Der Filterwert "site:*" stellt sicher, dass nur die Einstellungen zurückgegeben werden, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese gefilterte Auflistung wird dann an Remove-CsWebServiceConfiguration weitergeleitet, das alle Elemente in der Auflistung löscht.

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

Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $False} | Remove-CsWebServiceConfiguration

Der Befehl in Beispiel 3 löscht alle Webdienste-Konfigurationseinstellungen, bei denen die Gruppenerweiterung deaktiviert wurde. Hierzu ruft der Befehl zunächst Get-CsWebServiceConfiguration ohne Parameter auf, um eine Auflistung aller in der Organisation verwendeten Webdienste-Konfigurationseinstellungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "EnableGroupExpansion" den Wert "False" aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsWebServiceConfiguration weitergeleitet, das alle Elemente in der Auflistung löscht.