Share via

Set-SCComputerTierTemplate

  • Reference
Module:
VirtualMachineManager

Modifies the properties of a computer tier template.

Syntax

Set-SCComputerTierTemplate
   [-Name <String>]
   [-Description <String>]
   [-InstanceMaximumCount <Int32>]
   [-InstanceMinimumCount <Int32>]
   [-DefaultInstanceCount <Int32>]
   [-DeploymentOrder <Int32>]
   [-Tag <String>]
   [-ServicingOrder <Int32>]
   [-NumberOfUpgradeDomains <Int32>]
   [-BlockAutomaticMigration \<Boolean\>]
   [-EnableAvailabilitySet \<Boolean\>]
   -ComputerTierTemplate <ComputerTierTemplate>
   [-VMTemplate <Template>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Note

A new parameter [-EnableNestedVirtualization] <Boolean> is included in VMM 2019 UR1 and later. For more information, see Parameters.

The Set-SCComputerTierTemplate cmdlet modifies the properties of a computer tier template.

Examples

Example 1: Set the properties of a computer tier template

PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $TierTemplate = Get-SCComputerTierTemplate -ServiceTemplate $ServiceTemplate
PS C:\> Set-SCComputerTierTemplate -ComputerTierTemplate $TierTemplate -DefaultInstanceCount 2 -InstanceMinimumCount 1

The first command gets the service template object named ServiceTemplate01 and stores the object in the $ServiceTemplate variable.

The second command gets the computer tier template object for the service template stored in $ServiceTemplate.

The last command sets properties for the computer template tier object stored in $TierTemplate.

Parameters

-BlockAutomaticMigration

Indicates whether the computer can be automatically migrated. When set to $True, automatic migration is blocked. When set to $False, automatic migration is allowed. The default value is $False.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerTierTemplate

Specifies a computer tier template object.

Type:ComputerTierTemplate
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultInstanceCount

Specifies the default instance count for a computer tier that can be scaled out. The default value is 1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentOrder

Specifies the order in which a computer tier, application host, or application is deployed.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

States a description for the specified object.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableAvailabilitySet

Indicates whether an availability set is generated on a service tier when a service is deployed.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableNestedVirtualization

Enables the nested virtualization.

Note

This parameter is applicable for VMM 2019 UR1 and later.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceMaximumCount

Specifies the maximum number of virtual machines to which a service instance can scale out.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceMinimumCount

Specifies the minimum number of virtual machines to which a service instance can scale in.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Specifies that job progress is tracked and stored in the variable named by this parameter.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a Virtual Machine Manager (VMM) object.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NumberOfUpgradeDomains

Specifies the number of upgrade domains for a computer tier that can be scaled out. The default value is 1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicingOrder

Specifies the order in which a computer tier or application host is serviced.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Specifies a word or phrase to associate with an object so that you can search for all objects with the specified set of tags. You can search for a subset of tags, or you can search for the full set of tags.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMTemplate

Specifies a VMM template object used to create virtual machines.

Type:Template
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

ComputerTierTemplate

This cmdlet returns a ComputerTierTemplate object.