Set-SCISOConfiguration

Set-SCISOConfiguration

Updates an ISO configuration within a virtual machine configuration.

Syntax

Parameter Set: Default
Set-SCISOConfiguration -ISOConfiguration <ISOConfiguration> [-ISOInstance <ISO> ] [-JobVariable <String> ] [-PinSourceISO <Boolean> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-UseISORemotely <Boolean> ] [ <CommonParameters>]

Detailed Description

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

Parameters

-ISOConfiguration<ISOConfiguration>

Specifies an ISO configuration object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-ISOInstance<ISO>

Specifies an instance of an ISO object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PinSourceISO<Boolean>

Indicates whether the source ISO chosen by the user is retained during service deployment configuration.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UseISORemotely<Boolean>

Indicates whether the ISO is stored in a remote location.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

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.

  • ISOConfiguration

Examples

Example Example 1:. Set the properties of the ISO configuration for a virtual machine configuration.:

The first command gets the service configuration object named Service01, and then stores the object in the $ServiceConfig variable.

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

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

The fourth command gets the ISO configuration for the virtual machine configuration stored in $VMConfig, and then 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.

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

Get-SCISOConfiguration

Get-SCISO

Get-SCServiceConfiguration

Get-SCComputerTierConfiguration

Get-SCVMConfiguration