Set-CMOperatingSystemInstaller

Changes configuration settings of operating system installers.

Syntax

Set-CMOperatingSystemInstaller
   [-Confirm]
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisableWildcardHandling]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-ForceWildcardHandling]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-CMOperatingSystemInstaller [-Confirm] [-CopyToPackageShareOnDistributionPoint ]
 [-CustomPackageShareName ] [-Description ] [-DisableWildcardHandling]
 [-DisconnectUserFromDistributionPoint ] [-DisconnectUserFromDistributionPointMins ]
 [-DisconnectUserFromDistributionPointRetryCount ] [-DistributionPointUpdateSchedule ]
 [-EnableBinaryDeltaReplication ] [-ForceWildcardHandling] -InputObject 
 [-MulticastAllow ] [-MulticastEncrypt ] [-MulticastTransferOnly ]
 [-NewName ] [-PassThru] [-Path ] [-PersistContentInCache ]
 [-PrestageBehavior ] [-Priority ] [-SendToPreferredDistributionPoint ]
 [-Version ] [-WhatIf] []
Set-CMOperatingSystemInstaller [-Confirm] [-CopyToPackageShareOnDistributionPoint ]
 [-CustomPackageShareName ] [-Description ] [-DisableWildcardHandling]
 [-DisconnectUserFromDistributionPoint ] [-DisconnectUserFromDistributionPointMins ]
 [-DisconnectUserFromDistributionPointRetryCount ] [-DistributionPointUpdateSchedule ]
 [-EnableBinaryDeltaReplication ] [-ForceWildcardHandling] [-MulticastAllow ]
 [-MulticastEncrypt ] [-MulticastTransferOnly ] -Name  [-NewName ]
 [-PassThru] [-Path ] [-PersistContentInCache ] [-PrestageBehavior ]
 [-Priority ] [-SendToPreferredDistributionPoint ] [-Version ] [-WhatIf]
 []

Description

The Set-CMOperatingSystemInstaller cmdlet changes configuration settings of one or more operating system installers in Microsoft System Center Configuration Manager. An operating system installer is an installation package that contains all the files that System Center Configuration Manager needs to install a Windows operating system on a reference computer.

Examples

Example 1: Change settings for an operating system installer by using a name

PS C:\> Set-CMOperatingSystemInstaller -Name "Win8x64" -NewName "OsiWin8x64" -Version "I20B" -Description "Dept02 Sys Install" -Path "\\Win2k3X64contoso\Public\OSD\win8x64"

This command changes configuration settings of the operating system installer named Win8x64. The command renames the operating system installer, adds a version and description, and specifies the path to the installation source files of the operating system installer.

Example 2: Add an operating system installer to a security scope by using a name

PS C:\> Set-CMOperatingSystemInstaller -SecurityScopeAction AddMembership -SecurityScopeName "SecScope02" -Name "InstPkg01"

This command adds membership to the security scope named SecScope02 for the operating system installer named InstPkg01.

Example 3: Remove an operating system installer from a security scope

PS C:\> Set-CMOperatingSystemInstaller -SecurityScopeAction RemoveMembership -SecurityScopeName "SecScope02" -Name "InstPkg01"

This command removes membership to the security scope named SecScope02 for the operating system installer named InstPkg01.

Required Parameters

-Id

Specifies an array of IDs of operating system installers.

Type:String
Aliases:PackageId
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Specifies a CMOperatingSystemInstaller object. To obtain a CMOperatingSystemInstaller object, use the Get-CMOperatingSystemInstaller cmdlet.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies the name of an operating system installer.

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

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CopyToPackageShareOnDistributionPoint
Type:Boolean
Aliases:CopyToPackageShareOnDistributionPoints
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CustomPackageShareName
Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for the operating system installer.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPoint
Type:Boolean
Aliases:DisconnectUsersFromDistributionPoints
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointMins
Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsMinutes
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointRetryCount
Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsRetries
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointUpdateSchedule
Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableBinaryDeltaReplication
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MulticastAllow
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MulticastEncrypt
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MulticastTransferOnly
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

Specifies the new name of an operating system installer.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Path

Specifies the network path to the installation source files of an operating system installer.

Type:String
Aliases:PackageSourcePath
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PersistContentInCache
Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestageBehavior
Type:PrestageBehavior
Parameter Sets:ManualCopy, DownloadDelta, OnDemand
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Priority

Specifies a change for the priority of the deployment type. Valid values are: Increase and Decrease.

Type:Priority
Parameter Sets:High, Medium, Low
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendToPreferredDistributionPoint
Type:Boolean
Aliases:SendToPreferredDistributionPoints
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Version

Specifies the version of an operating system installer.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False