編輯

共用方式為


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

String

The settings location template ID.