共用方式為

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

  • 發行項

注意事項

System Center 設定最新分支 1706 是這些變更的基準。 如需詳細資訊，請參閱 Configuration Manager 最新分支 1706 的 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 也會啟用預設行為。

注意事項

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

已知問題

這些是 Cmdlet 程式庫的已知問題，在此版本中尚未解決。

Get-CMAadConditionalAccessPolicy和Set-CMAadConditionalAccessPolicy

這些 Cmdlet 需要 64 位 PowerShell 環境。

因應措施

  • 無

Import-CMSecurityRole

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

因應措施

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

Get-CMSiteUpdateInstallStatus

Cmdlet 可能會因為 WqlQueryException 錯誤而失敗。

因應措施

  • 使用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

Get-CMResultantCollection 會取得與裝置相關聯的集合。 Get-CMResultantDeployment 將會取得以裝置為目標的部署。

用戶端清查類別管理

已新增新的 Cmdlet，以支援修改用於用戶端清查的清查類別。

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

工作順序

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

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

資源追蹤和復原 (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 或功能區域，請仔細檢閱變更，以瞭解這些變更可能會對您的使用造成何種影響。

合規性設定和規則 Cmdlet

已修正的錯誤

RuleDescription 值可能不適用於 Rule。 (支援規則建立或修改的 Cmdlet)

無法 (Add/Set-CMComplianceSettingRegistryKeyValue、New-CMDetectionClauseRegistryKeyValue) 設定 「default」 登錄機碼的值。

New-CMComplianceRuleAssembly (可能會引發 NullReferenceException)

遺漏 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

已修正的錯誤

使用 Severity 參數進行篩選時，不會傳回所有訊息。

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

重大變更

如果有使用者資料儲存在狀態移轉點上，則需要額外的確認。 注意： Force 將會略過此確認。

Save-CMSoftwareUpdate

非中斷性變更

已新增 RetryCount 和 RetryDelaySec 參數，以在失敗後重新嘗試下載。

Set-CMAccessAccount

已修正的錯誤

PassThru 可能不會傳回更新的物件。

Set-CMAntimalwarePolicy

已修正的錯誤

無法搭配 AddExcludedFilePath 參數使用萬用字元。

無法 FallbackOrder 為指定的原則設定

非中斷性變更

已新增用於管理威脅清單的新參數： AddThreat、 RemoveThreat和 CleanThreat。 AddThreat 接受雜湊表，其中索引鍵為名稱，且值為 類型 Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType 。

取代

AddThreat、RemoveThreat和CleanThreat已取代ThreatName和OverrideAction參數。

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 會隱含 。