Remove-CsTelemetryConfiguration

Reference

Module:: SkypeForBusiness

Applies to:: Skype for Business Server 2015, Skype for Business Server 2019

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.