System Center Configuration Manager Cmdlet 라이브러리는 현재 분기 1710에 대 한 변경System Center Configuration Manager Cmdlet Library changes for Current Branch 1710


System Center Configuration 현재 1706 분기에 이러한 변경에 대 한 기준선입니다.System Center Configuration Current Branch 1706 is the baseline for these changes. 참조 System Center Configuration Manager Cmdlet 라이브러리는 현재 분기 1706에 대 한 변경 대 한 자세한 내용은 합니다.See System Center Configuration Manager Cmdlet Library changes for Current Branch 1706 for more details.

중요 한 변경 내용Important changes

설명서 라이브러리 업데이트Documentation library updates

최신 Cmdlet 라이브러리 설명서에서 제공 됩니다.합니다.Up-to-date Cmdlet Library documentation is now available from

제거 cmdletRemoved cmdlets

다음 cmdlet은 더 이상 지원 되지 및 제거 되었습니다.The following cmdlets are no longer supported and have been removed:

  • Invoke-CMAmtProvisioningDiscoveryInvoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccountNew-CMAmtProvisioningAccount
  • Set-CMPowerControlSet-CMPowerControl

사용 되지 않는 cmdletDeprecated cmdlets

  • Invoke-CMEndpointProtectionScanSave-CMEndpointProtectionDefinition 요소로 대체 Invoke-CMClientAction합니다.Invoke-CMEndpointProtectionScan and Save-CMEndpointProtectionDefinition have been superseded by Invoke-CMClientAction.

PSDrive 자동 생성을 사용 하지 않도록 설정Disable PSDrive auto-creation

ConfigurationManager.psd1 모듈 로드 되 면 Configuration Manager 콘솔을 사용 하 여 액세스 된의 마지막 SMS 공급자에 대 한 연결을 만들려면 PowerShell 자동으로 시도 합니다.When the ConfigurationManager.psd1 module is loaded, PowerShell automatically attempts to create a connection to the last SMS Provider that was accessed using the Configuration Manager console. 일부 시나리오에서이 동작은 바람직하지 않을 수도 있습니다.In some scenarios, this behavior may not be desirable. 이 동작을 사용 하지 않도록 설정 및 수동 드라이브를 만들어야 할 수 있는 사용자별 레지스트리 키가 추가 되었습니다.A per-user registry key has been added that can disable this behavior and require manual drive creation. 이 구성 하려면 레지스트리 키를 사용 합니다. HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell 값을 설정 하 고 DisableCMDriveAutoCreate 1의 dword (자동 생성 드라이브 사용 안 함) 또는 0 (기본 동작).To configure this, use the registry key: HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell and set the value DisableCMDriveAutoCreate to a DWORD of 1 (drive auto-creation is disabled) or 0 (default behavior). 삭제 DisableCMDriveAutoCreate 도 기본 동작을 사용 하도록 설정 합니다.Deleting DisableCMDriveAutoCreate also enables default behavior.


드라이브 자동 만들기가 비활성화 되 면 PowerShell 창을 시작 하는 경우 Configuration Manager 콘솔 오류를 보고할 수 있습니다.When drive auto-creation is disabled, the Configuration Manager console may report an error when launching a PowerShell window.

의견이 나 보고서 문제를 제공 하는 방법How to provide feedback or report issues

수정 및이 문서에서 설명 하는 향상 된 기능 대부분은 고객 피드백의 결과입니다.Many of the fixes and improvements described in this document are a result of customer feedback. 사용자 의견 및 버그 보고서를 그대로 사용 하 여 Microsoft Connect (Microsoft 계정 필요) 또는 UserVoice합니다.To leave feedback and bug reports, use Microsoft Connect (a Microsoft Account is required) or UserVoice.

알려진 문제Known issues

이러한 Cmdlet 라이브러리는이 릴리스에서 해결 되지 않은 문제 알려져 있습니다.These are known issues with the Cmdlet Library that are not resolved in this release.

Get-CMAadConditionalAccessPolicy 및 집합 CMAadConditionalAccessPolicyGet-CMAadConditionalAccessPolicy and Set-CMAadConditionalAccessPolicy

