Condividi tramite

  • Articolo

Get-CsWebServiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni su tutte le impostazioni di configurazione dei servizi Web in uso nell'organizzazione.

Sintassi

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

Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <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 dei servizi Web nell'organizzazione, ad esempio la gestione dell'espansione dei gruppi, delle impostazioni dei certificati e dei metodi di autenticazione consentiti. Poiché nell'ambito globale, del sito e del servizio è possibile configurare impostazioni diverse, anche se solo per il servizio Servizi Web, le funzionalità dei servizi Web possono essere personalizzate per utenti e postazioni differenti.

Il cmdlet Get-CsWebServiceConfiguration consente di restituire informazioni dettagliate sulle impostazioni di configurazione dei servizi Web attualmente in uso nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsWebServiceConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

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

Non è possibile utilizzare i parametri Filter e Identity nello stesso comando. Se non viene specificato un parametro, Get-CsWebServiceConfiguration restituirà tutte le raccolte delle impostazioni dei servizi Web attualmente in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per specificare la raccolta o le raccolte di impostazioni di configurazione dei servizi Web da restituire. Ad esempio, la sintassi che segue restituisce tutte le informazioni configurate nell'ambito del sito: -Filter "site:*".

Non è possibile utilizzare i parametri Filter e Identity nello stesso comando.

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati di configurazione dei servizi Web dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsWebServiceConfiguration non accetta l'input da pipeline.

Tipi restituiti

Get-CsWebServiceConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings.

Esempio

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

Get-CsWebServiceConfiguration

Il comando precedente restituisce informazioni su tutte le impostazioni di configurazione dei servizi Web attualmente in uso nell'organizzazione.

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

Get-CsWebServiceConfiguration -Identity site:Redmond

Il comando mostrato nell'esempio 2 restituisce informazioni sulle impostazioni di configurazione dei servizi Web con valore Identity site:Redmond.

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

Get-CsWebServiceConfiguration -Filter "site:*"

Nell'esempio 3 vengono restituite tutte le impostazioni di configurazione dei servizi Web assegnate nell'ambito del sito. A questo scopo, quando si chiama Get-CsWebServiceConfiguration viene incluso il parametro Filter; il valore di filtro "site:*" assicura che vengano restituite solo le impostazioni la cui identità inizia con il valore stringa "site:".

-------------------------- Esempio 4 ------------------------

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

Nell'esempio 4 il comando restituisce tutte le impostazioni di configurazione dei servizi Web che non consentono l'autenticazione tramite PIN (Personal Identification Number). Questa operazione viene eseguita chiamando innanzitutto Get-CsWebServiceConfiguration per restituire tutte le impostazioni di configurazione dei servizi Web attualmente in uso. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona unicamente le impostazioni con proprietà UsePinAuth uguale a False.

-------------------------- Esempio 5 ------------------------

Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}

Il comando precedente restituisce tutte le impostazioni di configurazione dei servizi Web in cui la dimensione massima dell'espansione dei gruppi è maggiore di 100. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsWebServiceConfiguration per restituire tutte le impostazioni di configurazione dei servizi Web attualmente in uso. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Where-Object, che seleziona unicamente le impostazioni con proprietà MaxGroupSizeToExpand maggiore di 100.