다음을 통해 공유

현재 분기 1710에 대한 cmdlet 라이브러리 변경 Configuration Manager

  • 아티클

참고

System Center 구성 현재 분기 1706은 이러한 변경의 기준입니다. 자세한 내용은 현재 분기 1706에 대한 Configuration Manager Cmdlet 라이브러리 변경 내용을 참조하세요.

중요한 변경 내용

설명서 라이브러리 업데이트

최신 cmdlet 라이브러리 설명서는 ConfigurationManager 모듈 참조를 참조하세요.

제거된 cmdlet

다음 cmdlet은 더 이상 지원되지 않으며 제거되었습니다.

  • Invoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccount
  • Set-CMPowerControl

사용되지 않는 cmdlet

  • Invoke-CMEndpointProtectionScan 및 Save-CMEndpointProtectionDefinition 는 로 대체되었습니다 Invoke-CMClientAction.

PSDrive 자동 만들기 사용 안 함

ConfigurationManager.psd1 모듈이 로드되면 PowerShell은 Configuration Manager 콘솔을 사용하여 액세스한 마지막 SMS 공급자에 대한 연결을 자동으로 만들려고 시도합니다. 일부 시나리오에서는 이 동작이 바람직하지 않을 수 있습니다. 이 동작을 사용하지 않도록 설정하고 수동 드라이브를 생성해야 하는 사용자별 레지스트리 키가 추가되었습니다. 이를 구성하려면 레지스트리 키: HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell 를 사용하고 값을 DisableCMDriveAutoCreate DWORD 1(드라이브 자동 생성이 사용하지 않도록 설정됨) 또는 0(기본 동작)으로 설정합니다. 삭제하면 DisableCMDriveAutoCreate 기본 동작도 사용할 수 있습니다.

참고

드라이브 자동 만들기를 사용하지 않도록 설정하면 powerShell 창을 시작할 때 Configuration Manager 콘솔에서 오류를 보고할 수 있습니다.

알려진 문제

이는 이 릴리스에서 해결되지 않은 Cmdlet 라이브러리의 알려진 문제입니다.

Get-CMAadConditionalAccessPolicy 및 Set-CMAadConditionalAccessPolicy

이러한 cmdlet에는 64비트 PowerShell 환경이 필요합니다.

해결 방법

  • 없음

Import-CMSecurityRole

파일을 찾는 디렉터리NotFoundException 오류로 Cmdlet이 SecuredRoles.xsd실패할 수 있습니다.

해결 방법

Import-Module 가 논리적 경로 또는 모듈 이름이 아니라 파일에 대해 ConfigurationManager.psd1 호출되었는지 확인합니다.

Get-CMSiteUpdateInstallStatus

WqlQueryException 오류로 Cmdlet이 실패할 수 있습니다.

해결 방법

  • Invoke-CMWmiQuery 사용하여 SMS_CM_UpdatePackTopLevelMonitoring 클래스를 직접 쿼리합니다.
예시
# 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"

Set-CMSoftwareUpdatePoint

기본 SMS 공급자 개체가 변경되었더라도 일정 변경 내용은 Configuration Manager 콘솔에 반영되지 않을 수 있습니다.

해결 방법

Configuration Manager 콘솔을 종료하고 다시 시작합니다.

새로운 cmdlet

이러한 cmdlet은 새 기능을 추가하거나 기존 cmdlet의 기능을 향상시키는 이 릴리스의 새로 추가된 cmdlet입니다.

디바이스 연결 cmdlet

Get-CMResultantCollection 는 디바이스와 연결된 컬렉션을 가져옵니다. Get-CMResultantDeployment 는 디바이스를 대상으로 하는 배포를 가져옵니다.

클라이언트 인벤토리 클래스 관리

클라이언트 인벤토리에 사용되는 인벤토리 클래스 수정을 지원하기 위해 새 cmdlet이 추가되었습니다.

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

작업 순서

작업 순서 단계 수정을 지원하기 위해 새 cmdlet이 추가되었습니다.

  • 작업 순서 명령(Get, New, Remove 및 Set 동사 지원)
    • CMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSetting

BETA(리소스 추적 및 복구)

