Set-CMProgram

참조

모듈:: ConfigurationManager

패키지 프로그램을 수정합니다.

구문

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -PackageName <String>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -PackageId <String>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -InputObject <IResultObject>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -InputObject <IResultObject>
   [-PassThru]
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 패키지 프로그램을 수정합니다. 프로그램은 클라이언트가 클라이언트 패키지를 받을 때 발생하는 작업을 식별합니다. 여러 프로그램을 동일한 패키지와 연결할 수 있습니다. 자세한 내용은 Configuration Manager의 패키지 및 프로그램을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 표준 프로그램 수정

Set-CMProgram -Name "Test" -StandardProgramName SPM -Comment "Standard Upgrades" -CommandLine "RunThisNow" -RunType Maximized -AfterRunningType ProgramControlsRestart -Category "Laptops" -DiskSpaceRequirement 50 -DiskSpaceUnit MB -Duration 150 -Requirement 4 -Reconnect $False -SuppressProgramNotifications $False -DisableProgram $True -EnableTaskSequence $True -DisableMomAlertOnRun $True -GenerateMomAlertOnFail $True

예제 2: 디바이스 프로그램 수정

Set-CMProgram -Name "Test" -DeviceProgramName DPM -Comment "Upgrades for December" -CommandLine "RunMe" -WorkingDirectory "\TempWork" -CommandLineFolder "C:\Windows" -DiskSpaceRequirement 30 -DiskSpaceUnit MB -DownloadProgramType AsSoonAsPossible -Requirement "All previous device updates"

예제 3: 지원되는 OS 플랫폼 추가

다음은 표준 패키지와 연결된 프로그램에 대한 OS 요구 사항을 설정하는 예제입니다. Get-CMSupportedPlatform cmdlet을 사용하여 지정된 플랫폼에 대한 개체를 가져옵니다. 그런 다음 지원되는 이 플랫폼 개체를 사용하여 프로그램을 구성합니다.

$ProgramName = 'Script'
$PackageID = 'XYZ0000D'
$Platform = 'All Windows 10 (64-bit) Client'
$OS = Get-CMSupportedPlatform -Name $Platform -Fast

Set-CMProgram -PackageID $PackageID -ProgramName $ProgramName -AddSupportedOperatingSystemPlatform $OS -StandardProgram

매개 변수

-AddSupportedOperatingSystemPlatform

프로그램에 추가할 하나 이상의 지원되는 OS 플랫폼을 지정합니다. 이 개체를 얻으려면 Get-CMSupportedPlatform cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	AddSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AfterRunningType

프로그램이 성공적으로 완료된 후 발생하는 작업을 지정합니다.

형식:	AfterRunningType
허용되는 값:	NoActionRequired, ConfigurationManagerRestartsComputer, ProgramControlsRestart, ConfigurationManagerLogsUserOff
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Category

프로그램이 클라이언트 컴퓨터에 표시되는 범주를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CommandLine

프로그램의 명령줄을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CommandLineFolder

실행 프로그램이 포함된 폴더를 지정합니다. 이 폴더는 클라이언트의 절대 경로이거나 패키지가 포함된 배포 폴더에 상대적인 경로일 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Comment

설명과 같이 프로그램에 대한 선택적 텍스트를 지정합니다. 클라이언트 컴퓨터에서 이 텍스트는 소프트웨어 센터의 프로그램과 함께 표시됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeviceProgram

이 매개 변수를 추가하여 이 프로그램을 디바이스 프로그램으로 구성합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableMomAlertOnRun

프로그램을 실행하는 컴퓨터가 프로그램 기간 동안 유지 관리 모드에 있는지 여부를 나타냅니다. 유지 관리 모드에서 System Center Operations Manager는 프로그램이 실행되는 동안 경고를 사용하지 않도록 설정합니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableProgram

이 프로그램을 포함하는 모든 배포를 일시적으로 사용하지 않도록 설정하려면 이 매개 변수 $true 를 로 설정합니다. Disable-CMProgram cmdlet을 사용할 수도 있습니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DiskSpaceRequirement

소프트웨어 프로그램이 컴퓨터에서 실행하는 데 필요한 디스크 공간의 양을 지정합니다. 값은 0보다 크거나 같아야 합니다. 값을 지정하는 경우 DiskSpaceUnit 매개 변수를 사용하여 값의 단위를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DiskSpaceUnit

DiskSpaceRequirement 매개 변수에 허용되는 단위를 지정합니다.

형식:	DiskSpaceUnitType
허용되는 값:	KB, MB, GB
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DownloadProgramType

프로그램을 실행할 시기를 지정합니다.

형식:	DownloadProgramType
허용되는 값:	AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DriveLetter

DriveMode 매개 변수를 사용하는 경우 위치에 대한 드라이브 문자를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DriveMode

프로그램에 DriveLetter 매개 변수에 지정된 특정 드라이브 문자가 필요한지 여부를 나타냅니다.

RunWithUnc: UNC 경로에서 프로그램을 실행합니다. 이 값은 기본값입니다. 버전 2010부터 이 값의 이름이 에서 바뀌었습니다 RenameWithUnc.
RequiresDriveLetter: 프로그램에서 사용 가능한 드라이브 문자를 사용합니다.
RequiresSpecificDriveLetter: 드라이브가 아직 사용되지 않는 경우에만 프로그램이 실행됩니다.

형식:	DriveModeType
허용되는 값:	RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Duration

프로그램이 실행되도록 예상하는 최대 시간을 지정합니다. 기본값은 120분입니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnableTaskSequence

패키지 설치 작업 순서 단계에서 이 프로그램을 설치할 수 있는지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-GenerateMomAlertOnFail

프로그램이 실패할 경우 Configuration Manager가 애플리케이션 로그 이벤트 항목을 생성하는지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InputObject

구성할 프로그램 개체를 지정합니다. 이 개체를 얻으려면 Get-CMProgram cmdlet을 사용합니다.

형식:	IResultObject
별칭:	ProgramPackage, Package, Program
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-PackageId

구성할 프로그램을 사용하여 패키지 ID를 지정합니다.

형식:	String
별칭:	Id
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PackageName

구성할 프로그램을 사용하여 패키지 이름을 지정합니다.

형식:	String
별칭:	Name
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProgramAssignedType

컴퓨터에서 프로그램을 한 번 실행할지 아니면 컴퓨터에 로그인하는 모든 사용자에 대해 한 번 실행할지 지정합니다. 기본값은 RunOnceForTheComputer입니다. ProgramRunType 매개 변수가 로 설정된 OnlyWhenUserIsLoggedOn경우에만 프로그램이 사용자에게 할당됩니다.

형식:	ProgramAssignedType
허용되는 값:	RunOnceForTheComputer, RunOnceForEveryUserWhoLogsOn
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProgramName

구성할 프로그램의 이름을 지정합니다.

형식:	String
별칭:	StandardProgramName, DeviceProgramName
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProgramRunType

프로그램을 실행하는 데 필요한 로그온 조건을 지정합니다. 기본값은 OnlyWhenUserIsLoggedOn입니다.

형식:	ProgramRunType
허용되는 값:	OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Reconnect

사용자가 로그인할 때 클라이언트 컴퓨터가 배포 지점에 다시 연결되는지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RemoveSupportedOperatingSystemPlatform

프로그램에 대해 제거할 지원되는 OS 플랫폼을 하나 이상 지정합니다. 이 개체를 얻으려면 Get-CMSupportedPlatform cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	RemoveSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Requirement

표준 또는 디바이스 프로그램에 대한 추가 요구 사항을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RunMode

클라이언트 컴퓨터에서 프로그램을 실행하는 데 필요한 자격 증명을 지정합니다.

형식:	RunModeType
허용되는 값:	RunWithUserRights, RunWithAdministrativeRights
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RunOnAnyPlatform

이 매개 변수를 추가하여 이 프로그램에서 지원되는 모든 OS 플랫폼을 지웁니다.

형식:	SwitchParameter
별칭:	ClearSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RunType

프로그램이 클라이언트 컴퓨터에서 실행되는 모드를 지정합니다. 기본값은 Normal입니다.

형식:	RunType
허용되는 값:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-StandardProgram

배포 패키지의 프로그램 유형이 표준 프로그램임을 나타냅니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SuppressProgramNotification

프로그램 알림을 표시하지 않도록 이 매개 변수 $true 를 로 설정합니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UserInteraction

사용자가 프로그램과 상호 작용할 수 있도록 허용할지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WorkingDirectory

프로그램의 작업 디렉터리를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object

다음을 통해 공유