New-RASTemplate
NAME
New-RASTemplate
SYNOPSIS
Creates a Template property.
SYNTAX
New-RASTemplate [-ProviderId] <uint> [-VMId] <string> -Administrator <string> -AdminPassword <SecureString> -Domain <string> -DomainPassword <SecureString> -ObjType {RDSTemplate | VDITemplate | AVDTemplate} [-Address <string>] [-CloneMethod {FullClone | LinkedClone}] [-ComputerName <string>] [-DeviceName <string>] [-DomainOrgUnit <string>] [-FolderId <string>] [-FolderName <string>] [-HWGPU <bool>] [-ImagePrepTool {SysPrep | RASPrep}] [-InstanceType <string>] [-MaximumIOPS <ulong>] [-Name <string>] [-NativePoolId <string>] [-NativePoolName <string>] [-NoAllowRemoteConnections <SwitchParameter>] [-NoApplyParallelsPowerPlan <SwitchParameter>] [-NoFireWallRules <SwitchParameter>] [-NoRestart <SwitchParameter>] [-Organization <string>] [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}] [-OwnerName <string>] [-Password <SecureString>] [-PhysicalHostId <string>] [-PhysicalHostName <string>] [-ResourceGroup <string>] [-SiteId <uint>] [-Size <uint>] [-SubFolderName <string>] [-SubnetID <string>] [-SubnetMask <string>] [-SubnetName <string>] [-TemplateType {SingleSession | MultiSession}] [-Throughput <ulong>] [-Username <string>] [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>] [-VirtualNetworkName <string>] [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}] [<CommonParameters>] New-RASTemplate [-InputObject] <VM> -Administrator <string> -AdminPassword <SecureString> -Domain <string> -DomainPassword <SecureString> -ObjType {RDSTemplate | VDITemplate | AVDTemplate} [-Address <string>] [-CloneMethod {FullClone | LinkedClone}] [-ComputerName <string>] [-DeviceName <string>] [-DomainOrgUnit <string>] [-FolderId <string>] [-FolderName <string>] [-HWGPU <bool>] [-ImagePrepTool {SysPrep | RASPrep}] [-InstanceType <string>] [-MaximumIOPS <ulong>] [-Name <string>] [-NativePoolId <string>] [-NativePoolName <string>] [-NoAllowRemoteConnections <SwitchParameter>] [-NoApplyParallelsPowerPlan <SwitchParameter>] [-NoFireWallRules <SwitchParameter>] [-NoRestart <SwitchParameter>] [-Organization <string>] [-OSDiskType {StandardHDD | StandardSSD | PremiumSSD}] [-OwnerName <string>] [-Password <SecureString>] [-PhysicalHostId <string>] [-PhysicalHostName <string>] [-ResourceGroup <string>] [-SiteId <uint>] [-Size <uint>] [-SubFolderName <string>] [-SubnetID <string>] [-SubnetMask <string>] [-SubnetName <string>] [-TemplateType {SingleSession | MultiSession}] [-Throughput <ulong>] [-Username <string>] [-UseSeperateNetworkInterface <bool>] [-VirtualNetworkID <string>] [-VirtualNetworkName <string>] [-VMSize <string>] [-VolumeType {gp2 | gp3 | io1 | io2 | standard}] [<CommonParameters>]
DESCRIPTION
The cmdlet creates a Template property.
PARAMETERS
-ProviderId <uint> The ID of a Provider on which the source desktop VM resides.
Required? true Position? 0 Default value 0 Accept pipeline input? false Accept wildcard characters? false-VMId <string> The ID of the source VM.
Required? true Position? 1 Default value Accept pipeline input? false Accept wildcard characters? false-InputObject <VM> The desktop VM to be converted to a RAS Template. To obtain an object of type VDIDesktop representing the VM, use the Get-VM or Get-VDIDesktop cmdlet.
Required? true Position? 0 Default value Accept pipeline input? true (ByValue) Accept wildcard characters? false-ObjType <TemplateObjType> Template object type. Possible values: RDSTemplate, VDITemplate, AVDTemplate
Required? true Position? named Default value 0 Accept pipeline input? false Accept wildcard characters? false-Name <string> RAS Template name.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-SiteId <uint> The site ID in which to create the RAS Template info. If the parameter is omitted, the site ID of the Licensing Server will be used.
Required? false Position? named Default value 0 Accept pipeline input? false Accept wildcard characters? false-TemplateType <HostSessionType> Template type: Single Session (VDI / AVD (Experimental)) or Multi Session (RDS / AVD (default) (Experimental)) Possible values: SingleSession, MultiSession
Required? false Position? named Default value MultiSession Accept pipeline input? false Accept wildcard characters? false-CloneMethod <CloneMethod> Clone method: Full clone (default) or Linked clone. Possible values: FullClone, LinkedClone
Required? false Position? named Default value LinkedClone Accept pipeline input? false Accept wildcard characters? false-Username <string> An administrator account for push installing the RD Session Host agent on the server. If this parameter is omitted, your RAS admin username (and password) will be used.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-Password <SecureString> The password of the account specified in the Username parameter.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-NoRestart <SwitchParameter> Specifies not to restart the server after the RD Session Host agent is installed. If this parameter is omitted, the server will be restarted if required. This parameter applies only for RDSH Templates.
Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false-NoFireWallRules <SwitchParameter> Specifies not to add firewall rules to allow the RAS Guest Agent to communicate. If this parameter is omitted, the firewall rules will not be added.
Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false-NoAllowRemoteConnections <SwitchParameter> Specifies not to enable allow remote connection when the RAS Guest Agent is installed. If this parameter is omitted, remote connections are enabled.
Required? false Position? named Default value True Accept pipeline input? false Accept wildcard characters? false-NoApplyParallelsPowerPlan <SwitchParameter> Specifies not to apply Parallels power plan when the RAS Guest Agent is installed. If this parameter is omitted, the plan will be applied.
Required? false Position? named Default value True Accept pipeline input? false Accept wildcard characters? false-FolderName <string> Folder name where desktop VMs will be created.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-FolderId <string> The ID of a folder where desktop VMs will be created.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-SubFolderName <string> Subfolder name where desktop VMs will be created.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-NativePoolId <string> The ID of the native pool where desktop VMs will be created.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-NativePoolName <string> The name of the native pool where desktop VMs will be created.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-HWGPU <bool> Enable hardware acceleration graphics licensing support.
Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false-PhysicalHostId <string> The ID of a physical host where desktop VMs will be created.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-PhysicalHostName <string> The name of a physical host where desktop VMs will be created.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-UseSeperateNetworkInterface <bool> Use a separate network interface for LAN access.
Required? false Position? named Default value False Accept pipeline input? false Accept wildcard characters? false-Address <string> The address of the network interface.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-SubnetMask <string> The subnet mask of the network interface.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-InstanceType <string> Instance type.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-DeviceName <string> Device name.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-VolumeType <VolumeType> Volume type. Possible values: gp2, gp3, io1, io2, standard
Required? false Position? named Default value gp2 Accept pipeline input? false Accept wildcard characters? false-Size <uint> Size (GiB).
Required? false Position? named Default value 0 Accept pipeline input? false Accept wildcard characters? false-MaximumIOPS <ulong> Maximum IOPS.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-Throughput <ulong> Throughput (MB/s).
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-ResourceGroup <string> Resource group.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-VMSize <string> VM size.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-OSDiskType <DiskType> OS disk type. Possible values: StandardHDD, StandardSSD, PremiumSSD
Required? false Position? named Default value 0 Accept pipeline input? false Accept wildcard characters? false-VirtualNetworkID <string> Virtual network ID.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-VirtualNetworkName <string> Virtual network name.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-SubnetID <string> Subnet ID.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-SubnetName <string> Subnet name.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-ImagePrepTool <ImagePrepTool> Image preparation tool: RASPrep (default) or SysPrep. Possible values: SysPrep, RASPrep
Required? false Position? named Default value RASPrep Accept pipeline input? false Accept wildcard characters? false-ComputerName <string> The FQDN or IP address of the target VM.
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-OwnerName <string> A desktop VM owner name (assigned to a VM by RASprep or Sysprep).
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-Organization <string> Organization name (assigned to a VM by RASprep or Sysprep).
Required? false Position? named Default value Accept pipeline input? false Accept wildcard characters? false-Domain <string> Domain or WorkGroup to join (assigned to a VM by RASprep or Sysprep).
Required? true Position? named Default value Accept pipeline input? false Accept wildcard characters? false-DomainPassword <SecureString> The password of the domain administrator specified in the Administrator parameter.
Required? true Position? named Default value Accept pipeline input? false Accept wildcard characters? false-Administrator <string> The administrator of the domain specified in the JoinDomain parameter.
Required? true Position? named Default value Accept pipeline input? false Accept wildcard characters? false-AdminPassword <SecureString> The password of the administrator for the desktop VM (assigned to a VM by RASprep or Sysprep).
Required? true Position? named Default value Accept pipeline input? false Accept wildcard characters? false-DomainOrgUnit <string> Domain 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 .
INPUTS
OUTPUTS
EXAMPLES
---------- EXAMPLE 1 ---------- New-RASTemplate -ObjType VDITemplate -Name "My Template" Creates an VDI Template property with the specified name.
Last updated