64 비트 PowerShell 환경 이러한 cmdlet에 필요 합니다.64-bit PowerShell environment is required for these cmdlets.

해결 방법Workaround

  • 없음None


Cmdlet은 파일을 찾는 DirectoryNotFoundException 오류로 실패할 수 있습니다 SecuredRoles.xsd합니다.Cmdlet may fail with a DirectoryNotFoundException error locating the file SecuredRoles.xsd.

해결 방법Workaround

했는지 Import-Module 에 대해 호출 되는 ConfigurationManager.psd1 파일과 논리 경로 또는 모듈 이름이 아니라 합니다.Ensure that Import-Module is called against the ConfigurationManager.psd1 file, and not the logical path or module name.


Cmdlet은 WqlQueryException 오류로 실패할 수 있습니다.Cmdlet may fail with a WqlQueryException error.

해결 방법Workaround

  • Invoke CMWmiQuery SMS_CM_UpdatePackTopLevelMonitoring 클래스를 직접 쿼리를 사용 합니다.Use Invoke-CMWmiQuery to directly query the SMS_CM_UpdatePackTopLevelMonitoring class.
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"


변경 내용 일정 기본 SMS 공급자 개체가 변경 되었는지도 Configuration Manager 콘솔에 반영 되지 않을 수 있습니다.Changes to Schedule may not be reflected in the Configuration Manager console even though the underlying SMS Provider object has been changed.

해결 방법Workaround

종료 되 고 Configuration Manager 콘솔을 다시 시작 합니다.Quit and relaunch the Configuration Manager console.

새 cmdletNew cmdlets

이 새로 추가 된 cmdlet이이 릴리스에 대 한 새 기능을 추가 하거나 기존 cmdlet의 기능을 개선 하는입니다.These are newly-added cmdlets for this release that add new functionality or enhance the functionality of existing cmdlets.

장치 연결 cmdletDevice association cmdlets

Get-CMResultantCollection 장치에 연결 된 컬렉션을 받게 됩니다.Get-CMResultantCollection will get the collections associated with a device. Get-CMResultantDeployment 대상 장치에 배포를 받게 됩니다.Get-CMResultantDeployment will get the deployments targeted to a device.

클라이언트 인벤토리 클래스 관리Client inventory class management

클라이언트 인벤토리를 사용 하는 수정 인벤토리 클래스를 지원 하기 위해 새 cmdlet 추가 되었습니다.New cmdlets have been added to support modifying inventory classes used for client inventory.

  • Get-CMInventoryClassGet-CMInventoryClass
  • New-CMInventoryReportClassNew-CMInventoryReportClass

작업 순서Task sequences

수정할 작업 순서 단계를 지원 하기 위해 새 cmdlet 추가 되었습니다.New cmdlets have been added to support modifying task sequence steps.

  • 작업 순서 명령 (Get, New, Remove 및 집합 동사 지원)Task sequence commands (Get, New, Remove, and Set verbs supported)
    • CMTaskSequenceStepApplyOperatingSystemCMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSettingCMTaskSequenceStepApplyWindowsSetting

리소스 추적 및 복구 (베타)Resource tracking and recovery (BETA)

PowerShell 런타임에서 더 이상 필요 없는 경우에 이러한 리소스를 정리 하는 데 사용 개체 추적 SMS 공급자를 지원 하기 위해 새 cmdlet이 추가 되었습니다.New cmdlets have been added to support tracking SMS Provider objects used by the PowerShell runtime, and to clean up these resources when they are no longer needed.

  • Disconnect-CMObjectDisconnect-CMObject
  • Start-CMObjectTrackingStart-CMObjectTracking
  • Stop-CMObjectTrackingStop-CMObjectTracking

Start-CMObjectTracking 실행은 런타임 추적 하는 PowerShell IResultObject Cmdlet 라이브러리 cmdlet에서 생성 된 개체입니다.When Start-CMObjectTracking is run, the PowerShell runtime will track IResultObject objects created by Cmdlet Library cmdlets. 정리 되지 않는 수동으로 사용 하 여 Cmdlet .Dispose() 를 사용 하 여 회수 될 수 있습니다 Disconnect-CMObject 개별 개체에 대 한 합니다.Cmdlets that are not manually cleaned up with .Dispose() can be reclaimed by using Disconnect-CMObject against an individual object.


