Condividi tramite

  • Articolo

Get-CsProxyConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni relative alle impostazioni di configurazione del server proxy attualmente in uso nell'organizzazione.

Sintassi

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

Get-CsProxyConfiguration [-Filter <String>] [-LocalStore <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 di registrazione e Edge Server), consentono di controllare aspetti quali i protocolli di autenticazione utilizzabili dagli endpoint client e se verrà utilizzata o meno la compressione per le connessioni del server proxy in ingresso e in uscita. Quando si installa Lync Server 2010, viene creata automaticamente una raccolta globale di impostazioni di configurazione del server proxy. Come fatto notare, è inoltre possibile creare raccolte ulteriori nell'ambito del servizio.

Il cmdlet Get-CsProxyConfiguration consente di restituire informazioni relative a qualsiasi impostazione di configurazione del server proxy attualmente in uso nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsProxyConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC 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 "Get-CsProxyConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

l'identificatore univoco per le impostazioni di configurazione del server proxy da restituire. Per restituire le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per restituire le impostazioni configurate nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "service:EdgeServer:atl-cs-001.litwareinc.com". Si noti che non è possibile utilizzare i caratteri jolly quando si specifica un parametro Identity. Tuttavia, se si desidera (o è necessario) utilizzare caratteri jolly, utilizzare il parametro Filter.

Se tale parametro non è incluso, Get-CsProxyConfiguration consente di restituire tutte le impostazioni del server proxy attualmente in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per specificare le impostazioni di configurazione del proxy in questione. Ad esempio, con questa sintassi vengono restituite tutte le impostazioni configurate nell'ambito del servizio: -Filter "service:*".

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

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati di configurazione del proxy dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

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

Tipi restituiti

Get-CsProxyConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Esempio

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

Get-CsProxyConfiguration

Con il comando mostrato nell'esempio 1 viene restituita una raccolta di tutte le impostazioni di configurazione del proxy attualmente in uso nell'organizzazione. A tale scopo, Get-CsProxyConfiguration viene richiamato senza alcun parametro.

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

Get-CsProxyConfiguration -Identity "service:EdgeServer:atl-cs-001.litwareinc.com"

Nell'esempio 2 vengono restituite informazioni sulle impostazioni di configurazione del proxy con valore Identity service:EdgeServer:atl-cs-001.litwareinc.com. Poiché le identità devono essere univoche, il comando non restituirà mai più di una raccolta di impostazioni.

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

Get-CsProxyConfiguration -Filter "service:*"

Il comando riportato sopra consente di restituire le informazioni relative a tutte le impostazioni del proxy che sono state configurate nell'ambito del servizio. A tale scopo, con il comando viene richiamato Get-CsProxyConfiguration insieme al parametro Filter, mentre con il valore del filtro "service:*" soltanto le impostazioni con Identity che inizia con il valore stringa "service:" verranno restituite.

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

Get-CsProxyConfiguration | Where-Object {$_.UseCertificateForClientToProxyAuth -eq $False}

Nell'esempio 4 vengono restituite le informazioni relative alle impostazioni di configurazione del proxy che non consentono l'utilizzo dei certificati dei client come meccanismo di autenticazione. Per ottenere tale risultato, con il comando viene innanzitutto utilizzato Get-CsProxyConfiguration per restituire una raccolta di tutte le impostazioni di configurazione del proxy attualmente in uso. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni in cui la proprietà UseCertificateForClientToProxyAuth è uguale a False.

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

Get-CsProxyConfiguration | Where-Object {$_.MaxClientMessageBodySizeKb -lt 5000}

Con il comando riportato sopra vengono restituite tutte le impostazioni di configurazione del proxy in cui le dimensioni massime del corpo per un messaggio del client sono inferiori a 5.000 KB. Per ottenere tale risultato, con il comando viene innanzitutto utilizzato Get-CsProxyConfiguration senza alcun parametro per restituire una raccolta di tutte le impostazioni di configurazione del proxy attualmente in uso. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona le impostazioni in cui la proprietà MaxClientMessageBodySizeKb è minore di 5.000 KB.