다음을 통해 공유

버전 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에서 올바른 형식을 입력해야 합니다.

호환성이 손상되지 않는 변경 내용

  • 형식 유효성 검사를 수정했습니다.