版本 2103 的 設定管理員 Cmdlet 程式庫變更

適用於：設定管理員 (目前的分支)

這些版本資訊摘要說明版本 2103 中對 設定管理員 Cmdlet 程式庫的變更。

注意事項

設定管理員 目前分支 2010 版是這些變更的基準。 如需詳細資訊，請參閱 2010 版的 設定管理員 Cmdlet 程式庫變更。

可更新 PowerShell 說明的已知問題

從 2010 版開始，您可以使用 Update-Help Cmdlet 下載 設定管理員 PowerShell 模組的最新資訊。

在版本 2103 中，PowerShell 模組結構從 29 個 DLL 變更為 2 個。 PowerShell XML 說明檔案會與 Cmdlet 的 DLL 相關聯。 因此，版本 2010 的說明內容與版本 2103 的主機不相容，而版本 2103 的說明內容也與版本 2010 的主機不相容。

由於版本 2103 發行後可更新內容的結構化與發佈方式有此變更，因此請勿在版本 2010 的網站上使用 Update-Help 。 將網站更新為版本 2103，然後更新本機說明內容。

Cmdlet 將成功在版本 2010 主機上下載內容，但 Get-Help 將僅傳回預設的使用方式資訊。 出現此行為是因為 PowerShell 無法在正確的 XML 檔案中找到 Cmdlet 資訊，現在情況不同了。 在發行 2103 版之前，如果您在 2010 版網站使用更新 說明 ，現在可以繼續使用 Get-Help 。

同樣地，如果您在 2010 版網站上使用 Update-Help ，在更新至 2103 版之後，請再次執行 Update-Help 以取得與說明內容相容的版本。 否則， Get-Help 只會傳回預設的使用方式資訊。

注意事項

此問題是版本 2010 所獨有。 由於結構的變更方式，這在較新的版本應該不會成為問題。

PowerShell 模組

如果裝置上的 設定管理員 主控台尚未連線到網站，如果您手動匯入 ConfigurationManager 模組，它會根據預設 SMS 提供者為網站建立 PowerShell 磁碟機。

從版本 2103 開始，ConfigurationManager PowerShell 模組需要 Microsoft .NET 版本 4.7.2 或更新版本。

不支援 PowerShell 版本 7 的 Cmdlet

雖然 設定管理員 Cmdlet 為 PowerShell 版本 7 提供一般支援，但下列 Cmdlet 不支援 PowerShell 7：

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

它們需要 .NET Framework 而不是與 PowerShell 版本 7 搭配使用的 .NET Core。

從版本 2103 開始，如果您嘗試在 PowerShell 版本 7 工作階段中使用這些 Cmdlet，它們會失敗並出現下列錯誤： This cmdlet only supports the ".NET Framework" runtime.

新的 Cmdlet

Cmdlet 變更

我們已對此版本中的現有 Cmdlet 進行下列變更。 變更可能是新功能、錯誤修正或取代。 有些變更可能會破壞性。 如果您使用本節所列的其中一個 Cmdlet 或功能區域，請仔細檢閱變更，以了解它們如何影響您的使用。

快速支援

下列 Cmdlet 現在支援 Fast 參數。 使用此參數可不自動重新整理消極式屬性。 消極式屬性包含擷取時相對低效率的值。 取得這些屬性可能會導致更多網路流量，並影響 Cmdlet 效能。

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

非中斷性變更

修正不一致的參數名稱。

Copy-CMCollection

非中斷性變更

修正使用 NewName 參數的驗證以與主控台對齊。

Get-CMDeploymentStatusDetails

