Set-CsWebServiceConfiguration
Ultima modifica dell'argomento: 2012-04-23
Consente di modificare una raccolta esistente di impostazioni di configurazione servizi Web.
Sintassi
Set-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Set-CsWebServiceConfiguration [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-Instance <PSObject>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-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à. Ad esempio, gli utenti utilizzano un servizio Web quando cercano i nuovi contatti nella Rubrica o quando utilizzano la funzionalità di espansione per visualizzare i singoli membri di un gruppo di distribuzione. Allo stesso modo, i componenti che vanno dalle conferenza telefoniche con accesso esterno a 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. Questo comprende 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. I cmdlet CsWebServiceConfiguration (Get-CsWebServiceConfiguration, New-CsWebServiceConfiguration, Remove-CsWebServiceConfiguration e Set-CsWebServiceConfiguration) consentono agli amministratori di gestire le impostazioni di configurazione di servizi Web attraverso tutta l'organizzazione. Questo comprende 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.
È possibile specificare impostazioni personalizzate (ad esempio, periodi di validità personalizzati per i certificati) nel momento in cui si crea una nuova raccolta di impostazioni di configurazione di servizi Web. In alternativa, è possibile modificare le proprietà di una raccolta esistente utilizzando il cmdlet Set-CsWebServiceConfiguration.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-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 "Set-CsWebServiceConfiguration"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Identificatore univoco per le impostazioni di configurazione di servizi Web da modificare. Per modificare le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per modificare le impostazioni configurate nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "service:WebServer:atl-cs-001.litwareinc.com". Per modificare le impostazioni configurate nell'ambito globale, utilizzare la sintassi seguente: -identity global. Se non viene utilizzato il parametro Identity, il cmdlet Set-CsWebServiceConfiguration modifica automaticamente la raccolta globale. |
Instance |
Obbligatorio |
Oggetto WebServiceSettings |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
AllowAnonymousAccessToLWAConference |
Facoltativo |
Booleano |
Se impostato su True, gli utenti anonimi possono partecipare a conferenze di Lync Web App (LWA). |
CASigningKeyLength |
Facoltativo |
Numero intero |
Impostare la dimensione della chiave di firma CA, la chiave privata utilizzata da una CA per firmare i certificati digitali. La lunghezza della chiave di firma può essere impostata su qualsiasi numero intero compreso tra 2048 e 16384 byte; il valore predefinito è 2048. |
DefaultValidityPeriodHours |
Facoltativo |
Numero intero |
Quando si utilizza l'autenticazione con certificato, i client possono richiedere il periodo di validità (in ore) del certificato. DefaultValidityPeriodHours è la durata di validità di un certificato se il client non richiede un periodo di validità personalizzato. DefaultValidityPeriodHours può essere impostato su qualsiasi numero intero compreso tra 8 e 8760 ore (365 giorni). Il valore predefinito è 4320 (180 giorni). |
EnableCertChainDownload |
Facoltativo |
Booleano |
Se impostato su True, i server a cui verrà presentato un certificato di autenticazione, scaricheranno la catena relativa a quel certificato. La catena di certificati risale all'autorità di certificazione (CA) che ha emesso il certificato. I certificati non verranno accettati se l'autorità di certificazione (CA) che li ha emessi non è considerata attendibile. |
EnableGroupExpansion |
Facoltativo |
Se impostato su True, l'espansione dei gruppi sarà abilitata in Microsoft Lync 2010. Con l'espansione dei gruppi, gli utenti possono configurare un gruppo di distribuzione come contatto, quindi "espandere" il gruppo. Una volta espanso un gruppo, gli utenti possono vedere i singoli membri di un gruppo e le relative informazioni sulla presenza. |
|
InferCertChainFromSSL |
Facoltativo |
Booleano |
Se impostato su True, i server utilizzeranno le informazioni sul certificato incluse nel protocollo SSL (Secure Sockets Layer) per individuare l'autorità di certificazione (CA) emittente. I certificati non verranno accettati se l'autorità di certificazione (CA) che li ha emessi non è considerata attendibile. |
MACResolverUrl |
Facoltativo |
Stringa |
URL di un servizio Web in grado di eseguire la risoluzione MAC (Media Access Control). La risoluzione MAC consiste nell'individuazione, a partire dall'indirizzo IP, dell'indirizzo MAC della scheda di rete associata all'indirizzo IP. |
MaxCSRKeySize |
Facoltativo |
Numero intero |
Consente di impostare la dimensione massima della chiave di richiesta di firma del certificato (CSR). Una richiesta CSR è un messaggio inviato da un richiedente a una CA per richiedere un certificato digitale. La dimensione di una chiave CSR può essere impostata su qualsiasi numero intero compreso tra 1024 e 16384 byte. Il valore predefinito è 16384. |
MaxGroupSizeToExpand |
Facoltativo |
Numero intero |
Rappresenta il numero massimo di persone che verrà visualizzato quando si espande un gruppo. Ad esempio, se MaxGroupSizeToExpand è impostato su 75, verranno visualizzati solo i primi 75 membri del gruppo ogni volta che il gruppo viene espanso. MaxGroupSizeToExpand può essere impostato su qualsiasi numero intero compreso tra 1 e 1000, inclusi. Il valore predefinito è 100. |
MaxValidityPeriodHours |
Facoltativo |
Numero intero |
Quando si utilizza l'autenticazione con certificato, i client possono richiedere il periodo di validità (in ore) del certificato. MaxValidityPeriodHours è il numero massimo di tempo che un client può richiedere. MaxValidityPeriodHours può essere impostato su qualsiasi numero intero compreso tra 8 e 8760 ore (365 giorni). Il valore predefinito è 8760. |
MinCSRKeySize |
Facoltativo |
Numero intero |
Consente di impostare la dimensione minima della chiave CSR (Certificate Signing Request). La dimensione minima può essere impostata su qualsiasi valore intero compreso tra 1024 e 16384. Il valore predefinito è 16384. |
MinValidityPeriodHours |
Facoltativo |
Numero intero |
Quando si utilizza l'autenticazione con certificato, i client possono richiedere il periodo di validità (in ore) del certificato. MinValidityPeriodHours è il numero minimo di tempo che un client può richiedere. MinValidityPeriodHours può essere impostato su qualsiasi numero intero compreso tra 8 e 4320 ore (180 giorni). Il valore predefinito è 8. |
SecondaryLocationSourceUrl |
Facoltativo |
Stringa |
URL di un servizio Web in grado di elaborare una richiesta di percorso. Questo servizio viene utilizzato solo quando le richieste di percorso non possono essere risolte localmente. |
ShowDownloadCommunicatorAttendeeLink |
Facoltativo |
Booleano |
Se l'impostazione è True (valore predefinito), gli utenti che partecipano a una riunione online utilizzando un'applicazione client diversa da Lync 2010 vedranno un collegamento che punta al download di Lync 2010 Attendee. |
ShowJoinUsingLegacyClientLink |
Facoltativo |
Booleano |
Se l'impostazione è True, gli utenti che partecipano a una riunione online utilizzando un'applicazione client diversa da Lync 2010 avranno l'opportunità di partecipare alla riunione utilizzando l'applicazione client corrente. Il valore predefinito è False. |
TrustedCACerts |
Facoltativo |
Raccolta di certificati |
Raccolta di certificati che rappresenta le catene di certificati considerati attendibili dal server Web. I nuovi certificati aggiunti alla raccolta devono essere creati con il cmdlet New-CsWebTrustedCACertificate. La raccolta non viene utilizzata se la proprietà InferCertChainFromSSL è impostata su True. |
UseCertificateAuth |
Facoltativo |
Booleano |
Se impostato su True (il valore predefinito), i client possono essere autenticati con i certificati. Impostare questo valore su False per disabilitare l'autenticazione dei certificati. |
UsePinAuth |
Facoltativo |
Booleano |
Se impostato su True (il valore predefinito), i client possono essere autenticati con i numeri PIN. Impostare questo valore su False per disabilitare l'autenticazione dei PIN. |
UseWindowsAuth |
Facoltativo |
Modificatore dell'elenco PS |
Consente di stabilire come (e se) autenticare gli utenti con l'autenticazione di Windows; vale a dire, con le stesse credenziali utilizzate per la connessione a Windows. I valori validi sono: Negotiate – il client e il server collaborano per stabilire il protocollo di autenticazione (Kerberos o NTLM) appropriato. NTLM – l'autenticazione di Windows è consentita, ma solo con il protocollo NTLM. None – l'autenticazione di Windows non è consentita. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di prompt di conferma o messaggi di errore non irreversibile che possono verificarsi quando si esegue il cmdlet. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Set-CsWebServiceConfiguration accetta gli input tramite pipeline dell'oggetto impostazioni di servizi Web.
Tipi restituiti
Set-CsWebServiceConfiguration non restituisce alcun oggetto o valore. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $True
Nell'Esempio 1, viene abilitata l'espansione dei gruppi per le impostazioni di configurazione di servizi Web applicate al sito Redmond (-Identity site:Redmond). Per ottenere questo risultato, si specifica la proprietà EnableGroupExpansion e si imposta il parametro su True.
-------------------------- Esempio 2 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Set-CsWebServiceConfiguration -MaxValidityPeriodHours 16
Nell'Esempio 2, il periodo massimo di validità per tutte le impostazioni di configurazione di servizi Web applicate all'ambito del sito viene impostato su 16 ore. Per ottenere questo risultato, viene prima utilizzato Get-CsWebServiceConfiguration insieme al parametro Filter; il filtro "site:*" restituisce solo i dati relativi a quelle impostazioni la cui identità inizia con i caratteri "site:". Questa raccolta quindi viene inviata tramite pipe al cmdlet Set-CsWebServiceConfiguration che imposta il valore 16 per la proprietà MaxValidityPeriodHours di ogni singolo elemento della raccolta.
-------------------------- Esempio 3 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $True} | Set-CsWebServiceConfiguration -MaxGroupSizeToExpand 400
Nel comando precedente, la dimensione di espansione dei gruppi è impostata su 400 per ogni raccolta di impostazioni di configurazione di servizi Web per cui è consentita l'espansione dei gruppi. Per ottenere questo risultato, viene utilizzato 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 viene quindi inviata tramite pipe a Where-Object, che seleziona solo le impostazioni in cui EnableGroupExpansion equivale a True. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsWebServiceConfiguration che imposta il valore 400 per la proprietà MaxGroupSizeToExpand di ogni singolo elemento nella raccolta.
-------------------------- Esempio 4 ------------------------
Set-CsWebServiceConfiguration -Identity global -ShowDownloadCommunicatorAttendeeLink $True
Il comando riportato nell'Esempio 4 mostra come le impostazioni globali di servizi Web possono essere configurate in modo che ad ogni persona che partecipa alla riunione utilizzando una applicazione client diversa da Lync 2010 venga prima mostrato un collegamento ad un sito dove è possibile scaricare Lync 2010 Attendee. Per ottenere questo risultato, si specifica il parametro ShowDownloadCommunicatorAttendeeLink e si imposta il parametro su True.
Vedere anche
Ulteriori risorse
Get-CsWebServiceConfiguration
New-CsWebServiceConfiguration
Remove-CsWebServiceConfiguration