Remove-SCServerFeature

Removes an operating system role or feature from a guest OS profile.

Description

The Remove-SCServerFeature deletes an operating system role or feature from a guest OS profile.

For more information about Remove-SCServerFeature, type: "Get-Help Remove-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.

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.

VMTemplate

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

Examples

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

The first command gets the gues OS profile 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 removes the server feature stored in $Feature from the guest OS profile stored in $OSProfile.

See Also