Remove-CsProxyConfiguration

Remove-CsProxyConfiguration
    [-Identity] <XdsIdentity>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Skype for Business Server enables you to manage your proxy servers through proxy server configuration settings. These settings, which can be applied at both the global scope and the service scope (albeit for only the Edge Server and Registrar services) enable you to control such things as the authentication protocols that can be used by client endpoints and whether or not compression will be used on incoming and outgoing proxy server connections. When you install Skype for Business Server, a global collection of proxy server configuration settings is automatically created for you. As noted, you can also create additional collections at the service scope.

Any new proxy server settings you create can later be removed by using the Remove-CsProxyConfiguration cmdlet. You can also run the Remove-CsProxyConfiguration cmdlet against the global collection. In that case, however, the global settings will not be removed; that's because Skype for Business Server does not allow you to remove global settings. Instead, all of the properties within the global collection will be reset to their default values. For example, by default proxy server settings allow clients to use the Kerberos protocol for authentication. You can change the global settings to disable the use of Kerberos. However, if you run the Remove-CsProxyConfiguration cmdlet against the global collection, the property in question (UseKerberosForClientToProxyAuth) will be reset to its default value and Kerberos will again be enabled for use as an authentication protocol.

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

The command shown in Example 1 deletes the proxy configuration settings that have the Identity service:EdgeServer:atl-edge-litwareinc.com.

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

In Example 2, all of the proxy configuration settings applied at the service scope are deleted. To accomplish this task, the command first calls the Get-CsProxyConfiguration cmdlet along with the Filter parameter. The filter value "service:*" ensures that only proxy settings that have an Identity that begins with the string value "service:" will be returned. That filtered collection is then piped to the Remove-CsProxyConfiguration cmdlet, which deletes each item in the collection.

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

Example 3 deletes any proxy configuration settings that treat all clients as remote clients. To do this, the Get-CsProxyConfiguration cmdlet is first called without any parameters in order to return a collection of all the proxy server configuration settings currently in use. This collection is then piped to the Where-Object cmdlet, which selects only those settings where the TreatAllClientsAsRemote property is equal to True. This subset of proxy configuration settings is then piped to the Remove-CsProxyConfiguration cmdlet, which removes all the settings in the collection.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

The Remove-CsProxyConfiguration cmdlet accepts pipelined instances of the proxy settings object.