Edit

Register-UevTemplate

  • Reference
Module:
UEV

Registers a settings location template with UE-V.

Syntax

Register-UevTemplate
        [-Path] <String[]>
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]
Register-UevTemplate
        -LiteralPath <String[]>
        [-WhatIf]
        [-Confirm]
        [<CommonParameters>]

Description

The Register-UevTemplate cmdlet registers a settings location template with Microsoft User Experience Virtualization (UE-V). A template defines settings to synchronize between computers. After you register a template, UE-V synchronizes the settings. If you try to register a template that is already registered, the cmdlet returns an error.

You must have administrative credentials to run this cmdlet.

Examples

Example 1: Register a template

PS C:\> Register-UevTemplate -Path "MicrosoftCalculator.xml"

This command registers a template in the current directory.

Example 2: Register multiple templates

PS C:\> Register-UevTemplate -Path "Microsoft*.xml"

This command uses a wildcard to specify multiple templates in the current directory.

Example 3: Register all templates in a directory

PS C:\> Register-UevTemplate -Path "*.xml"

This command uses a wildcard to register all settings location templates that are in the current directory but that are not currently registered.

Example 4: Register a template by using a literal path

PS C:\> Register-UevTemplate -LiteralPath "C:\Program Files\Microsoft User Experience Virtualization\Templates\MicrosoftCalculator.xml"

This command registers a settings location template by using the literal path of the template file.

Parameters

-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

-LiteralPath

Specifies an array of literal file paths. The cmdlet registers the settings location templates that have the literal paths that you specify.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Specifies an array of file paths. The cmdlet registers the settings location templates that have the paths that you specify. Use wildcards to specify multiple files.

Type:String[]
Aliases:Name
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[]

An array of paths to the settings location templates.