Unregister-UevTemplate
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.
Parameters
-All
Indicates that the cmdlet unregisters all settings location templates.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
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 |
Required: | True |
Accept pipeline input: | True |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
The settings location template ID.