New-CMOrchestrationGroup
새 오케스트레이션 그룹을 만듭니다.
구문
New-CMOrchestrationGroup
[-Name] <String>
-SiteCode <String>
[-Description <String>]
-OrchestrationType <OrchestrationTypeValue>
[-OrchestrationValue <Int32>]
[-OrchestrationTimeOutMin <Int32>]
[-MaxLockTimeOutMin <Int32>]
[-PreScript <String>]
[-PreScriptTimeoutSec <Int32>]
[-PostScript <String>]
[-PostScriptTimeoutSec <Int32>]
-MemberResourceIds <Int32[]>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet을 사용하여 새 오케스트레이션 그룹을 만듭니다.
오케스트레이션 그룹을 사용하여 디바이스에 대한 소프트웨어 업데이트 배포를 더 잘 제어할 수 있습니다. 특정 워크로드에 대한 업데이트를 신중하게 관리하거나 그 사이에 동작을 자동화해야 할 수 있습니다. 자세한 내용은 Configuration Manager에서 오케스트레이션 그룹 만들기 및 사용을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예 1
이 예제 에서는 먼저 cmdlet 매개 변수를 매개 변수 변수에 배치합니다. 매개 변수를 스플랫할 필요는 없습니다. 이렇게 긴 명령줄에 대한 매개 변수를 더 쉽게 읽을 수 있습니다.
디바이스 변수의 오케스트레이션 그룹에 추가할 디바이스에 대한 개체가 있다고 가정합니다.
명령은 테스트 목적으로 기본 설정 및 간단한 스크립트를 사용하여 오케스트레이션 그룹을 만듭니다.
$parameters = @{
Name = "IT servers"
SiteCode = "XYZ"
Description = "An OG for IT servers with default settings"
OrchestrationType = "Number"
OrchestrationValue = 1
OrchestrationTimeOutMin = 720
MaxLockTimeOutMin = 60
PreScript = "Write-Host 'Pre-install script'"
PreScriptTimeoutSec = 120
PostScript = "Write-Host 'POST-install script'"
PostScriptTimeoutSec = 120
MemberResourceIds = $device1.ResourceID, $device2.ResourceID
}
New-CMOrchestrationGroup @parameters매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
오케스트레이션 그룹을 식별하는 데 도움이 되는 선택적 설명을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxLockTimeOutMin
오케스트레이션 그룹 멤버 시간 제한(분)에 대한 정수 값을 지정합니다. 이 값은 그룹의 단일 디바이스가 업데이트를 설치하는 데 걸리는 시간 제한입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MemberResourceIds
이 오케스트레이션 그룹의 멤버로 추가할 디바이스에 대한 리소스 ID 배열을 지정합니다. 리소스 ID는 정수입니다(예: 16777220). 디바이스 또는 리소스 개체의 ResourceId 속성입니다. 디바이스 개체를 얻으려면 Get-CMDevice 또는 Get-CMResource cmdlet을 사용합니다.
OrchestrationType 매개 변수를 Sequence로 설정하면 이 매개 변수를 사용하여 순서를 확인합니다.
| 형식: | Int32[] |
| 별칭: | MogMembers |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
오케스트레이션 그룹의 이름을 지정합니다.
| 형식: | String |
| 별칭: | OrchestrationGroupName |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OrchestrationTimeOutMin
오케스트레이션 그룹 시간 제한(분)에 대한 정수 값을 지정합니다. 이 값은 모든 그룹 구성원이 업데이트를 설치하는 데 걸리는 시간 제한입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OrchestrationType
오케스트레이션 그룹 유형에 대해 다음 값 중 하나를 지정합니다.
Number: 여러 디바이스가 동시에 업데이트되도록 허용합니다. 오케스트레이션 그룹의 전체 크기에 관계없이 항상 특정 수의 디바이스로 제한하려면 이 설정을 사용합니다. 디바이스 수를 지정하려면 OrchestrationValue 매개 변수를 사용합니다.Percentage: 디바이스의 백분율을 동시에 업데이트하도록 허용합니다. 나중에 오케스트레이션 그룹의 크기를 유연하게 사용할 수 있도록 하려면 이 설정을 사용합니다. 백분율을 지정하려면 OrchestrationValue 매개 변수를 사용합니다.Sequence: 디바이스가 소프트웨어 업데이트 배포를 실행하는 순서를 명시적으로 정의합니다. 순서는 MemberResourceIds 매개 변수의 디바이스 리소스 ID 종류에 따라 결정됩니다.
| 형식: | OrchestrationTypeValue |
| 허용되는 값: | Number, Percentage, Sequence |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OrchestrationValue
동시에 업데이트할 디바이스의 수 또는 백분율에 대한 정수를 지정합니다.
OrchestrationType 매개 변수를 또는 Percentage로 설정할 때 이 매개 변수를 Number 사용합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PostScript
배포가 실행되고 필요한 경우 디바이스를 다시 시작한 후 각 디바이스에서 실행할 PowerShell 스크립트를 지정합니다.
이 문자열 값은 스크립트 자체의 텍스트입니다. 사용하려는 파일에 스크립트가 있는 경우 먼저 변수로 읽습니다. 예를 들어 기본 제공 Get-Content cmdlet을 사용합니다.
스크립트는 성공을 위해 의 0 값을 반환해야 합니다. 0이 아닌 값은 스크립트 오류로 간주됩니다. 매개 변수가 있는 스크립트는 사용할 수 없습니다. 최대 스크립트 길이는 50,000자입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PostScriptTimeoutSec
사후 스크립트가 시간 초과되기 전에 실행될 수 있는 시간(초)에 대한 정수 값을 지정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PreScript
배포가 실행되기 전에 각 디바이스에서 실행할 PowerShell 스크립트를 지정합니다.
이 문자열 값은 스크립트 자체의 텍스트입니다. 사용하려는 파일에 스크립트가 있는 경우 먼저 변수로 읽습니다. 예를 들어 기본 제공 Get-Content cmdlet을 사용합니다.
스크립트는 성공을 위해 의 0 값을 반환해야 합니다. 0이 아닌 값은 스크립트 오류로 간주됩니다. 매개 변수가 있는 스크립트는 사용할 수 없습니다. 최대 스크립트 길이는 50,000자입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PreScriptTimeoutSec
사전 스크립트가 시간 초과되기 전에 실행될 수 있도록 허용되는 시간(초)에 대한 정수 값을 지정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SiteCode
이 오케스트레이션 그룹 및 해당 멤버에 대한 사이트 코드를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
IResultObject
참고
이 cmdlet은 SMS_MachineOrchestrationGroup WMI 클래스에 대한 개체를 반환합니다.