Get-SCGuestOSProfile

Get-SCGuestOSProfile

Gets a guest operating system profile object from the VMM library.

Syntax

Parameter Set: Connection
Get-SCGuestOSProfile [[-Name] <String> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: SysprepScript
Get-SCGuestOSProfile [[-Name] <String> ] -AnswerFile <Script> [-OperatingSystem <OperatingSystem> ] [ <CommonParameters>]

Detailed Description

The Get-SCGuestOSProfile cmdlet gets one or more guest operating system profile objects from the VMM library.

Parameters

-AnswerFile<Script>

Specifies a script object stored in the VMM library to use as an answer file. The name of the answer file script depends on the operating system that you want to install on a virtual machine:

ANSWER FILE GUEST OS TO INSTALL ON VM

----------- -------------------------

Sysprep.inf Windows XP, Windows Server 2000, or Windows Server 2003

Unattend.xml Windows Vista, Windows 7, or Windows Server 2008

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?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OperatingSystem<OperatingSystem>

Specifies the type of operating system for a virtual machine. To list the names of all available operating systems in VMM, type: "Get-SCOperatingSystem".

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

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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.

  • GuestOSProfile

Examples

1: Get all guest operating system profiles from the library.

This command gets all guest OS profile objects from the library on VMMServer01 and displays information about these profiles to the user.

PS C:\> Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"

2: Get a specific guest operating system profile from the library.

This command gets the guest OS profile object named NewOSProfile01 and displays information about this profile to the user.

PS C:\> Get-GuestOSProfile -Name "NewOSProfile01"

New-SCGuestOSProfile

Remove-SCGuestOSProfile

Set-SCGuestOSProfile