Share via

Add-SCOperatingSystem

  • Reference
Module:
VirtualMachineManager

Adds an operating system to an application profile to specify which operating systems the application profile is compatible with.

Syntax

Add-SCOperatingSystem
   [-VMMServer <ServerConnection>]
   -ApplicationProfile <ApplicationProfile>
   -OperatingSystem <OperatingSystem>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

The Add-SCOperatingSystem cmdlet adds an operating system to an application profile object. Setting the operating system for an application profile determines which operating systems the profile is compatibile with. If no operating system is set, by default the profile is compatible with all operating systems.

Examples

Example 1: Add an operating system to an application profile

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> Add-SCOperatingSystem -ApplicationProfile $AppProfile -OperatingSystem $OS

The first command gets the application profile object named SvcWebAppProfile01 and stores the object in the $AppProfile variable.

The second command gets the operating system object named 64-bit edition of Windows Server 2008 R2 Enterprise from VMMServer01 and stores the object in the $OS variable.

The last command adds the operating system stores in $OS to the application profile stored in $AppProfile.

Parameters

-ApplicationProfile

Specifies an application profile object.

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

-OperatingSystem

Specifies the type of operating system for a virtual machine. To list the names of all available operating systems in Virtual Machine Manager (VMM), type Get-SCOperatingSystem.

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

-VMMServer

Specifies a VMM server object.

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

Outputs

OperatingSystem

This cmdlet returns an OperatingSystem object.