Remove-CsPresenceProvider

Syntax

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

Description

The CsPresenceProvider cmdlets are used to manage the PresenceProviders property found in the User Services configuration settings. Among other things, these settings are used to maintain presence information, including a collection of authorized presence providers. That collection is stored in the PresenceProviders property.

The Remove-CsPresenceProvider cmdlet enables you to remove a presence provider from the PresenceProviders property of one or more collections of User Services configuration settings.

Skype for Business Server Control Panel: The functions carried out by the Remove-CsPresenceProvider cmdlet are not available in the Skype for Business Server Control Panel.

Examples

-------------------------- Example 1 --------------------------

Remove-CsPresenceProvider -Identity "global/fabrikam.com"

The command shown in Example 1 removes the presence provider with the Identity "global/fabrikam.com".

-------------------------- Example 2 --------------------------

Get-CsPresenceProvider | Remove-CsPresenceProvider

In Example 2, all the presence providers configured for use in the organization are removed. To do this, the command first calls the Get-CsPresenceProvider cmdlet without any parameters; that returns a collection of all the configured presence providers. That collection is then piped to the Remove-CsPresenceProvider cmdlet, which deletes each item (that is, each provider) in the collection.

-------------------------- Example 3 --------------------------

Get-CsPresenceProvider | Where-Object {$_.Fqdn -match "fabrikam.com"} | Remove-CsPresenceProvider

Example 3 shows how you can delete all the presence providers that have an Fqdn that includes the string value "fabrikam.com". To carry out this task, the command first uses the Get-CsPresenceProvider cmdlet to return a collection of all the available presence providers. That collection is then piped to the Where-Object cmdlet, which picks out only those providers where the Fqdn property includes (-match) the string value "fabrikam.com". In turn, that filtered collection is then piped to the Remove-CsPresenceProvider cmdlet, which deletes each provider in the filtered collection.

Parameters

-Confirm

-Force

-Identity

-WhatIf

Inputs

The Remove-CsPresenceProvider cmdlet accepts pipelined instances of the Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.PresenceProvider#Decorated object.

Outputs

None. Instead, the Remove-CsPresenceProvider cmdlet deletes instances of the Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.PresenceProvider#Decorated object.

Related Links

• Get-CsPresenceProvider
• Get-CsUserServicesConfiguration
• New-CsPresenceProvider
• Set-CsPresenceProvider