Add-SCComputerTierTemplate

Adds a computer tier template to a service template.

Description

The Add-SCComputerTierTemplate cmdlet adds a computer tier template to a service template. A computer tier template contains a virtual machine template that is used to create a virtual machine.

For information about service templates, type: "Get-Help New-SCServiceTemplate -detailed". For more information about virtual machine templates, type: "Get-Help New-SCVMTemplate -detailed".

For more information about Add-SCComputerTierTemplate, type: "Get-Help Add-SCComputerTierTemplate -online".

Parameters

Name

Required? true
Accept Pipeline Input? false
Position? 0 
Specifies the name of a VMM object.

ServiceTemplate

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a service template object.

VMTemplate

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a VMM template object used to create virtual machines.

BlockAutomaticMigration

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the computer can be automatically migrated. When set to $True, automatic migration is blocked. When set to $False, automatic migration is allowed. Default value: $False.

DefaultInstanceCount

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the default instance count for a computer tier that can be scaled out. Default value: 1.

DeploymentOrder

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the order in which a computer tier or application host is deployed.

Description

Required? false
Accept Pipeline Input? false
Position? named 
States a description for the specified object.

InstanceMaximumCount

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum number of virtual machines to which a service instance can scale out.

InstanceMinimumCount

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum number of virtual machines to which a service instance can scale in.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

NumberOfUpgradeDomains

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the number of upgrade domains for a computer tier that can be scaled out. Default value: 1.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

ServicingOrder

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the order in which a computer tier or application host is serviced.

Tag

Required? false
Accept Pipeline Input? false
Position? named 
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.

Examples

1: Add a computer tier template to a service template. 
PS C:\> $WebTemplate = Get-SCVMTemplate | where { $_.Name -eq "WebTemplate01" }
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Add-SCComputerTierTemplate -ServiceTemplate $ServiceTemplate -VMTemplate $WebTemplate -Name "Web Tier" -DefaultInstanceCount 3 -InstanceMinimumCount 1 -InstanceMaximumCount 5 -DeploymentOrder 1 -ServicingOrder 1 -NumberOfUpgradeDomains 1

The first command gets the virtual machine template object named WebTemplate01 and stores the object in the $WebTemplate variable.

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

The last command adds a computer tier template to the service template stored in $ServiceTemplate.

See Also