共用方式為

Configuration Manager最新分支 1802 的 Cmdlet 程式庫變更

  • 發行項

注意事項

System Center 設定最新分支 1710 是這些變更的基準。 如需詳細資訊，請參閱 Configuration Manager 最新分支 1710 的 Cmdlet 程式庫變更。

重要變更

系統管理員主控台安裝程式已更新為允許依邏輯名稱匯入 ConfigurationManager 模組，而不需要使用從 <installdir>\bin\ConfigurationManager 到 <installdir>\bin 的硬式連結。

已淘汰的 Cmdlet

停用 PSDrive 自動建立

載入 ConfigurationManager.psd1 模組時，PowerShell 會自動嘗試建立與使用 Configuration Manager 主控台存取的最後一個 SMS 提供者連線。 在某些情況下，這種連線行為可能不理想。 已新增每位使用者登錄機碼，可停用此行為，而且需要手動建立磁片磁碟機。 若要設定行為，請使用登錄機碼： HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell 並將值 DisableCMDriveAutoCreate 設定為 DWORD 為 1 (磁片磁碟機自動建立已停用) 或 0 (預設行為) 。 刪除 DisableCMDriveAutoCreate 也會啟用預設行為。

注意事項

停用磁片磁碟機自動建立時，Configuration Manager主控台可能會在啟動 PowerShell 視窗時回報錯誤。

已知問題

下列專案是此版本中未解決的 Cmdlet 程式庫已知問題。

New-CMCloudDistributionPoint

Cmdlet 目前無法運作。

因應措施

  • 無

Get-CMAadConditionalAccessPolicy和Set-CMAadConditionalAccessPolicy

這些 Cmdlet 需要 64 位 PowerShell 環境。

因應措施

  • 無

Import-CMSecurityRole

Cmdlet 可能會因為找到檔案 SecuredRoles.xsd 時發生 DirectoryNotFoundException 錯誤而失敗。

因應措施

  • 請確定 已 Import-Module 針對 ConfigurationManager.psd1 檔案呼叫 ，而不是邏輯路徑或模組名稱。

Set-CMSoftwareUpdatePoint

即使基礎 SMS 提供者物件已變更，Configuration Manager主控台中可能不會顯示對排程所做的變更。

因應措施

  • 結束並重新啟動Configuration Manager主控台。

新的 Cmdlet

下列專案是此版本新增的 Cmdlet，可新增新功能或增強現有 Cmdlet 的功能。

Co-Management Cmdlet

New-CMCoManagementPolicy 將允許建立共同管理原則。

全域條件 Cmdlet

已新增新的 Cmdlet，以支援建立和修改全域條件。 支援 [新增] 和 [設定動詞命令]。

  • CMGlobalConditionActiveDirectoryQuery
  • CMGlobalConditionAssembly
  • CMGlobalConditionFile
  • CMGlobalConditionIisMetabase
  • CMGlobalConditionRegistryKey
  • CMGlobalConditionRegistryValue
  • CMGlobalConditionScript
  • CMGlobalConditionSqlQuery
  • CMGlobalConditionWqlQuery
  • CMGlobalConditionXPathQuery
  • CMGlobalConditionOmaUri

工作順序 Cmdlet

已新增 Cmdlet 以支援修改工作順序步驟。

  • 支援 (Get、New、Remove 和 Set 動詞命令的工作順序命令)

    • CMTSCaptureNetworkSettings
    • CMTSCaptureSystemImage
    • CMTSCaptureUserState
    • CMTSCaptureWindowsSetting
    • CMTSConvertDisk
    • CMTSDisableBitLocker
    • CMTSEnableBitLocker
    • CMTSPrepareSmsClient
    • CMTSPrepareWindows
    • CMTSStepApplyDataImage
    • CMTSStepDownloadPackageContent
    • CMTSStepJoinDomainWorkgroup
    • CMTSStepOfflineEnableBitLocker
    • CMTSStepPrestartCheckAction
    • CMTSStepRestoreUserState
    • CMTSStepUpgradeOperatingSystem

  • 工作順序條件命令

    • New-CMTSStepConditionOperatingSystemLanguage 用於建立作業系統語言條件的 Cmdlet。

  • 工作順序複製 Cmdlet

    • Copy-CMTaskSequence 用於建立現有工作順序複本的 Cmdlet。

