Remove-CsTelemetryConfiguration
Use the Remove-CsTelemetryConfiguration
cmdlet to remove an existing telemetry configuration.
UNRESOLVED_TOKEN_VAL(PS_TelemetryDataStatement)
Syntax
Remove-CsTelemetryConfiguration
[-Identity] <XdsIdentity>
[-Confirm]
[-Force]
[-WhatIf]
[<CommonParameters>]
Description
For privacy information, see the Skype for Business Privacy Statement (https://go.microsoft.com/fwlink/?LinkID=517480&clcid=0x409).
Examples
-------------------------- Example 1 --------------------------
Remove-CsTelemetryConfiguration -Identity Site:Redmond
This example removes the telemetry configuration for the Redmond site.
-------------------------- Example 2 --------------------------
Get-CsTelemetryConfiguration -Filter "Site:*" | Remove-CsTelemetryConfiguration
This example uses the Get-CsTelemetryConfiguration
cmdlet in combination with the Filter parameter to select the telemetry configurations that are configured at the site level and then pipelines them to the Remove-CsTelemetryConfiguration
cmdlet for removal.
The result is that all "Site" scoped telemetry configurations are removed.
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: | Skype for Business Server 2015, Skype for Business Server 2019 |
-Force
Suppresses the display of any non-fatal error messages and completes the cmdlet operation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
A unique identifier that includes the scope of the telemetry configuration. Telemetry configurations can be scoped at the Global, Site, or Service level. For example, "site:Redmond" (for site). The format of the service scope is "Service:<Identity>", where identity is derived from the topology. You can use the following commands to identify the relevant services.
Get-CsService -WebServer | fl Identity
Get-CsService -PoolFqdn \<pool\> | fl Identity
The first command will give you all of the WebServices in the topology, regardless of the pool. The second will give you all of the services on the pool, regardless of their role. You can combine the two commands to zero in on a single role in a single pool.
The Global configuration can't be deleted. Specifying the Global configuration will return it to the default Global settings.
Type: | XdsIdentity |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | 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: | Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
This cmdlet takes pipeline input of the Get-CsTelemetryConfiguration
cmdlet as shown in Example 2.
Outputs
None.