非中斷性變更

  • 已修正 SMS_DCMDeploymentErrorStatus、 SMS_DCMDeploymentNonCompliantStatus 和 SMS_DCMDeploymentCompliantStatus 等類型的輸入物件類型驗證問題。
  • 透過將輸出物件類型 SMS_AppDeploymentRequirementsNotMetStatus 變更為 SMS_AppDeploymentRequirementsNotMetAssetDetails，修復了輸出無效類別類型問題。
  • 將輸出物件類型從 SMS_AppDeploymentAssetDetails 變更為 SMS_AppDeploymentErrorAssetDetails 以取得更多錯誤詳細資料。
  • 新增輸入物件類型 SMS_UpdateDeploymentSummary ，讓此 Cmdlet 可以取得更新部署詳細資料。 將 Get-CMSoftwareUpdateDeploymentStatus 的輸出傳遞至 Get-CMDeploymentStatusDetails 時，它會從 SMS_SUMDeploymentAssetDetails傳回部署詳細資料。

Get-CMDriver

非中斷性變更

新增依參數 AdministrativeCategory 篩選的功能。

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

非中斷性變更

新增了用於擷取特定套件類型的參數 PackageType 。

Get-CMSoftwareUpdateDeployment

非中斷性變更

已修正在無套件的情況下部署更新的問題。

New-CMApplication

已修正的錯誤

修正安裝使用時間格式為 “yyyy/MM/dd” 建立的應用程式時，軟體中心顯示的問題。

New-CMCertificateProfileScep

已修正的錯誤

已修正參數 SanType 的問題。

New-CMCollection

非中斷性變更

使用 Name 參數修正驗證以與主控台對齊。

New-CMOperatingSystemImage

非中斷性變更

已新增參數 Index。 當您新增此參數時，網站會從多索引影像擷取單一索引影像。 接著，它會將新影像放置在與原始影像相同的來源資料夾中。

New-CMOperatingSystemInstaller

非中斷性變更

已新增參數 Index。 當您新增此參數時，網站會以新的單一索引影像取代目前的多重索引影像。

New-CMTSRule

非中斷性變更

參數 ReferencedVariableOperator 還有另一個可能的值： NotLike。

New-CMTSStepConditionVariable

非中斷性變更

參數 OperatorType 還有另一個可能的值： NotLike

New-CMSoftwareUpdateAutoDeploymentRule

中斷性變更

已修正參數 O365LanguageSelection 的問題。 您現在需要指定語言搭配國家/地區名稱。 此變更會使此參數與 設定管理員 主控台中的選項保持一致。 例如，-O365LanguageSelection "English (美國)"

Set-CMCertificateProfileScep

已修正的錯誤

已修正參數 SanType 的問題。

Set-CMClientPushInstallation

非中斷性變更

新增參數 AllownNTLMFallback 以啟用 NTLM 後援。

Set-CMCollection

非中斷性變更

修正使用 NewName 參數的驗證以與主控台對齊。

Set-CMEmailProfile

非中斷性變更

  • 已修正當您指定sAMAccountName為帳戶使用者名稱時的 NewName 參數問題。
  • 修正解析 DomainName 時的參數問題。

Set-CMFallbackStatusPoint

非中斷性變更

修正不一致的參數名稱。

Set-CMThirdPartyUpdateCatalog

非中斷性變更

新增參數 CategoryNamePublishOption 和 CategoryIdPublishOption。 使用這些參數來設定訂閱 v3 型錄時的類別發佈選項。

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

非中斷性變更

修正將 PublishOption 參數設為 FullContent的問題。

Set-CMTSStep*

例如， Set-CMTSStepApplyDataImage 和其他 34 個類似的 Cmdlet。

非中斷性變更

參數 OperatorType 還有另一個可能的值： NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

中斷性變更

已修正參數 O365LanguageSelection 的問題。 您現在需要指定語言搭配國家/地區名稱。 此變更會使此參數與 設定管理員 主控台中的選項保持一致。 例如，-O365LanguageSelection "English (美國)"

如何提供意見反應或回報問題

本文所述的許多修正和改善功能都是您意見反應的結果。

若要傳送意見反應，請使用 設定管理員 主控台。 如需詳細資訊，請參閱 PowerShell 的意見反應。

  • Last updated on