Condividi tramite

  • Articolo

Remove-CsWebServiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di rimuovere una o più raccolte di impostazioni di configurazione di servizi Web.

Sintassi

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

Descrizione dettagliata

Molti componenti di Microsoft Lync Server 2010 sono basati su Web: questi componenti utilizzano i servizi Web o le pagine Web per eseguire le attività. Gli utenti utilizzano, ad esempio, un servizio Web quando cercano i nuovi contatti nella Rubrica o quando utilizzano l'espansione gruppo per visualizzare i singoli membri di un gruppo di distribuzione. Analogamente, i componenti che vanno dalle conferenze telefoniche con accesso esterno al Pannello di controllo di Microsoft Lync Server 2010 utilizzano le pagine Web come interfaccia tra Lync Server 2010 e gli utenti.

I cmdlet CsWebServiceConfiguration consentono agli amministratori di gestire le impostazioni di configurazione di servizi Web per tutta l'organizzazione. Ciò include anche la gestione dell'espansione dei gruppi, delle impostazioni dei certificati e dei metodi di autenticazione consentiti. Poiché è possibile configurare impostazioni diverse nell'ambito globale, del sito e del servizio (sebbene, in quest'ultimo caso, solo per i servizi Web), è altresì possibile personalizzare le funzionalità di servizi Web per utenti diversi in luoghi diversi.

Se si creano delle impostazioni di servizi Web personalizzate nell'ambito del sito o del servizio, sarà possibile rimuoverle successivamente utilizzando il cmdlet Remove-CsWebServiceConfiguration. Si noti che è possibile utilizzare il cmdlet Remove-CsWebServiceConfiguration anche per la raccolta globale di impostazioni di servizi Web. In questo caso, tuttavia, la raccolta globale non verrà rimossa, in quanto in Lync Server le impostazioni globali non possono essere rimosse. Ciò che accade in realtà è che per tutte le proprietà della raccolta globale verranno ripristinati i valori predefiniti. Ad esempio, si supponga di aver portato il valore della proprietà MaxGroupSizeToExpand a 500. Poiché il valore predefinito di questa proprietà è 100, la "rimozione" della raccolta globale determina il ripristino del valore 100 per la proprietà MaxGroupSizeToExpand.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsWebServiceConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsWebServiceConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco delle impostazioni di configurazione di servizi Web da rimuovere. Per rimuovere le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per rimuovere le impostazioni configurate nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Remove-CsWebServiceConfiguration può essere utilizzato anche per la raccolta globale. In questo caso, tuttavia, la raccolta globale non vrerrà rimossa; in realtà, per tutte le proprietà della raccolta globale verranno ripristinati i valori predefiniti. Per ripristinare la raccolta globale, utilizzare la seguente sintassi: -Identity global.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Remove-CsWebServiceConfiguration accetta gli input tramite pipeline dell'oggetto impostazioni di servizi Web.

Tipi restituiti

Nessuno. Remove-CsWebServiceConfiguration elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.

Esempio

-------------------------- Esempio 1 --------------------------

Remove-CsWebServiceConfiguration -Identity site:Redmond

Il comando precedente consente di rimuovere le impostazioni di configurazione di servizi Web per il sito Redmond.

-------------------------- Esempio 2 --------------------------

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

Nell'Esempio 2 vengono rimosse tutte le impostazioni di servizi Web configurate nell'ambito del sito. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsWebServiceConfiguration e include il parametro Filter; il valore del filtro "service:*" garantisce che solo le impostazioni che hanno un'identità che inizia con la stringa "service:" vengano restituite. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsWebServiceConfiguration che elimina ogni elemento della raccolta.

-------------------------- Esempio 3 --------------------------

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

Il comando riportato nell'Esempio 3 consente di eliminare tutte le impostazioni di configurazione di servizi Web in cui l'espansione dei gruppi è stata disabilitata. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsWebServiceConfiguration senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le impostazioni di configurazione di servizi Web utilizzate nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle impostazioni in cui la proprietà EnableGroupExpansion è uguale a False. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsWebServiceConfiguration che elimina ogni elemento nella raccolta.