< Back

Unregister-UevTemplate

Wed Jan 30, 2019 6:05 pm

NAME Unregister-UevTemplate



SYNOPSIS

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





SYNTAX

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



Unregister-UevTemplate [-ID] <String> [-Confirm] [-WhatIf] [<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.





PARAMETERS

-All <SwitchParameter>

Indicates that the cmdlet unregisters all settings location templates.



Required? true

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-ID <String>

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.



Required? true

Position? 1

Default value none

Accept pipeline input? True (ByValue, ByPropertyName)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value false

Accept pipeline input? false

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

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



Required? false

Position? named

Default value false

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String



The settings location template ID.





OUTPUTS









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.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=826059

Disable-UevTemplate

Enable-UevTemplate

Get-UevTemplate

Register-UevTemplate

Test-UevTemplate

Update-UevTemplate