Add-SCServerFeature

Adds an operating system role or feature to a guest OS profile.

Description

The Add-SCServerFeature cmdlet adds an operating system role or feature to a guest OS profile. The role or feature is automatically installed during machine deployment and servicing operations.

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

Parameters

GuestOSProfile

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a guest operating system profile object.

ServerFeature

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a server feature object.

JobVariable

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

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.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

ServerFeature

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a server feature object.

VMTemplate

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

JobVariable

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

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.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

Examples

1: Add a server feature to a guest OS profile. 
PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> $Feature = Get-SCServerFeature -Name "Failover-Clustering"
PS C:\> Add-SCServerFeature -GuestOSProfile $OSProfile -ServerFeature $Feature

The first command gets the guest OS profile object named NewOSProfile01 and stores the object in the $OSProfile variable.

The second command gets the server feature object named Failover-Clustering and stores the object in the $Feature variable.

The last command adds the server feature stored in $Feature (Failover-Clustering) to the guest OS profile stored in $OSProfile (NewOSProfile01).

See Also