Invoke-CMScript
Configuration Manager PowerShell 스크립트를 실행합니다.
Syntax
Invoke-CMScript
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Device <IResultObject[]>]
-InputObject <IResultObject>
[-PassThru]
[-ScriptParameter <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-CMScript
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Device <IResultObject[]>]
[-PassThru]
-ScriptGuid <String>
[-ScriptParameter <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 Configuration Manager PowerShell 스크립트를 실행합니다. 이러한 스크립트는 Configuration Manager 통합 및 관리됩니다.
스크립트가 승인될 때까지 스크립트를 실행할 수 없습니다. 프로그래밍 방식으로 스크립트를 승인하려면 Approve-CMScript cmdlet을 사용합니다.
자세한 내용은 Configuration Manager 콘솔에서 PowerShell 스크립트 만들기 및 실행을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예제 1: ID를 사용하여 스크립트 실행
이 명령은 ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80
를 사용하여 스크립트를 실행합니다.
Invoke-CMScript -ScriptGuid "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
예제 2: 개체 변수를 사용하여 스크립트 실행
첫 번째 명령은 ID로 스크립트 개체를 가져오고 $ScriptObj 변수에 저장합니다. 두 번째 명령은 해당 변수에 저장된 스크립트를 실행합니다.
$ScriptObj = Get-CMScript -Id "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Invoke-CMScript -InputObject $ScriptObj
예제 3: 대상 스크립트에 매개 변수 전달
첫 번째 줄은 해시 테이블의 매개 변수를 저장합니다. 두 번째 줄은 대상 디바이스에서 스크립트를 실행하여 해시 테이블의 매개 변수를 전달합니다.
$parameters = @{
"FolderName"="c:\test\test1"
"FileName"="test2"
}
Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $parameters
매개 변수
-Collection
이 스크립트를 실행할 컬렉션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection cmdlet을 사용합니다.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
이 스크립트를 실행할 컬렉션의 ID를 지정합니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
이 스크립트를 실행할 컬렉션의 이름을 지정합니다.
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: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Device
이 스크립트를 실행할 디바이스의 개체를 지정합니다. 이 개체를 얻으려면 Get-CMDevice cmdlet을 사용합니다.
Type: | IResultObject[] |
Aliases: | Devices |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
실행할 스크립트 개체를 지정합니다. 이 개체를 얻으려면 Get-CMScript cmdlet을 사용합니다.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleTime
UTC DateTime을 지정하여 나중에 스크립트 실행을 예약합니다.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptGuid
실행할 스크립트의 ID를 지정합니다. 형식은 표준 GUID입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptParameter
버전 2010 이상에 적용됩니다. 이 매개 변수를 사용하여 대상 스크립트에 매개 변수를 전달합니다. 필수 매개 변수를 사용하여 해시 테이블을 지정합니다. 사용 예제는 예제를 참조하세요.
Type: | Hashtable |
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: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object
관련 링크
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기