New-SCApplicationProfile
Creates an application profile.
Syntax
New-SCApplicationProfile
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-Owner <String>]
[-UserRole <UserRole>]
[-Tag <String>]
[-CompatibilityType <String>]
[-EnforceCompatibilityType]
[-ApplicationProfile <ApplicationProfile>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
The New-SCApplicationProfile cmdlet creates an application profile. Application profiles define the applications that are installed during virtual machine deployment and servicing.
Examples
Example 1: Create an application profile
PS C:\> $AppProfile = New-SCApplicationProfile -Name "SvcWebAppProfile01" -Owner "Contoso\Katarina"
PS C:\> $AppProfileThe first command creates an application profile object named SvcWebAppProfile01 and stores the object in the $AppProfile variable.
The second displays information about the application profile stored in $AppProfile to the user.
Example 2: Create an application profile by cloning an existing profile
PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $AppProfile02 = New-SCApplicationProfile -Name "SvcWebAppProfile02" -ApplicationProfile $AppProfileThe first command gets the application profile object named SvcWebAppProfile01 and stores the object in the $AppProfile variable.
The second command creates an application profile named SvcWebAppProfile02 by cloning the application profile stored in $AppProfile (SvcWebAppProfile01).
Parameters
-ApplicationProfile
Specifies an application profile object.
| Type: | ApplicationProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CompatibilityType
Specifies the deployment types with which an application profile is compatible. Valid values are:
- General
- SQLApplicationHost
- WebApplicationHost
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Specifies a description for the applicaton profile.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnforceCompatibilityType
Indicates that artifacts from an application profile that is not compatible with the value provided for the CompatibilityType parameter are removed.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Name
Specifies the name of a Virtual Machine Manager (VMM) object.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
Specifies the owner of a VMM object in the form of a valid domain user account.
- Example format:
-Owner "Contoso\PattiFuller" - Example format:
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Tag
Specifies a word or phrase to associate with an object so that you can search for all objects with the specified set of tags. You can search for a subset of tags, or you can search for the full set of tags.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
Specifies a user role object.
| Type: | UserRole |
| 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
ApplicationProfile
This cmdlet returns an ApplicationProfile object.