Set-SCComputerTierTemplate

Modifies the properties of a computer tier template.

Syntax

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

Description

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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ComputerTierTemplate

Specifies a computer tier template object.

Type:ComputerTierTemplate
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

States a description for the specified object.

Type:String
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

Type:String
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ServicingOrder

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

Type:Int32
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMTemplate

Specifies a VMM template object used to create virtual machines.

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

Outputs

ComputerTierTemplate

This cmdlet returns a **ComputerTierTemplate** object.