Convert-CMDeploymentType

此 Cmdlet 可讓您從 SMS_DeploymentType WMI 物件實例取得原生 DeploymentType 物件。 可以與 Get-CMDeploymentType 結合。

資源追蹤和復原 (BETA)

已新增新的 Cmdlet 來支援追蹤 PowerShell 執行時間所使用的 SMS 提供者物件，並在不再需要這些資源時加以清除。

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

執行 時 Start-CMObjectTracking ，PowerShell 執行時間會追蹤 IResultObject Cmdlet 程式庫 Cmdlet 所建立的物件。 不使用 手動清除 .Dispose() 的 Cmdlet 可以針對個別物件使用 Disconnect-CMTrackedObject 來回收。

範例

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

回收物件之後，就無法再透過物件管線重複使用或傳遞至另一個 Cmdlet。

Stop-CMObjectTracking 可用來關閉物件追蹤。 先前配置的物件會維持作用中狀態。

未宣告的資源可能會導致 SMS 提供者引發配額違規錯誤。 這些配額問題通常來自于使用大型 SMS 提供者物件集合或長時間執行的環境中。

注意事項

這是實驗性功能，未來版本可能會變更或移除。 此功能已加入宣告，且預設不會啟用。

Cmdlet 變更

已對此版本的現有 Cmdlet 進行下列變更。 變更可能是新功能、錯誤修正或取代。 某些變更可能會中斷。 如果您使用本節所列的其中一個 Cmdlet 或功能區域，請仔細檢閱變更，以瞭解這些變更可能會對您的使用造成何種影響。

PowerShell ISE

已修正的錯誤

當全域啟用詳細資訊記錄且已匯入 ConfigurationManager 模組時，Powershell_ise.exe進程可能會在結束時當機。

工作順序 Cmdlet

已修正的錯誤

  • New-CMTSRule
    • 如果使用變數類型， SecureString Cmdlet 可能會失敗。
  • New-CMTSStepApplyOperatingSystem 和 Set-CMTSStepApplyOperatingSystem
    • 無法為 DestinationLogicalDrive指定 Null 值。
    • DestinationLogicalDrive小寫值可能會導致 UI 驗證失敗。
  • New-CMTSStepApplyWindowsSetting 和 Set-CMTSStepApplyWindowsSetting
    • 密碼 參數使用方式可能會在 SMS 提供者中造成錯誤。
  • New-CMTSStepInstallSoftware 和 Set-CMTSStepInstallSoftware
    • Cmdlet 不正確地允許合併 Program 和 EnableContinueOnInstallError 參數。

非中斷性變更

已改善參數驗證。

Add-CMComplianceSettingRegistryKeyValue

已修正的錯誤

ExpressionValue 不支援所有設定與 ExpressionOperator的組合。 補救 行為與系統管理員主控台不一致。

非中斷性變更

已新增 RemediateDword 參數，以支援補救的整數值。

Add-CMManagementPoint

非中斷性變更

已改善參數驗證。

Add-CMMsiDeploymentType

已修正的錯誤

Cmdlet 不會驗證 UninstallContentLocation 和 UninstallOption 參數組合的正確使用方式。

Add-CMScriptDeploymentType

已修正的錯誤

使用AddDetectionClause時，Cmdlet 不正確地需要使用Script參數。

Add-CMSoftwareUpdatePoint

已修正的錯誤

將軟體更新點新增至遠端系統時，Cmdlet 可能會傳回錯誤。

Enable-CMSiteFeature

已修正的錯誤

如果未針對階層啟用發行前版本功能，Cmdlet 將會失敗，並出現格式不正確的錯誤訊息。