# Reclaim all tracked objects
$o | Disconnect-CMObject```), or ```Disconnect-CMObject -All

Note는 개체를 회수 되 면 더 이상 다시 사용 하거나 이동할 수 없습니다 개체 파이프라인을 통해 다른 cmdlet에 전달 합니다.Note that once an object is reclaimed, it can no longer be reused or passed to another cmdlet through the object pipeline.

Stop-CMObjectTracking 개체 추적이 해제에 사용할 수 있습니다.Stop-CMObjectTracking can be used to turn off object tracking. 이전에 할당 된 개체를 활성 상태로 유지 됩니다.Note that previously allocated objects will remain active.

요청 하지 않은 리소스에는 SMS 공급자에 의해 발생 할당량 위반 오류가 발생할 수 있습니다.Unclaimed resources can cause Quota Violation errors to be raised by the SMS Provider. 이러한 문제는 일반적으로 매우 장기 실행 또는 SMS 공급자 개체의 매우 큰 집합에서 매니페스트 환경These issues typically manifest from working with very large sets of SMS Provider objects or in very long running environments


이 실험적 기능 및 변경 되거나 이후 릴리스에서 제거 될 수 있습니다.This is an experimental feature and may be subject to change or removal in a future release. 이 기능은 옵트인 이며 기본적으로 사용 되지 않습니다.This feature is opt-in and is not enabled by default.

Cmdlet 변경Cmdlet changes

이 릴리스에 대 한 기존 cmdlet에는 다음 변경 사항이 생겼는지 합니다.The following changes have been made to existing cmdlets for this release. 변경 내용을 새 기능, 버그 수정 또는 결함을 수 있으며 중단 될 수 있습니다.Changes may be new functionality, bug fixes, or deprecations, and may be breaking. 이 섹션에 나열 된 cmdlet 또는 기능 영역 중 하나를 사용 하는 경우 신중 하 게 내용을 검토 하세요. 사용에 미칠 수를 알아야 합니다.If you use one of the cmdlets or feature areas listed in this section, please carefully review the changes to understand how they may affect your use.

준수 설정 및 규칙 cmdletCompliance setting and rule cmdlets

해결 된 버그Bugs that were fixed

RuleDescription 값 규칙에 적용할 수 없습니다.RuleDescription value may not apply to the Rule. (규칙 만들기 또는 수정을 지 원하는 Cmdlet)(Cmdlets that support rule creation or modification)

"Default" 레지스트리 키 (추가/집합-CMComplianceSettingRegistryKeyValue, 새로 만들기-CMDetectionClauseRegistryKeyValue)에 대 한 값을 설정할 수 없습니다.Cannot set value for "default" registry key (Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).

Nullreferenceexception이 발생 될 수 있습니다 (새로 만들기-CMComplianceRuleAssembly) 발생 합니다.NullReferenceException may be raised (New-CMComplianceRuleAssembly)

누락 된 데이터 형식 지원 (추가-CMComplientSettingREgistryKeyValue)Missing DataType support (Add-CMComplientSettingREgistryKeyValue)


해결 된 버그Bugs that were fixed

향상 된 오류를 처리 하 고 보고 합니다.Improved error handling and reporting.


비-주요 변경 내용Non-breaking changes

DataWarehouseSqlPort 지원 포트 1-65535에서 값입니다.DataWarehouseSqlPort supports port value from 1-65535. DaysOfWeek 매개 변수는 이제 값 Daily합니다.DaysOfWeek parameter now supports value of Daily.


해결 된 버그Bugs that were fixed

EmailAddress 매개 변수 값에 Exchange server 구성에 적용할 수 없습니다.EmailAddress parameter value may not apply to the Exchange server configuration.


해결 된 버그Bugs that were fixed

