Edit

Share via

Remove-CsTelemetryConfiguration

Module:
Skype for Business Server PowerShell

Use the Remove-CsTelemetryConfiguration cmdlet to remove an existing telemetry configuration. UNRESOLVED_TOKEN_VAL(PS_TelemetryDataStatement)

Syntax

Default (Default) 

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

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

Prompts you for confirmation before executing the command.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

Suppresses the display of any non-fatal error messages and completes the cmdlet operation.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

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.

Parameter properties

Type:XdsIdentity
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:2
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

Applicable: Skype for Business Server 2015, Skype for Business Server 2019

Describes what would happen if you executed the command without actually executing the command.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

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.

Inputs

XdsIdentity

This cmdlet takes pipeline input of the Get-CsTelemetryConfiguration cmdlet as shown in Example 2.

Outputs

None