Condividi tramite

  • Articolo

Set-CsProxyConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Consente di modificare una raccolta di impostazioni di configurazione del server proxy.

Sintassi

Set-CsProxyConfiguration [-Identity <XdsIdentity>] [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsProxyConfiguration [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Microsoft Lync Server 2010 consente di gestire i server proxy tramite le impostazioni di configurazione. Queste impostazioni, che possono essere applicate sia all'ambito globale che all'ambito di servizio (anche se solo per il servizio Edge Server e il servizio di registrazione), consentono di controllare, ad esempio, i protocolli di autenticazione utilizzabili dagli endpoint client e se utilizzare la compressione sulle connessioni in ingresso e in uscita del server proxy. Quando si installa Lync Server 2010, viene creata automaticamente una raccolta di impostazioni di configurazione del server proxy. Come fatto notare, è inoltre possibile creare raccolte ulteriori nell'ambito del servizio.

Il cmdlet Set-CsProxyConfiguration offre la possibilità di modificare le proprietà di una raccolta di impostazioni di configurazione del server proxy.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsProxyConfiguration 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-CsProxyConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco delle impostazioni di configurazione del server proxy da modificare. Per modificare le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per modificare le impostazioni configurate nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "service: EdgeServer:atl-edge-001.litwareinc.com".

Se non viene incluso questo parametro, Set-CsProxyConfiguration modificherà automaticamente le impostazioni globali.

Instance

Facoltativo

Oggetto ProxySettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

AcceptClientCompression

Facoltativo

Booleano

Se impostato su True (il valore predefinito), il server proxy accetterà tutte le richieste di compressione in ingresso dagli endpoint client.

AcceptServerCompression

Facoltativo

Booleano

Se impostato su True (il valore predefinito), il server proxy accetterà tutte le richieste di compressione in ingresso da altri server.

DisableNTLMFor2010AndLaterClients

Facoltativo

Booleano

Se impostato su True, gli utenti che accedono da Microsoft Lync 2010 devono utilizzare il protocollo Kerberos per l'autenticazione. Il valore predefinito è False.

DNSCacheRecordCount

Facoltativo

Numero intero

Numero massimo di record che possono essere presenti nella cache di record DNS. Il valore predefinito è 30.000.

EnableWhiteSpaceKeepAlive

Facoltativo

Booleano

Se impostato su True (il valore predefinito), il server proxy si aspetta l'invio periodico da parte dei clienti di un messaggio contenente solo spazi (un messaggio vuoto senza contenuto) per segnalare che la connessione è ancora attiva.

MaxClientCompressionCount

Facoltativo

Numero intero

Indica il numero massimo delle connessioni client-server comprimibili in un determinato momento; le connessioni aggiuntive oltre questo limite non verranno compresse. Il numero di compressioni può essere impostato su qualsiasi numero intero compreso tra 0 e 65535, inclusi. Il valore predefinito è 15000.

MaxClientMessageBodySizeKB

Facoltativo

Numero intero

Dimensione massima consentita (in kilobyte) per il corpo di un messaggio inviato da un endpoint client. Il valore predefinito è 128, il che significa che i messaggi con un corpo maggiore di 128 KB verranno respinti. La dimensione massima del corpo del messaggio inviato dal client può essere impostata su qualsiasi numero intero compreso tra 64 e 256, inclusi.

MaxServerCompressionCount

Facoltativo

Numero intero

Indica il numero massimo delle connessioni server-server comprimibili in un determinato momento; le connessioni aggiuntive oltre questo limite non verranno compresse. Il numero di compressioni da server può essere impostato su qualsiasi numero intero compreso tra 0 e 65535, inclusi. Il valore predefinito è 1024.

MaxServerMessageBodySizeKB

Facoltativo

Numero intero

Dimensione massima consentita (in kilobyte) per il corpo di un messaggio inviato da un altro server. Il valore predefinito è 5000, il che significa che i messaggi con un corpo maggiore di 5000 KB verranno respinti. La dimensione massima del corpo del messaggio inviato dal server può essere impostata su qualsiasi numero intero compreso tra 1000 e 20000, inclusi.

OutgoingTLSCount

Facoltativo

Numero intero

Specifica il numero massimo di connessioni Transport Layer Security (TLS) che possono essere utilizzate per ciascun server interno. Il numero minimo di connessioni TLS è 1 e il numero massimo è 4. Per impostazione predefinita, OutgoingTlsCount è impostato su 4.

Realm

Facoltativo

Oggetto SipProxy

Indica se le credenziali di sicurezza vengono elaborate dall'area di autenticazione predefinita del server proxy (servizi di comunicazione SIP ) o da un'area di autenticazione personalizzata. Le aree di autenticazione personalizzate devono essere specificate (e create) utilizzando il cmdlet New-CsSipProxyCustom.

RequestServerCompression

Facoltativo

Booleano

Se impostato su True (il valore predefinito), il server proxy richiede che venga utilizzata la compressione su tutte le connessioni in uscita verso altri server.

TreatAllClientsAsRemote

Facoltativo

Booleano

Se impostato su True, il server proxy funziona come se tutte le connessioni client fossero connessioni esterne che passano attraverso il server Edge Server. Il valore predefinito è False.

UseCertificateForClientToProxyAuth

Facoltativo

Booleano

Se impostato su True (il valore predefinito), gli endpoint client sono autorizzati a utilizzare i certificati di autenticazione.

UseKerberosForClientToProxyAuth

Facoltativo

Booleano

Se impostato su True (il valore predefinito), gli endpoint client sono autorizzati a utilizzare il protocollo Kerberos per l'autenticazione. Anche se è un protocollo più sicuro di NTLM, Kerberos non può essere utilizzato se il client appartiene a un dominio diverso da quello del server.

UseNtlmForClientToProxyAuth

Facoltativo

Booleano

Se impostato su True (il valore predefinito), gli endpoint client sono autorizzati a utilizzare il protocollo NTLM per l'autenticazione. Anche se è un protocollo meno sicuro di Kerberos, NTLM può essere utilizzato se il client appartiene a un dominio diverso da quello del server. Lo stesso non vale per l'autenticazione Kerberos.

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

Facoltativo

Parametro opzionale

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

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings. Set-CsProxyConfiguration accetta le istanze inviate tramite pipeline dell'oggetto impostazioni proxy.

Tipi restituiti

Set-CsProxyConfiguration non restituisce alcun oggetto o valore. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Esempio

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

Set-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-001.litwareinc.com -AcceptServerCompression $True

Nell'Esempio 1, le impostazioni di configurazione proxy che hanno come Identity service:EdgeServer:atl-edge-001.litwareinc.com sono state modificate per accettare la compressione del server. Per ottenere questo risultato, viene utilizzato il cmdlet Set-CsProxyConfiguration e il parametro AcceptServerCompression impostato su True.

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

Get-CsProxyConfiguration | Where-Object {$_.AcceptServerCompression -eq $True} | Set-CsProxyConfiguration -AcceptClientCompression $True

Il comando precedente individua le impostazioni di configurazione proxy che accettano la compressione del server e quindi modifica queste impostazioni per accettare anche la compressione del client. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsProxyConfiguration senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le impostazioni proxy utilizzate nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo quei criteri in cui la proprietà AcceptServerCompression è uguale a True. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsProxyConfiguration che imposta il valore True per la proprietà AcceptClientCompression di ogni singolo elemento della raccolta.

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

Get-CsProxyConfiguration -Filter service:* | Set-CsProxyConfiguration -UseNtlmForClientToProxyAuth $False

L'Esempio 3 mostra come modificare tutte le impostazioni proxy configurate nell'ambito del servizio. Per ottenere questo risultato, il comando utilizza prima Get-CsProxyConfiguration e include il parametro Filter; il 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 Set-CsProxyConfiguration che imposta il valore True per la proprietà UseNtlmForClientToProxyAuth di ogni singolo elemento della raccolta.