ContentLocation 스크립트 검색을 사용 하는 경우 매개 변수는 필수입니다.ContentLocation parameter is required when using script detection. 새로 추가 UninstallContentLocation 하 고 UninstallOption 매개 변수입니다.Added new UninstallContentLocation and UninstallOption parameters.

비-주요 변경 내용Non-breaking changes

에 대 한 유효성 검사를 개선 ProductCode 매개 변수입니다.Improved validation for ProductCode parameter.


비-주요 변경 내용Non-breaking changes

에 대 한 유효성 검사를 개선 ProductCode 매개 변수입니다.Improved validation for ProductCode parameter. 새로 추가 UninstallContentLocation 하 고 UninstallOption 매개 변수입니다.Added new UninstallContentLocation and UninstallOption parameters.


비-주요 변경 내용Non-breaking changes

Cmdlet는 이제 파이프라인된 값 Get-CMDeploymentType합니다.Cmdlet now supports pipelined value from Get-CMDeploymentType.


해결 된 버그Bugs that were fixed

사용 하 여 필터링 하는 경우 모든 메시지가 반환 됩니다 합니다 심각도 매개 변수입니다.Not all messages are returned when filtering with the Severity parameter.

Invoke-CMClientAction (이전의 Invoke CMClientNotification)Invoke-CMClientAction (formerly Invoke-CMClientNotification)

비-주요 변경 내용Non-breaking changes

ActionType 모든 클라이언트 알림 형식을 허용 하는 매개 변수입니다.ActionType parameter that accepts all client notification types.


RequestScriptExecution 이 이번에는 지원 되지 않습니다.RequestScriptExecution is not supported at this time.


NotificationType 로 대체 되었습니다 ActionTypeNotificationType has been superseded by ActionType


해결 된 버그Bugs that were fixed

Cmdlet을 사용 하면 결합 CollectionIdCollectionName, 및 컬렉션 정의 되지 않은 동작이 발생할 수 있는 매개 변수입니다.Cmdlet allows combining CollectionId, CollectionName, and Collection parameters which can lead to undefined behavior.


해결 된 버그Bugs that were fixed

SiteBased 미디어를 만들 수 없습니다.Unable to create media as SiteBased.


해결 된 버그Bugs that were fixed

Cmdlet은 64 비트 PowerShell 환경에서 실행 되지 않습니다.Cmdlet fails to run in a 64-bit PowerShell environment.

Cmdlet에 대 한 값을 지정 하는 경우 오류를 반환할 수 있습니다 합니다 ClientCertificate 매개 변수입니다.Cmdlet may return an error if specifying a value for the ClientCertificate parameter.


해결 된 버그Bugs that were fixed

파이프라인된 개체를 사용 하는 경우 장치를 제거할 수 없습니다.Cannot remove device when using pipelined object.

장치 이름을 사용 하는 경우 보고 되지 않습니다 WhatIf 하거나 Confirm합니다.Device name is not reported when using WhatIf or Confirm.


주요 변경 내용Breaking changes

상태 마이그레이션 지점에 저장 하는 사용자 데이터가 있는 경우 추가 확인 해야 합니다.Additional confirmation will be required if there is user data stored on the state migration point. 참고: Force 이 확인을 바이패스 합니다.Note: Force will bypass this confirmation.


비-주요 변경 내용Non-breaking changes

추가 RetryCount 하 고 RetryDelaySec 매개 변수 다운로드를 다시 시도를 실패 한 후입니다.Added RetryCount and RetryDelaySec parameters to reattempt downloads after a failure.


해결 된 버그Bugs that were fixed

PassThru 업데이트 된 개체를 반환 하지 않을 수 있습니다.PassThru may not return an updated object.


해결 된 버그Bugs that were fixed

와일드 카드 문자를 사용할 수 없습니다 AddExcludedFilePath 매개 변수입니다.Cannot use wildcard characters with AddExcludedFilePath parameter.

구성할 수 없습니다 FallbackOrder 지정한 정책에 대 한Unable to configure FallbackOrder for a given policy

비-주요 변경 내용Non-breaking changes

