Get-SCServerFeature

Applies To: System Center 2012 - Virtual Machine Manager

Get-SCServerFeature

Gets the operating system roles and features that have been added to a guest OS profile.

Syntax

Parameter Set: AllParamSet
Get-SCServerFeature [-Name <String> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: IDParamSet
Get-SCServerFeature -ID <Guid> [-Name <String> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: OSProfileParamSet
Get-SCServerFeature -GuestOSProfile <GuestOSProfile> [-Name <String> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: TemplateParamSet
Get-SCServerFeature -VMTemplate <Template> [-Name <String> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The Get-SCServerFeature cmdlet gets the operating system roles and features that have been added to a guest OS profile.

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

Parameters

-GuestOSProfile<GuestOSProfile>

Specifies a guest operating system profile object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-ID<Guid>

Specifies the numerical identifier (as a globally unique identifier, or GUID) for a specific object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a VMM object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-VMTemplate<Template>

Specifies a VMM template object used to create virtual machines.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • ServerFeature

Examples

1: Get all operating system features than have been added to a guest OS profile.

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

The second command gets all of the server feature objects that have been added to the guest OS profile stored in $OSProfile and stores the objects in the $ServerFeature array.

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> $ServerFeature = Get-SCServerFeature -GuestOSProfile $OSProfile

Add-SCServerFeature

Get-SCGuestOSProfile

Remove-SCServerFeature