Unregister-Uev Template

Module:
uev
Unregisters a settings location template from Microsoft User Experience Virtualization (UE-V).

Syntax 

Unregister-UevTemplate
          [-ID] <String>
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-UevTemplate
          [-All]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

The Unregister-UevTemplate cmdlet unregisters a settings location template from Microsoft User Experience Virtualization (UE-V). A template defines settings to synchronize between computers. After you unregister a template, UE-V no longer synchronizes those settings. If you try to unregister a template that is not registered, the cmdlet returns an error.

You must have administrative credentials to run this cmdlet.

Examples

Example 1: Unregister a template 

PS C:\> Unregister-UevTemplate -TemplateId "MicrosoftCalculator6"

This command unregisters a settings location template that has the ID MicrosoftCalculator6.

Example 2: Unregister templates for applications that match a specified string 

PS C:\> Get-UevTemplate -Application "calc" | Unregister-UevTemplate

This command uses the Get-UevTemplate cmdlet to get all the registered settings location templates whose application name contains the specified string, and then passes them to the current cmdlet by using the pipeline operator. The cmdlet unregisters all the templates for applications that contain the string calc.

Example 3: Unregister all templates 

PS C:\> Unregister-UevTemplate -All

This command unregisters all the settings location templates that are currently registered with UE-V.

Required Parameters

-All

Indicates that the cmdlet unregisters all settings location templates.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ID

Specifies the ID of a settings location template. The cmdlet unregisters the template that you specify. If you specify an ID for a template that is not registered, the cmdlet returns an error.

Type: String
Aliases: TemplateID
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Aliases: cf
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Aliases: wi
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Inputs

System.String

The settings location template ID.