버전 1902에 대한 Configuration Manager Cmdlet 라이브러리 변경 내용
적용 대상: Configuration Manager(현재 분기)
참고
Configuration Manager 현재 분기 버전 1810은 이러한 변경의 기준입니다. 자세한 내용은 버전 1810에 대한 cmdlet 라이브러리 변경 Configuration Manager 참조하세요.
중요한 변경 내용
새로운 cmdlet
Get-CMBoundaryGroupSiteSystem
이 cmdlet을 사용하여 지정된 경계 그룹에서 사이트 시스템을 가져옵니다.
Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID
Get-CMDistributionPointDriveInfo
이 cmdlet을 사용하여 배포 지점 드라이브 정보를 가져옵니다.
$dp = Get-CMDistributionPoint -SiteSystemServerName $ReferenceSiteSystemServerName
$dp | Get-CMDistributionPointDriveInfo
Invoke-CMAnalyzePackage
이 cmdlet을 사용하여 특정 패키지를 분석합니다.
Invoke-CMAnalyzePackage -PackageName $packageName
Invoke-CMConvertPackage
이 cmdlet을 사용하여 특정 패키지를 애플리케이션으로 변환합니다.
Invoke-CMConvertPackage -PackageName $packageName
New-CMScript
이 cmdlet을 사용하여 새 PowerShell 스크립트를 만듭니다. 매개 변수를 포함하지 않는 스크립트만 지원합니다.
New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'
New-CMScript -ScriptName "ImportScript" -ScriptFile \\abc\importedscript.ps1
Set-CMClientSettingDeliveryOptimization
이 cmdlet을 사용하여 배달 최적화 기능에 대한 클라이언트 설정을 지정합니다.
[Default] Set-CMClientSettingDeliveryOptimization -DefaultSetting -Enable $true
[Customized] Set-CMClientSettingDeliveryOptimization -Name $ReferenceClientDeviceSettingName -Enable $true
Set-CMClientSettingWindowsAnalytics
이 cmdlet을 사용하여 Windows Analytics 기능에 대한 클라이언트 설정을 지정합니다.
[Default] Set-CMClientSettingWindowsAnalytics -DefaultSetting -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
[Customized] Set-CMClientSettingWindowsAnalytics -Name $ReferenceClientDeviceSettingName -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
제거된 cmdlet
없음
사용되지 않는 cmdlet
없음
알려진 문제
다음 항목은 이 버전에서 확인되지 않는 Cmdlet 라이브러리의 알려진 문제입니다.
Get-CMAadConditionalAccessPolicy 및 Set-CMAadConditionalAccessPolicy
이러한 cmdlet에는 64비트 PowerShell 환경이 필요합니다.
해결 방법
- 없음
Import-CMSecurityRole
파일을 찾는 디렉터리NotFoundException 오류로 Cmdlet이 SecuredRoles.xsd
실패할 수 있습니다.
해결 방법
- 논리 경로 또는 모듈 이름이 아닌 파일에 대해
ConfigurationManager.psd1
를 호출Import-Module
합니다.
Set-CMSoftwareUpdatePoint
기본 SMS 공급자 개체가 변경되었더라도 Configuration Manager 콘솔에는 Schedule에 대한 변경 내용이 표시되지 않을 수 있습니다.
해결 방법
- Configuration Manager 콘솔을 종료하고 다시 시작합니다.
리소스 추적 및 복구(베타)
이 버전은 PowerShell 런타임에서 사용하는 SMS 공급자 개체 추적을 지원하고 더 이상 필요하지 않은 경우 이러한 리소스를 정리하기 위해 새 cmdlet을 추가합니다.
- Disconnect-CMTrackedObject
- Start-CMObjectTracking
- Stop-CMObjectTracking
를 실행 Start-CMObjectTracking
하면 PowerShell 런타임은 Cmdlet 라이브러리 cmdlet에서 만든 개체를 추적 IResultObject
합니다. 을 사용하여 수동으로 정리 .Dispose()
되지 않은 cmdlet의 경우 개별 개체에 대해 를 사용하여 Disconnect-CMTrackedObject
회수합니다.
예시
# Reclaim a single tracked object
$o | Disconnect-CMTrackedObject
# Reclaim all tracked objects
Disconnect-CMTrackedObject -All
개체가 회수되면 개체 파이프라인을 통해 더 이상 다시 사용하거나 다른 cmdlet에 전달할 수 없습니다.
Stop-CMObjectTracking
개체 추적을 해제하는 데 사용할 수 있습니다. 이전에 할당된 개체는 활성 상태로 유지됩니다.
청구되지 않은 리소스로 인해 SMS 공급자가 할당량 위반 오류를 발생시킬 수 있습니다. 이러한 할당량 문제는 일반적으로 대규모 SMS 공급자 개체 집합 또는 장기 실행 환경에서 작업할 때 발생합니다.
참고
이 기능은 실험적이며 향후 릴리스에서 변경 또는 제거될 수 있습니다. 옵트인이며 기본적으로 사용하도록 설정되지 않습니다.
Cmdlet 변경 내용
이 버전의 기존 cmdlet은 다음과 같이 변경되었습니다. 새로운 기능, 버그 수정 또는 사용 중단이 변경될 수 있습니다. 일부 변경 내용이 손상될 수 있습니다. 이 섹션에 나열된 cmdlet 또는 기능 영역 중 하나를 사용하는 경우 변경 내용을 주의 깊게 검토하여 사용에 미치는 영향을 이해합니다.
Add-CMDeviceAffinityToUser
수정된 버그
- Add/Remove-CMDeviceAffinityToUser -UserId/-UserName은 "-DeviceId/-DeviceName"을 함께 사용해야 합니다.
호환성이 손상되지 않는 변경 내용
- -DeviceID 및 -DeviceName에 대한 매개 변수 검사가 추가되었습니다. 사용자는 그 중 하나 이상을 지정해야 합니다.
Add-CMDeviceCollectionDirectMembershipRule
수정된 버그
- PowerShell에서 'Add-CMDeviceCollectionDirectMembershipRule' 명령을 사용하여 동일한 컬렉션에 동일한 리소스를 추가하면 "WARNING: " 라는 빈 경고가 표시되고 "지정된 이름의 개체가 이미 있습니다."라는 오류가 표시되지 않습니다.
호환성이 손상되지 않는 변경 내용
- 누락된 리소스가 추가되었습니다.
Add-CMDistributionPoint
호환성이 손상되지 않는 변경 내용
- DP에서 LEDBAT를 사용하거나 사용하지 않도록 설정하는 "-EnableLedbat" 매개 변수가 추가됨
Add-CMScriptDeploymentType
수정된 버그
- Add-CMScriptDeploymentType 기본적으로 UI와 일치하지 않음
호환성이 손상되지 않는 변경 내용
- UI에 맞게 초기화 코드를 수정했습니다(예상 설치 시간 = 0, 로그온 요구 사항=사용자가 로그온한 경우에만 해당).
Approve-CMApprovalRequest
호환성이 손상되지 않는 변경 내용
- 새 매개 변수 InstallActionBehavior(InstallNow, InstallNonBusinessHours의 두 가지 옵션이 있음)가 추가된 관리자는 애플리케이션이 승인된 후 즉시 설치할지 또는 업무 외 시간에 설치할지 여부를 지정할 수 있습니다. 선택적 매개 변수이며 기본적으로 "InstallNow"와 같습니다.
Get-CMDevice
수정된 버그
- Get-CMDevice SMSAssignedSites 속성이 없습니다. 1806년 이전에서 사용할 수 있었습니다.
호환성이 손상되지 않는 변경 내용
고객이 출력의 클래스를 지정할 수 있도록 두 개의 새 스위치 매개 변수가 추가되었습니다.
- -ReturnCollectionMember: sms 컬렉션 멤버 클래스의 반환 인스턴스를 강제로 적용합니다.
- -ReturnResource: SMS_Resource 클래스의 반환 인스턴스를 강제로 반환합니다.
ReturnCollectionMember/ReturnResource 없이 기본 매개 변수를 사용하는 경우 동작은 1802/1810과 동일합니다. 반환된 인스턴스는 지정된 매개 변수가 다른 다른 클래스에 있을 수 있습니다.
Get-CMPackage
수정된 버그
- Get-CMPackage -Fast 스위치가 필요합니다.
호환성이 손상되지 않는 변경 내용
- 빠른 쿼리를 지원하기 위해 -Fast 매개 변수가 추가되었습니다.
Import-CMDriver
수정된 버그
- Set-CMDriver -SupportedPlatformName이 배열에 대해 실패합니다.
호환성이 손상되지 않는 변경 내용
- SupportPlatformName 매개 변수에 대한 배열 값 문제가 해결되었습니다.
Invoke-CMScript
수정된 버그
- Invoke-CMScript cmdlet에는 가져올 수 없는 개체가 필요합니다.
호환성이 손상되지 않는 변경 내용
- 형식 유효성 검사를 수정했습니다.
New-CMActiveDirectoryForest
수정된 버그
- Active Directory 포리스트 만들기 - 사용자는 GUI를 통해 만든 경우에만 Powershell을 통해 작동하지 않습니다.
호환성이 손상되지 않는 변경 내용
- 사용자가 자격 증명을 설정한 후 계정을 전역 계정으로 가져왔습니다.
- 암호를 사용하여 자격 증명을 만들기 위한 새 매개 변수 -Password가 추가되었습니다.
New-CMApplication
수정된 버그
- 사용자는 New-CMApplication cmdlet을 사용하여 빈 Owner 또는 SupportContact 매개 변수를 지정할 수 없습니다.
호환성이 손상되지 않는 변경 내용
- 새 애플리케이션을 만들 때 Owner/SupportContact에 대한 $null 허용합니다. 기본값은 현재 사용자입니다.
- 배열 입력을 지원하기 위해 Owner/SupportContact에 대한 새 매개 변수가 추가되었습니다.
New-CMApplicationDeployment
호환성이 손상되지 않는 변경 내용
- 새 매개 변수 ReplaceToastNotificationWithDialog(부울)가 추가된 관리자는 클라이언트 컴퓨터에서 필요한 소프트웨어를 사용할 수 있게 되면 알림 메시지를 대화 상자로 바꿀지 여부를 지정할 수 있습니다. 선택적 매개 변수이며 기본적으로 false입니다.
New-CMCoManagementPolicy
호환성이 손상되지 않는 변경 내용
- 새 워크로드에 대한 지원이 추가되었습니다(DCWorkloadEnabled, O365WorkloadEnabled, ClientAppsWorkloadEnabled).
New-CMDetectionClauseWindowsInstaller
수정된 버그
- Add/Set-CMMsiDeploymentType -AddDetectionClause가 실패했습니다. "잘못된 식: 피연산자의 데이터 형식이 일치하지 않거나 연산자가 데이터 형식에 유효하지 않습니다."
호환성이 손상되지 않는 변경 내용
- 존재 스위치를 지정할 때 올바른지 확인하기 위해 데이터 형식 초기화의 논리를 수정했습니다.
New-CMOperatingSystemImageUpdateSchedule
호환성이 손상되지 않는 변경 내용
- UI에서 일정 마법사를 만들기 위해 수행된 변경 내용과 일치하도록 추가된 새 매개 변수:
- -RemoveSupersededUpdates
New-CMOperatingSystemUpgradeUpdateSchedule
호환성이 손상되지 않는 변경 내용
- UI에서 일정 마법사를 만들기 위해 수행된 변경 내용과 일치하도록 추가된 새 매개 변수:
- -RemoveSupersededUpdates
New-CMPackageDeployment
수정된 버그
- New-CMPackageDeployment 일관되지 않은 경고가 있습니다.
호환성이 손상되지 않는 변경 내용
- UI에 맞게 SlowNetwork 옵션의 기본 동작을 수정했습니다.
New-CMStatusFilterRule
수정된 버그
- New-CMStatusFilterRule 예상대로 작동하지 않습니다.
- 속성 "패키지 ID를 사용하여 새 상태 필터 규칙을 만들 수 없습니다.
호환성이 손상되지 않는 변경 내용
- -PropertyID를 지정하지 않고 대/소문자를 차단 해제하기 위해 속성 ID/값 검사에 대한 조건이 더 추가되었습니다.
- 원본이 '클라이언트'일 때 사용자 집합 속성 ID = '패키지 ID'를 허용하는 논리가 추가되었습니다.
New-CMTaskSequenceDeployment
수정된 버그
- 작업 순서 배포의 만료 시간을 설정할 수 없음
- New-CMTaskSequenceDeployment $result 이 cmdlet에서 개체를 가져올 수 없습니다.
호환성이 손상되지 않는 변경 내용
- 매개 변수 -DeadlineDateTime에 "DeploymentExpireDateTime" 별칭을 추가하여 Set- cmdlet에 맞춥니다.
- using 블록을 제거하면 배포 개체를 삭제하면 안 됩니다.
New-CMTaskSequenceMedia
호환성이 손상되지 않는 변경 내용
- 작업 순서 미디어 만들기 UI에 추가된 변경 내용과 일치하도록 추가된 새 매개 변수:
- -TemporaryFolder(별칭 "TemporaryDirectory", "StagingArea")
New-CMTSStepRunPowerShellScript
호환성이 손상되는 변경
- 추가된 매개 변수 집합: RunScriptFromSource, RunScriptFromPackage.
- 사용자가 새 매개 변수 SourceScript를 입력할 수 있으므로 PackageID 및 PackageName 매개 변수는 더 이상 필수가 아닙니다.
호환성이 손상되지 않는 변경 내용
- 작업 순서 편집기 UI에서 Power Shell 스크립트 실행 단계에 대한 변경 내용과 일치하도록 추가된 새 매개 변수:
- -SourceCode
- -WorkingDirectory
- -OutputVariableName
- -타임 아웃
- -사용자
- -암호
- -SuccessCodes
Remove-CMDeviceAffinityFromUser
수정된 버그
- Add/Remove-CMDeviceAffinityToUser -UserId/-UserName은 "-DeviceId/-DeviceName"을 함께 사용해야 합니다.
호환성이 손상되지 않는 변경 내용
- -DeviceID 및 -DeviceName에 대한 매개 변수 검사가 추가되었습니다. 사용자는 그 중 하나 이상을 지정해야 합니다.
Set-CMActiveDirectoryForest
수정된 버그
- Active Directory 포리스트 만들기 - 사용자는 GUI를 통해 만든 경우에만 Powershell을 통해 작동하지 않습니다.
호환성이 손상되지 않는 변경 내용
- 사용자가 자격 증명을 설정한 후 계정을 전역 계정으로 가져왔습니다.
- 암호를 사용하여 자격 증명을 만들기 위한 새 매개 변수 -Password가 추가되었습니다.
Set-CMApplicationDeployment
호환성이 손상되지 않는 변경 내용
- 새 매개 변수 ReplaceToastNotificationWithDialog(부울)가 추가된 관리자는 클라이언트 컴퓨터에서 필요한 소프트웨어를 사용할 수 있게 되면 알림 메시지를 대화 상자로 바꿀지 여부를 지정할 수 있습니다. 선택적 매개 변수이며 기본적으로 false입니다.
Set-CMClientSetting
호환성이 손상되지 않는 변경 내용
- 새 매개 변수 ReplaceToastNotificationWithDialog(부울)가 추가된 관리자는 컴퓨터를 다시 시작해야 할 때 알림 메시지를 대화 상자로 바꿀지 여부를 지정할 수 있습니다. 선택적 매개 변수이며 기본적으로 false입니다.
Set-CMClientSettingComputerRestart
호환성이 손상되지 않는 변경 내용
- 새 매개 변수 ReplaceToastNotificationWithDialog(부울)가 추가된 관리자는 컴퓨터를 다시 시작해야 할 때 알림 메시지를 대화 상자로 바꿀지 여부를 지정할 수 있습니다. 선택적 매개 변수이며 기본적으로 false입니다.
Set-CMComplianceRuleExistential
수정된 버그
- Set-CMComplianceRuleExistential -Rule은 규칙 값을 설정하는 데 작동하지 않습니다.
- Set-CMComplianceRuleExistential -ExpectedValue는 매개 변수 [-Existence Occurs]를 성공적으로 설정하지 않으면 음수로 설정할 수 없습니다.
호환성이 손상되지 않는 변경 내용
- 자식 cmdlet이 기본 매개 변수를 공용이 아닌 매개 변수로 재정의할 때 차단 오류를 방지하기 위해 Silent='true' 매개 변수를 사용하여 IsBoundParameterUsed를 호출하도록 WarnIgnoredParameter 함수를 수정했습니다.
- 예상 결과에 대한 유효성 검사를 공통 위치로 이동했습니다.
Set-CMDiscoveryMethod
수정된 버그
- Set-CMDiscoveryMethod 검색 계정을 구성하는 매개 변수가 없습니다.
호환성이 손상되지 않는 변경 내용
- AD 시스템/사용자 검색에 대한 ADContainer를 새로 추가하기 위한 검색 계정을 지정하는 새 매개 변수 -UserName이 추가되었습니다.
Set-CMDistributionPoint
호환성이 손상되지 않는 변경 내용
- DP에서 LEDBAT를 사용하거나 사용하지 않도록 설정하는 "-EnableLedbat" 매개 변수가 추가됨
Set-CMDriver
수정된 버그
- Set-CMDriver -SupportedPlatformName이 배열에 대해 실패합니다.
호환성이 손상되지 않는 변경 내용
- SupportPlatformName 매개 변수에 대한 배열 값 문제가 해결되었습니다.
- SupportedPlatform: -AddSupportedPlatformName에 대한 새 매개 변수가 추가되었습니다. -RemoveSupportedPlatformName; -ClearSupportedPlatform
사용 중단
- 사용되지 않는 매개 변수: -SupportedPlatformName
Set-CMManagementPoint
호환성이 손상되는 변경
- UI에 맞게 매개 변수 유효성 검사를 수정하고, 클라우드 게이트웨이를 사용하거나 사용하지 않도록 설정할 때 클라이언트 연결 형식을 다시 설정하는 코드가 추가되었습니다. 사용자가 SSL 없이 클라우드 게이트웨이(-EnableCloudGateway)를 사용하도록 차단하기 때문에 호환성이 손상되는 변경입니다.
수정된 버그
- -EnableCloudGateway를 Set-CMManagementPoint 처음에 MP를 HTTPS/EnableCloudGateway true로 설정한 다음, MP를 HTTP로 설정하면 EnableCloudGateway를 확인할 수 없습니다.
Set-CMStatusFilterRule
수정된 버그
- Set-CMStatusFilterRule 패키지 ID 설정과 함께 작동하지 않습니다.
호환성이 손상되지 않는 변경 내용
- 사용자가 원본을 다시 지정하지 않고 속성을 설정할 수 있도록 허용합니다. UI와 다른 점은 사용자가 -PropertyID 및 -PropertyValue를 함께 지정해야 한다는 것입니다.
- 개체가 없을 때 빈 경고 메시지를 방지하기 위한 코드가 추가되었습니다.
Set-CMTSStepRunPowerShellScript
호환성이 손상되지 않는 변경 내용
- 작업 순서 편집기 UI에서 Power Shell 스크립트 실행 단계에 대한 변경 내용과 일치하도록 추가된 새 매개 변수:
- -SourceCode
- -WorkingDirectory
- -OutputVariableName
- -타임 아웃
- -사용자
- -암호
- -SuccessCodes
Set-CMWindowsFirewallPolicy
수정된 버그
- Set/Remove-CMWindowsFirewallPolicy -InputObject는 New-CMWindowsFirewallPolicy에서 올바른 형식을 입력해야 합니다.
호환성이 손상되지 않는 변경 내용
- 형식 유효성 검사를 수정했습니다.