Set-SCISOConfiguration

Updates an ISO configuration within a virtual machine configuration.

Description

The Set-SCISOConfiguration cmdlet updates an ISO configuration within a virtual machine configuration prior to a service deployment.

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

Parameters

ISOConfiguration

Required? true
Accept Pipeline Input? true (ByValue)
Position? named
Specifies an ISO configuration object.

ISOInstance

Required? false
Accept Pipeline Input? false
Position? named
Specifies an instance of an ISO 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. 

PinSourceISO

Required? false
Accept Pipeline Input? false
Position? named
Indicates whether the source ISO chosen by the user is retained during service deployment configuration.

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. 

UseISORemotely

Required? false
Accept Pipeline Input? false
Position? named
Indicates whether the ISO is stored in a remote location.

Examples

1. Set the properties of the ISO configuration for a virtual machine configuration.
PS C:\> $ISO = Get-SCISO -Name "TestISO2.iso"
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $ISOConfig = Get-SCISOConfiguration -VMConfiguration $VMConfig
PS C:\> Set-SCISOConfiguration -ISOConfiguration $ISOConfig -ISOInstance $ISO -PinSourceISO $True
The first command gets the service configuration object named Service01 and stores the object in the $ServiceConfig variable.

The second command gets the computer tier configuration object for the service configuration stored in $ServiceConfig and stores the object in the $TierConfig variable.

The third command gets the virtual machine configuration for the computer tier configuration stored in $TierConfig and stores the object in the $VMConfig variable.

The fourth command gets the ISO configuration for the virtual machine configuration stored in $VMConfig and stores the object in the $ISOConfig variable.

The last command updates the source ISO for the ISO configuration stored in $ISOConfig and pins the source ISO so that it does not change during service deployment configuration.

See Also