PowerShell 런타임에서 사용하는 SMS 공급자 개체 추적을 지원하고 더 이상 필요하지 않은 경우 이러한 리소스를 정리하기 위해 새 cmdlet이 추가되었습니다.

  • Disconnect-CMTrackedObject
  • Start-CMObjectTracking
  • Stop-CMObjectTracking

Start-CMObjectTracking 가 실행되면 PowerShell 런타임은 Cmdlet 라이브러리 cmdlet에서 만든 개체를 추적 IResultObject 합니다. 를 사용하여 수동으로 정리 .Dispose() 되지 않은 Cmdlet은 개별 개체에 대해 를 사용하여 Disconnect-CMTrackedObject 회수할 수 있습니다.

예시

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

개체가 회수되면 개체 파이프라인을 통해 더 이상 다시 사용하거나 다른 cmdlet에 전달할 수 없습니다.

Stop-CMObjectTracking 개체 추적을 해제하는 데 사용할 수 있습니다. 이전에 할당된 개체는 활성 상태로 유지됩니다.

클레임되지 않은 리소스는 SMS 공급자가 할당량 위반 오류를 발생시킬 수 있습니다. 이러한 문제는 일반적으로 매우 큰 SMS 공급자 개체 집합을 사용하거나 매우 오래 실행되는 환경에서 발생합니다.

참고

이는 실험적 기능이며 향후 릴리스에서 변경 또는 제거될 수 있습니다. 이 기능은 옵트인이며 기본적으로 사용하도록 설정되지 않습니다.

Cmdlet 변경 내용

이 릴리스의 기존 cmdlet은 다음과 같이 변경되었습니다. 변경 내용은 새로운 기능, 버그 수정 또는 사용 중단일 수 있으며 호환성이 손상될 수 있습니다. 이 섹션에 나열된 cmdlet 또는 기능 영역 중 하나를 사용하는 경우 변경 내용을 주의 깊게 검토하여 사용에 미치는 영향을 이해하세요.

준수 설정 및 규칙 cmdlet

수정된 버그

RuleDescription 값은 규칙에 적용되지 않을 수 있습니다. (규칙 만들기 또는 수정을 지원하는 Cmdlet)

"기본" 레지스트리 키에 대한 값을 설정할 수 없습니다(Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).

NullReferenceException이 발생할 수 있음(New-CMComplianceRuleAssembly)

DataType 지원 누락(Add-CMComplientSettingREgistryKeyValue)

Add-CMApplicationCatalogWebsitePoint

수정된 버그

오류 처리 및 보고가 향상되었습니다.

Add/Set-CMDataWarehouseServicePoint

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

DataWarehouseSqlPort 는 1-65535의 포트 값을 지원합니다. DaysOfWeek 매개 변수는 이제 의 Daily값을 지원합니다.

Add/Set-CMExchangeServer

수정된 버그

EmailAddress 매개 변수 값은 Exchange 서버 구성에 적용되지 않을 수 있습니다.

Add-CMMsiDeploymentType

수정된 버그

스크립트 검색을 사용할 때 ContentLocation 매개 변수가 필요합니다. 새 UninstallContentLocation 및 UninstallOption 매개 변수가 추가되었습니다.

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

ProductCode 매개 변수에 대한 유효성 검사가 향상되었습니다.

Add-CMScriptDeploymentType

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

ProductCode 매개 변수에 대한 유효성 검사가 향상되었습니다. 새 UninstallContentLocation 및 UninstallOption 매개 변수가 추가되었습니다.

Get-CMDeploymentTypeDependencyGroup

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

이제 Cmdlet은 에서 Get-CMDeploymentType파이프라인된 값을 지원합니다.

Get-CMSiteStatusMessage

수정된 버그

심각도 매개 변수를 사용하여 필터링할 때 모든 메시지가 반환되는 것은 아닙니다.

Invoke-CMClientAction(이전의 Invoke-CMClientNotification)

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

모든 클라이언트 알림 유형을 허용하는 ActionType 매개 변수입니다.

참고

RequestScriptExecution 는 현재 지원되지 않습니다.

사용 중단

NotificationType이 ActionType으로 대체되었습니다.

New-CM*Deployment

수정된 버그

Cmdlet을 사용하면 CollectionId, CollectionName 및 Collection 매개 변수를 결합하여 정의되지 않은 동작으로 이어질 수 있습니다.