Get-CMApplication

重大變更

隱藏的應用程式現在預設不再包含。 已新增 ShowHidden 參數，以強制在結果集中顯示隱藏的應用程式。

Get-CMSiteInstallStatus

已修正的錯誤

Cmdlet 可能會對 SMS 提供者執行不正確查詢。

Get-CMSiteStatusMessage

已修正的錯誤

狀態訊息查詢可能會傳回重複的訊息。

New-CMBootableMedia

已修正的錯誤

DistributionPoint 參數不會忽略已啟用雲端的發佈點。

New-CMComplianceRuleFileFolderSize

非中斷性變更

已改善參數驗證。

New-CMDetectionClauseMacPackage

已修正的錯誤

已改善參數驗證。

New-CMDetectionClauseWindowsInstaller

已修正的錯誤

ProductCode 值未正確套用至 Setting 物件。

New-CMExchangeServer

非中斷性變更

FullSyncSchedule 或 DeltaSyncMins 參數不再是必要參數，如果未使用，則會套用預設排程。

New-CMInventoryReportClass**

非中斷性變更

已新增Name參數以定義類別名稱。

New-CMPrestagedMedia

已修正的錯誤

指定副檔名為 .wim 的輸出檔時，Cmdlet 會失敗。

New-CMProgram

已歸檔的錯誤

ProgramRunType 參數值可能不正確地套用至 Program。

New-CMSchedule

已修正的錯誤

RecurCount 不應允許 的 0 值。

New-CMStandaloneMedia

已修正的錯誤

如果 MediaType 為 Usb ，Cmdlet 可能無法建立媒體。

非中斷性變更

已改善參數驗證。

New-CMStatusFilterRule

非中斷性變更

已改善參數驗證。

New-CMStorageFolder

非中斷性變更

已改善參數驗證。

New-CMTaskSequenceDeployment

已修正的錯誤

使用 ScheduleEvent 時，Cmdlet 可能會新增兩個排程。

New-CMWirelessProfile

非中斷性變更

已改善參數驗證。

Publish-CMPrestageContent

已修正的錯誤

應用/ApplicationName/ApplicationId參數使用方式可能會導致 Cmdlet 失敗。

非中斷性變更

效能提升。

Set-CMAntimalwarePolicy

已修正的錯誤

AddExcludedFilePath 不會建立預設排除規則。

Set-CMApplication

已修正的錯誤

修改具有多種顯示語言的應用程式可能會導致應用程式狀態發生非預期的變更。

非中斷性變更

已新增 AddAppCategory、 AddUserCategory、 RemoveAppCategory、 RemoveUserCategory、 CleanAppCategory和 CleanUserCategory 參數，以支援依物件新增應用程式類別。

取代

新的 [新增] 已取代AppCategory和UserCategory參數|移除|Clean]AppCategory 和 [Add|移除|Clean]UserCategory 參數。

Set-CMBoundary

已修正的錯誤

遺漏 NewName 參數。

非中斷性變更

已改善參數驗證。

Set-CMClientSettingClientcache

取代

不再支援EnableHttps參數。

Set-CMManagementPoint

非中斷性變更

已改善參數驗證。

Set-CMMsiDeploymentType

已修正的錯誤

Cmdlet 不會驗證 UninstallContentLocation 和 UninstallOption 參數組合的正確使用方式。

Set-CMPackage

已修正的錯誤

UseMeteredNetwork 參數遺失。

Set-CMSoftwareInventory

非中斷性變更

已新增 CleanTag1、 CleanTag2、 CleanTag3 參數以支援移除標記。

已新增 ParentSoftwareId、 CategoryId 參數。

已改善參數驗證。

Set-CMStatusFilterRule

非中斷性變更

已改善參數驗證。

Set-CMUserDataAndProfileConfigurationItem

非中斷性變更

已改善參數驗證。

Set-CMWirelessProfile

非中斷性變更

改善各種設定檔建立案例的參數驗證。