위협 목록 관리에 대 한 새 매개 변수 추가: AddThreat하십시오 RemoveThreat, 및 CleanThreat합니다.Added new parameters for managing threat lists: AddThreat, RemoveThreat, and CleanThreat. AddThreat 이름 및 값은 형식의 키를 사용 하 여 해시 테이블을 수락 Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType합니다.AddThreat accepts a hashtable with the key being the name, and the value being of type Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType.


ThreatName 하 고 OverrideAction 매개 변수 대체 되었습니다 AddThreatRemoveThreat, 및 CleanThreat.ThreatName and OverrideAction parameters have been superseded by AddThreat, RemoveThreat, and CleanThreat.



HealthAttestationUrl 하므로 매개 변수를 더 이상 제품에 사용 합니다.HealthAttestationUrl parameter as it is no longer utilized by the product.


비-주요 변경 내용Non-breaking changes

AddInventoryReportClass, CleanInventoryReportClass, 및 RemoveInventoryReportClass 매개 변수가 클라이언트에서 수집 된 하드웨어 인벤토리를 수정 하도록 지원 합니다.AddInventoryReportClass, CleanInventoryReportClass, and RemoveInventoryReportClass parameters support modifying the hardware inventory collected by clients.


비-주요 변경 내용Non-breaking changes

에 대 한 유효성 검사를 개선 ProductCode 매개 변수입니다.Improved validation for ProductCode parameter.


해결 된 버그Bugs that were fixed

잠금이 만료 될 때까지 cmdlet 방지 추가로 수정 하지 못하면 잠금 SMS 공급자에서 응용 프로그램 개체 자동으로 해제 하지 않습니다 수 있습니다.Application object in SMS Provider may not automatically unlock if the cmdlet fails preventing further modifications until the lock expires.


비-주요 변경 내용Non-breaking changes

에 대 한 유효성 검사를 개선 ProductCode 매개 변수입니다.Improved validation for ProductCode parameter.


비-주요 변경 내용Non-breaking changes

새로 추가 ContentFileOption 업데이트 다운로드 동작을 구성 하는 것에 대 한 매개 변수입니다.Added new ContentFileOption parameter for configuring update download behavior.


비-주요 변경 내용Non-breaking changes

오류 보고가 개선 됨Improved error reporting


해결 된 버그Bugs that were fixed

Cmdlet은 64 비트 PowerShell 환경에서 실행 되지 않습니다.Cmdlet fails to run in a 64-bit PowerShell environment.

개체 파이프라인을 사용 하는 경우에 MismatchedPSTypeName 오류가 발생할 수 있습니다.MismatchedPSTypeName error may be raised when using the object pipeline.

ProxyAddress 하 고 ProxyPort Configuration Manager 콘솔과 같은 규칙을 사용 하 여 유효성을 검사 하지 않습니다.ProxyAddress and ProxyPort does not validate using the same rules as the Configuration Manager console.

지정 ProxyAddress 없이 ProxyPort 만들려는 잘못 된 구성이 발생할 수 있습니다.Specifying ProxyAddress without ProxyPort may cause an invalid configuration to be created.

SecurityAuthentication 이 지원 하지 않는 구성을 사용 하 여 변경할 수 있습니다.SecurityAuthentication can be changed with configurations that do not support this.

EapType 와 결합 되어야 SecurityAuthentication 도 경우 후자 변경 되지 않음.EapType must be combined with SecurityAuthentication even when the latter is not changing.

비-주요 변경 내용Non-breaking changes

추가 RootCertificate하십시오 ClientCertificate, 및 RememberCredentials 매개 변수입니다.Added RootCertificate, ClientCertificate, and RememberCredentials parameters.

MSCHAPv2 무선 정책 구성에 대 한 향상 된 기능입니다.Improved functionality for configuring a MSCHAPv2 wireless policy.


비-주요 변경 내용Non-breaking changes

Cmdlet에는 더 이상 모든 매개 변수를 지정할 필요 합니다.Cmdlet no longer requires any parameters to be specified.


매개 변수 없이 정의 된 경우 -ForceSync $true 인 것으로 간주 합니다.When no parameters are defined, -ForceSync $true is implied.