Condividi tramite

  • Articolo

Remove-CsProxyConfiguration

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove una raccolta esistente di impostazioni di configurazione del server proxy.

Sintassi

Remove-CsProxyConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 Registrar), consentono di controllare elementi quali i protocolli di autenticazione che possono essere utilizzati dagli endpoint client e se verrà utilizzata o meno la compressione sulle connessioni del server proxy in ingresso e in uscita. Quando si installa Lync Server 2010, viene automaticamente creata una raccolta globale di impostazioni di configurazione del server proxy. Come fatto notare, è inoltre possibile creare raccolte ulteriori nell'ambito del servizio.

Qualsiasi nuova impostazione del server proxy creata può essere successivamente rimossa utilizzando il cmdlet Remove-CsProxyConfiguration. Il cmdlet Remove-CsProxyConfiguration può anche essere eseguito sulla raccolta globale. In questo caso, però, le impostazioni globali non vengono rimosse, perché Lync Server non consente di rimuovere le impostazioni globali. In realtà, tutte le proprietà nella raccolta globale saranno riportate ai loro valori predefiniti. Ad esempio, per impostazione predefinita le impostazioni del server proxy consentono ai client di utilizzare il protocollo Kerberos per l'autenticazione. È possibile modificare le impostazioni globali per disabilitare l'uso di Kerberos. Tuttavia, se si esegue Remove-CsProxyConfiguration sulla raccolta globale, la proprietà in questione (UseKerberosForClientToProxyAuth) viene riportata al valore predefinito e Kerberos viene nuovamente abilitato per l'uso come protocollo di autenticazione.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsProxyConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) 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 "Remove-CsProxyConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per le impostazioni di configurazione del server proxy da rimuovere, ad esempio: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

È inoltre possibile eseguire Remove-CsProxyConfiguration sulle impostazioni globali. In tal caso, però, le impostazioni globali non saranno rimosse. In realtà, le proprietà nella raccolta globale saranno riportate ai loro valori predefiniti.

Force

Facoltativo

Parametro opzionale

Consente di ignorare la visualizzazione di messaggi di errore non irreversibili che possono verificarsi durante l'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. Remove-CsProxyConfiguration consente di accettare le istanze da pipeline dell'oggetto impostazioni proxy.

Tipi restituiti

Nessuno. Remove-CsProxyConfiguration consente invece di eliminare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Esempio

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

Remove-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-011.litwareinc.com

Il comando riportato nell'Esempio 1 consente di eliminare le impostazioni di configurazione proxy con identità service:EdgeServer:atl-edge-litwareinc.com.

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

Get-CsProxyConfiguration -Filter "service:*" | Remove-CsProxyConfiguration

Con l'esempio 2 vengono eliminate tutte le impostazioni di configurazione proxy applicate nell'ambito del servizio. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsProxyConfiguration con il parametro Filter. Il valore del filtro "service:*" garantisce la restituzione delle sole impostazioni proxy con un'identità che inizia con il valore stringa "service:". Tale raccolta filtrata viene quindi inviata tramite pipe a Remove-CsProxyConfiguration, che elimina ciascun elemento nella raccolta.

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

Get-CsProxyConfiguration | Where-Object {$_.TreatAllClientsAsRemote -eq $True} | Remove-CsProxyConfiguration

Con il comando precedente vengono eliminate tutte le impostazioni di configurazione proxy che trattano tutti i client come client remoti. Per ottenere tale risultato, viene chiamato per prima cosa Get-CsProxyConfiguration (senza alcun parametro) per restituire una raccolta di tutte le impostazioni di configurazione del server proxy attualmente in uso. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo le impostazioni in cui la proprietà TreatAllClientsAsRemote equivale a True. Questo subset di impostazioni di configurazione proxy viene quindi inviato tramite pipe a Remove-CsProxyConfiguration, che rimuove tutte le impostazioni nella raccolta.