New-CsProxyConfiguration
Ultima modifica dell'argomento: 2012-03-26
Crea una nuova raccolta di impostazioni di configurazione del server proxy.
Sintassi
New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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>]]
Descrizione dettagliata
Microsoft Lync Server 2010 consente di gestire i server proxy in uso tramite le impostazioni di configurazione del server proxy. Tali impostazioni, che possono essere applicate sia nell'ambito globale che nell'ambito del servizio (anche se soltanto per i servizi Edge Server e di registrazione), consentono di controllare elementi quali i protocolli di autenticazione che possono essere utilizzati dagli endpoint client e se verrà utilizzata o meno la compressione per le connessioni dei server proxy in ingresso e in uscita. Quando si installa Lync Server 2010, viene automaticamente creata una raccolta globale di impostazioni di configurazione dei server proxy. Come fatto notare, è inoltre possibile creare raccolte ulteriori nell'ambito del servizio. Queste nuove raccolte vengono create tramite il cmdlet New-CsProxyConfiguration.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsProxyConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsProxyConfiguration"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Identificatore univoco per le impostazioni di configurazione del server proxy da creare. Le impostazioni di configurazione del server proxy possono essere create unicamente nell'ambito del servizio e solo per i servizi Edge Server e di registrazione. Non è possibile creare le impostazioni nell'ambito globale; analogamente, non è consentito creare impostazioni nell'ambito del servizio nel caso in cui il servizio in questione ospiti già una raccolta di impostazioni del server proxy. Se ad esempio il servizio Registrar:atl-cs-001.litwareinc.com ospita già impostazioni di server proxy, il comando che tenta di creare nuove impostazioni per tale servizio avrà esito negativo. Per specificare l'identità delle nuove impostazioni per il server proxy, utilizzare la sintassi: -Identity "service:Registrar:atl-cs-001.litwareinc.com". |
AcceptClientCompression |
Facoltativo |
Booleano |
Se impostato su True (valore predefinito), il server proxy accetta tutte le richieste di compressione in entrata provenienti dagli endpoint client. |
AcceptServerCompression |
Facoltativo |
Booleano |
Se impostato su True (valore predefinito), il server proxy accetta tutte le richieste di compressione in entrata provenienti da altri server. |
DNSCacheRecordCount |
Facoltativo |
Numero intero |
Numero massimo di record che possono essere presenti nella cache di record DNS. Il valore predefinito è 30.000. |
DisableNTLMFor2010AndLaterClients |
Facoltativo |
Booleano |
Se impostato su True, gli utenti che eseguono l'accesso da Microsoft Lync 2010 devono utilizzare il protocollo Kerberos per autenticarsi. Il valore predefinito è False. |
EnableWhiteSpaceKeepAlive |
Facoltativo |
Booleano |
Se impostato su True (valore predefinito), nel server proxy è previsto l'invio periodico da parte dei client di un messaggio contenente solo spazi (messaggio vuoto senza contenuto) per indicare che la connessione è ancora attiva. |
MaxClientCompressionCount |
Facoltativo |
Numero intero |
Indica il numero massimo di connessioni client-server che è possibile comprimere in un momento specifico; una volta superato questo limite, le connessioni non vengono compresse. Il valore della compressione può essere impostato su qualsiasi numero intero compreso tra 0 e 65535, inclusi. Il valore predefinito è 15000. |
MaxClientMessageBodySizeKB |
Facoltativo |
Numero intero |
La dimensione massima consentita (in kilobyte) per il corpo del messaggio inviato da un endpoint client. Il valore predefinito è 128 e indica che i messaggi di dimensioni maggiori di 128 KB verranno rifiutati. La dimensione del corpo del messaggio client può essere impostata su qualsiasi valore integer compreso fra 64 e 256, inclusi. |
MaxServerCompressionCount |
Facoltativo |
Numero intero |
Indica il numero massimo di connessioni server-server che è possibile comprimere in un momento specifico; una volta superato questo limite, le connessioni non vengono compresse. Il valore della compressione server può essere impostato su qualsiasi numero intero compreso tra 0 e 65535, inclusi. Il valore predefinito è 1024. |
MaxServerMessageBodySizeKB |
Facoltativo |
Numero intero |
La dimensione massima consentita (in kilobyte) per il corpo del messaggio inviato da un altro server. Il valore predefinito è 5000 e indica che i messaggi di dimensioni maggiori di 5000 KB verranno rifiutati. La dimensione del corpo del messaggio server può essere impostata su qualsiasi valore integer compreso fra 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 mentre 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 del server proxy predefinita (Servizio di comunicazioni SIP) o da un'area di autenticazione personalizzata. Le aree di autenticazione personalizzate devono essere specificate, e create, tramite l'utilizzo del cmdlet New-CsSipProxyCustom. |
RequestServerCompression |
Facoltativo |
Booleano |
Se impostato su True (valore predefinito), il server proxy richiede di utilizzare la compressione per 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 attraversano Edge Server che esegue il servizio Access Edge. Il valore predefinito è False. |
UseCertificateForClientToProxyAuth |
Facoltativo |
Booleano |
Se impostato su True (valore predefinito), agli endpoint client è consentita l'autenticazione tramite certificati. |
UseKerberosForClientToProxyAuth |
Facoltativo |
Booleano |
Se impostato su True (valore predefinito), agli endpoint client è consentita l'autenticazione tramite il protocollo Kerberos. Sebbene Kerberos sia un protocollo più sicuro di NTLM, non può essere utilizzato, se il client fa parte di un dominio differente rispetto a quello del server, |
UseNtlmForClientToProxyAuth |
Facoltativo |
Booleano |
Se impostato su True (valore predefinito), agli endpoint client è consentita l'autenticazione tramite il protocollo NTLM. Sebbene NTLM sia un protocollo meno sicuro di Kerberos, può essere utilizzato anche se il client fa parte di un dominio differente rispetto a quello del server, Questa condizione non vale per l'autenticazione Kerberos. |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando. |
InMemory |
Facoltativo |
Parametro opzionale |
Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente. |
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
Nessuno. New-CsProxyConfiguration non accetta l'input da pipeline.
Tipi restituiti
New-CsProxyConfiguration crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.
Esempio
-------------------------- Esempio 1 --------------------------
New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256
Il comando precedente crea una nuova raccolta di impostazioni di configurazione del server proxy per il servizio EdgeServer:atl-edge-001.litwareinc.com. Queste impostazioni utilizzano tutti i valori proprietà del server proxy predefinito ad eccezione dei due valori seguenti: RequestServerCompression, che è impostato su True, e MaxClientMessageBodySizeKb, che è impostato su 256. Si noti che il comando avrà esito negativo se le impostazioni di server proxy sono già state configurate per il servizio EdgeServer:atl-edge-001.litwareinc.com.
-------------------------- Esempio 2 --------------------------
$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x
Con il comando mostrato nell'esempio 2 viene illustrato come sia possibile creare una raccolta di impostazioni del server proxy presenti, inizialmente, solo in memoria. A questo scopo, il comando chiama innanzitutto New-CsProxyConfiguration insieme ai parametri: Identity, che indica l'identità delle impostazioni, e InMemory, che indica che le nuove impostazioni devono essere create solo in memoria. L'oggetto risultante viene archiviato nella variabile $x.
Dopo aver creato le impostazioni virtuali, i comandi 2 e 3 consentono di modificare i valori rispettivamente delle proprietà RequestServerCompression e MaxClientMessageBodySizeKb. Infine, il comando 4 viene utilizzato per trasformare le impostazioni di configurazione del server proxy virtuali in una raccolta di impostazioni reale, applicata al servizio EdgeServer:atl-edge-001.litwareinc.com. Questo ultimo comando è obbligatorio. Se non si chiama Set-CsProxyConfiguration, a EdgeServer:atl-edge-001.litwareinc.com non verrà applicata alcuna impostazione e le impostazioni virtuali verranno eliminate non appena si termina la sessione di Windows PowerShell o si elimina la variabile $x.
Vedere anche
Ulteriori risorse
Get-CsProxyConfiguration
Remove-CsProxyConfiguration
Set-CsProxyConfiguration