Remove-CsPresenceProvider
Removes a presence provider previously configured for use in the organization. Presence providers represent the PresenceProviders property of a collection of user services configuration settings. This cmdlet was introduced in Lync Server 2013.
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
Prompts you for confirmation before executing the command.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Force
Suppresses the display of any non-fatal error message that might occur when running the command.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
Unique identifier of the presence provider to be removed. To remove a single provider, use the actual Identity of the provider, which includes both the scope and the provider Fqdn:
-Identity "global/fabrikam.com"
To remove all the presence providers configured at a particular scope, simply use the scope as the Identity. This syntax removes all the providers configured at the global scope:
-Identity "global"
Type: | XdsIdentity |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour