New-CMProgram
패키지에 대한 새 프로그램을 만듭니다.
Syntax
New-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
-CommandLine <String>
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
-PackageName <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RunMode <RunModeType>]
[-RunType <RunType>]
-StandardProgramName <String>
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]New-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
-CommandLine <String>
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
-PackageId <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RunMode <RunModeType>]
[-RunType <RunType>]
-StandardProgramName <String>
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]New-CMProgram
-CommandLine <String>
[-CommandLineFolder <String>]
[-Comment <String>]
-DeviceProgramName <String>
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-PackageName <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]New-CMProgram
-CommandLine <String>
[-CommandLineFolder <String>]
[-Comment <String>]
-DeviceProgramName <String>
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-PackageId <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
이 cmdlet을 사용하여 패키지에 대한 프로그램을 만듭니다. 프로그램은 Configuration Manager 패키지와 연결된 명령입니다. 클라이언트가 클라이언트 패키지를 받을 때 발생하는 작업을 식별합니다. 여러 프로그램을 동일한 패키지와 연결할 수 있습니다. 자세한 내용은 Configuration Manager 패키지 및 프로그램을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 프로그램 만들기
이 예제 에서는 먼저 cmdlet 매개 변수를 매개 변수 변수에 배치합니다. 매개 변수를 스플랫할 필요는 없습니다. 이렇게 긴 명령줄에 대한 매개 변수를 더 쉽게 읽을 수 있습니다.
이 명령은 기본 Windows용 사용자 상태 마이그레이션 도구 패키지에 x64 검사라는 프로그램을 만듭니다.
$parameters = @{
PackageName = "User State Migration Tool for Windows"
StandardProgramName = "Scan x64"
CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
RunType = "Normal"
ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
DiskSpaceRequirement = 200
DiskSpaceUnit = "MB"
Duration = 100
DriveMode = "RunWithUnc"
}
New-CMProgram @parameters매개 변수
-AddSupportedOperatingSystemPlatform
프로그램에 추가할 하나 이상의 지원되는 OS 플랫폼을 지정합니다. 이 개체를 얻으려면 Get-CMSupportedPlatform cmdlet을 사용합니다.
| Type: | IResultObject[] |
| Aliases: | AddSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandLine
프로그램의 명령줄을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandLineFolder
실행 프로그램이 포함된 폴더를 지정합니다. 이 폴더는 클라이언트의 절대 경로이거나 패키지가 포함된 배포 폴더에 상대적인 경로일 수 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Comment
설명과 같이 프로그램에 대한 선택적 텍스트를 지정합니다. 클라이언트 컴퓨터에서 이 텍스트는 소프트웨어 센터의 프로그램과 함께 표시됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceProgramName
디바이스 프로그램 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSpaceRequirement
소프트웨어 프로그램이 컴퓨터에서 실행하는 데 필요한 디스크 공간의 양을 지정합니다. 값은 0보다 크거나 같아야 합니다. 값을 지정하는 경우 DiskSpaceUnit 매개 변수를 사용하여 값의 단위를 지정합니다.
| Type: | String |
| Aliases: | DiskSpaceReq |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSpaceUnit
DiskSpaceRequirement 매개 변수에 허용되는 단위를 지정합니다.
| Type: | DiskSpaceUnitType |
| Accepted values: | KB, MB, GB |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DownloadProgramType
프로그램을 실행할 시기를 지정합니다.
| Type: | DownloadProgramType |
| Accepted values: | AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriveLetter
DriveMode 매개 변수를 사용하는 경우 위치에 대한 드라이브 문자를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriveMode
프로그램에 DriveLetter 매개 변수에 지정된 특정 드라이브 문자가 필요한지 여부를 나타냅니다.
RunWithUnc: UNC 경로에서 프로그램을 실행합니다. 이 값은 기본값입니다. 버전 2010부터 이 값의 이름이 에서 바뀌었습니다RenameWithUnc.RequiresDriveLetter: 프로그램에서 사용 가능한 드라이브 문자를 사용합니다.RequiresSpecificDriveLetter: 드라이브가 아직 사용되지 않는 경우에만 프로그램이 실행됩니다.
| Type: | DriveModeType |
| Accepted values: | RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Duration
프로그램이 실행되도록 예상하는 최대 시간을 지정합니다. 기본값은 120분입니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
이 프로그램의 패키지 ID를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
이 프로그램의 패키지 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProgramRunType
프로그램을 실행하는 데 필요한 로그온 조건을 지정합니다.
기본 설정은 입니다 OnlyWhenUserIsLoggedOn.
| Type: | ProgramRunType |
| Accepted values: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reconnect
사용자가 Windows에 로그인할 때 클라이언트 컴퓨터가 배포 지점에 다시 연결되는지 여부를 나타냅니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Requirement
표준 또는 디바이스 프로그램에 대한 추가 요구 사항을 지정합니다.
| Type: | String |
| Aliases: | Requirements |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunMode
프로그램이 클라이언트 컴퓨터에서 실행하는 데 필요한 자격 증명을 지정합니다.
| Type: | RunModeType |
| Accepted values: | RunWithUserRights, RunWithAdministrativeRights |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunType
프로그램이 클라이언트 컴퓨터에서 실행되는 모드를 지정합니다.
기본값은 Normal입니다.
| Type: | RunType |
| Accepted values: | Normal, Minimized, Maximized, Hidden |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandardProgramName
표준 프로그램 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserInteraction
사용자가 프로그램과 상호 작용할 수 있도록 허용할지 여부를 나타냅니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
프로그램의 작업 디렉터리를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
None
출력
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Program 서버 WMI 클래스를 참조하세요.
관련 링크
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기