New-CMBootableMedia

수정된 버그

SiteBased로 미디어를 만들 수 없습니다.

New-CMWirelessProfile

수정된 버그

Cmdlet이 64비트 PowerShell 환경에서 실행되지 않습니다.

ClientCertificate 매개 변수에 대한 값을 지정하는 경우 Cmdlet에서 오류를 반환할 수 있습니다.

Remove-CMCorpOwnedDevice

수정된 버그

파이프라인된 개체를 사용하는 경우 디바이스를 제거할 수 없습니다.

WhatIf 또는 Confirm를 사용하는 경우 디바이스 이름이 보고되지 않습니다.

Remove-CMStateMigrationPoint

호환성이 손상되는 변경

상태 마이그레이션 지점에 저장된 사용자 데이터가 있는 경우 추가 확인이 필요합니다. 참고: 강제 적용은 이 확인을 무시합니다.

Save-CMSoftwareUpdate

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

실패 후 다운로드를 다시 시도하기 위해 RetryCount 및 RetryDelaySec 매개 변수가 추가되었습니다.

Set-CMAccessAccount

수정된 버그

PassThru는 업데이트된 개체를 반환할 수 없습니다.

Set-CMAntimalwarePolicy

수정된 버그

AddExcludedFilePath 매개 변수에는 와일드카드 문자를 사용할 수 없습니다.

지정된 정책에 대해 구성할 FallbackOrder 수 없음

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

위협 목록을 관리하기 위한 새 매개 변수 추가: AddThreat, RemoveThreat 및 CleanThreat. AddThreat은 키가 이름이고 값이 형식 Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType인 해시 테이블을 허용합니다.

사용 중단

ThreatName 및 OverrideAction 매개 변수는 AddThreat, RemoveThreat 및 CleanThreat으로 대체되었습니다.

Set-CMClientSettingComputerAgent

사용 중단

HealthAttestationUrl 매개 변수는 제품에서 더 이상 활용되지 않으므로 입니다.

Set-CMClientSettingHardwareInventory

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

AddInventoryReportClass, CleanInventoryReportClass 및 RemoveInventoryReportClass 매개 변수는 클라이언트에서 수집한 하드웨어 인벤토리 수정을 지원합니다.

Set-CMMsiDeploymentType

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

ProductCode 매개 변수에 대한 유효성 검사가 향상되었습니다.

Set-CMScriptDeployment

수정된 버그

잠금이 만료될 때까지 cmdlet이 추가 수정을 방지하지 못하면 SMS 공급자의 애플리케이션 개체가 자동으로 잠금 해제되지 않을 수 있습니다.

Set-CMScriptDeploymentType

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

ProductCode 매개 변수에 대한 유효성 검사가 향상되었습니다.

Set-CMSoftwareUpdatePointComponent

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

업데이트 다운로드 동작을 구성하기 위한 새 ContentFileOption 매개 변수가 추가되었습니다.

Set-CMSiteMaintenanceTask

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

향상된 오류 보고

Set-CMWirelessProfile

수정된 버그

Cmdlet이 64비트 PowerShell 환경에서 실행되지 않습니다.

개체 파이프라인을 사용할 때 불일치PSTypeName 오류가 발생할 수 있습니다.

ProxyAddress 및 ProxyPort는 Configuration Manager 콘솔과 동일한 규칙을 사용하여 유효성을 검사하지 않습니다.

ProxyPort 없이 ProxyAddress를 지정하면 잘못된 구성이 만들어질 수 있습니다.

SecurityAuthentication 은 이를 지원하지 않는 구성으로 변경할 수 있습니다.

EapType 은 후자가 변경되지 않는 경우에도 SecurityAuthentication 과 결합되어야 합니다.

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

RootCertificate, ClientCertificate 및 RememberCredentials 매개 변수가 추가되었습니다.

MSCHAPv2 무선 정책을 구성하기 위한 기능이 향상되었습니다.

Sync-CMSoftwareUpdate

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

Cmdlet은 더 이상 매개 변수를 지정할 필요가 없습니다.

참고

매개 변수가 정의되지 않은 경우 는 -ForceSync $true 암시됩니다.