Set-VDITemplate

Set-VDITemplate

Modifies properties of a RAS Template.

Set-VDITemplate [- Name ] <string> [[- SiteId ] <uint> ] [- Administrator <string> ] [- AdminPassword <SecureString> ] [- DelUnusedGuests <bool> ] [- Domain <string> ] [- DomainPassword <SecureString> ] [- Enable <bool> ] [- FolderId <string> ] [- FolderName <string> ] [- GuestNamePrefix <string> ] [- ImagePrepTool < VDIImagePrepTool > {RASPrep | SysPrep}] [- LicenseKeyType < VDILicenseType > {KMS | MAK}] [- MaxGuests <uint> ] [- NewName <string> ] [- Organization <string> ] [- OwnerName <string> ] [- PhysicalHostId <string> ] [- PhysicalHostName <string> ] [- PoolId <string> ] [- PoolName <string> ] [- PreCreatedGuests <uint> ] [- TargetOU <string> ] [- UnusedGuestsDuration <uint> ] [ < CommonParameters > ]

Set-VDITemplate [- Id ] <uint> [- Administrator <string> ] [- AdminPassword <SecureString> ] [- DelUnusedGuests <bool> ] [- Domain <string> ] [- DomainPassword <SecureString> ] [- Enable <bool> ] [- FolderId <string> ] [- FolderName <string> ] [- GuestNamePrefix <string> ] [- ImagePrepTool < VDIImagePrepTool > {RASPrep | SysPrep}] [- LicenseKeyType < VDILicenseType > {KMS | MAK}] [- MaxGuests <uint> ] [- NewName <string> ] [- Organization <string> ] [- OwnerName <string> ] [- PhysicalHostId <string> ] [- PhysicalHostName <string> ] [- PoolId <string> ] [- PoolName <string> ] [- PreCreatedGuests <uint> ] [- TargetOU <string> ] [- UnusedGuestsDuration <uint> ] [ < CommonParameters > ]

Set-VDITemplate [- InputObject ] < VDITemplate > [- Administrator <string> ] [- AdminPassword <SecureString> ] [- DelUnusedGuests <bool> ] [- Domain <string> ] [- DomainPassword <SecureString> ] [- Enable <bool> ] [- FolderId <string> ] [- FolderName <string> ] [- GuestNamePrefix <string> ] [- ImagePrepTool < VDIImagePrepTool > {RASPrep | SysPrep}] [- LicenseKeyType < VDILicenseType > {KMS | MAK}] [- MaxGuests <uint> ] [- NewName <string> ] [- Organization <string> ] [- OwnerName <string> ] [- PhysicalHostId <string> ] [- PhysicalHostName <string> ] [- PoolId <string> ] [- PoolName <string> ] [- PreCreatedGuests <uint> ] [- TargetOU <string> ] [- UnusedGuestsDuration <uint> ] [ < CommonParameters > ]

The Set-VDITemplate cmdlet is used to modify properties of a RAS Template.

When executing the cmdlet, you can include only the parameters that you want to modify.

- Name <string>
The name of the RAS Template to modify.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- SiteId <uint>
The site ID to which the RAS Template belongs.

        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Id <uint>
The ID of a RAS Template to modify.

        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false

- InputObject < VDITemplate >
An object of type VDITemplate representing a RAS Template.

The object is obtained using the Get-VDITemplate cmdlet.

        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false

- Enable <bool>
Enable or disable the specified RAS Template.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- New Name <string>
A new RAS Template name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- MaxGuests <uint>
The maximum number of guest VMs that can be created from the template.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- PreCreatedGuests <uint>
The maximum pre-created guest VMs that can be created.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- GuestNamePrefix <string>
The guest VM name prefix. All guest VMs created from the template will have this name with %ID% added at the end.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- DelUnusedGuests <bool>
Delete unused guest VMs.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- UnusedGuestsDuration <uint>
The duration after witch unused guest VMs should be deleted (in minutes).

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- ImagePrepTool < VDIImagePrepTool >
Image Preparation tool.

Possible values: RASPrep, SysPrep

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- LicenseKeyType < VDILicenseType >
License Key Type: KMS or MAK.

Possible values: KMS, MAK

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Owner Name <string>
The guest VM owner name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Organization <string>
The guest VM organization name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Domain <string>
The guest VM domain/workgroup name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- DomainPassword <SecureString>
The password of the domain specified in the -Domain parameter.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Administrator <string>
The guest VM administrator name.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- AdminPassword <SecureString>
The password of the administrator specified in the -Administrator parameter.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Folder Id <string>
The ID of a folder where guest VMs will be created.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Folder Name <string>
The name of a folder where guest VMs will be created.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Pool Id <string>
The ID of the native pool where guest VMs will be created.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- Pool Name <string>
The name of a native pool where guest VMs will be created.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- PhysicalHost Id <string>
The ID of a physical host where guest VMs will be created.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- PhysicalHost Name <string>
The name of a physical host where guest VMs will be created.

        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false

- TargetOU <string>
Target organization unit.

        Required?                    false

        Position?                    named

        Default value                

        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 documentation. 

PSAdmin.VDITemplate

---------- EXAMPLE 1 ----------

Set-VDITemplate "TemplateName" -Enable $False

Disables the specified RAS Template in the Licensing Server site.

To disable a RAS Template in a specific site, specify the -SiteId parameter.

---------- EXAMPLE 2 ----------

Set-VDITemplate -Id 1 -Enable $True

Enables a RAS Template specified by ID.

---------- EXAMPLE 3 ----------

Set-VDITemplate $VDITemplate -Enable $False

Disables a RAS Template specified by VDITemplate object (the $VDITemplate variable).

A VDITemplate object representing a RAS Template is obtained using the Get-VDITemplate cmdlet.

---------- EXAMPLE 4 ----------

Get-VDITemplate -Id 1 | Set-VDITemplate -Enable $False

Disables a RAS Template represented by an object obtained from the pipeline output.

---------- EXAMPLE 5 ----------

Get-VDITemplate -Id 1 | Set-VDITemplate -Description "My new RAS Template"

Modifies the description of the RAS Template obtained from the pipeline output.