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

適用於:Configuration Manager (最新分支)

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

注意

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

可更新 PowerShell 說明的已知問題

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

在2103版中,PowerShell 模組結構已從29個 Dll 變更為兩個。 PowerShell XML 說明檔與 Cmdlet 的 DLL 相關聯。 因此,2010版說明內容與2103版主控台不相容,版本2103說明內容與2010主控台版本不相容。

由於這項變更可讓更新的內容在版本2103發行時進行結構化及發行,因此請勿在2010版網站上使用 update-help 。 將網站更新為2103版,然後更新本機說明內容。

此 Cmdlet 會在2010版主控台上成功下載內容,但 get-help 只會傳回預設的使用資訊。 此行為是因為 PowerShell 在正確的 XML 檔案中找不到 Cmdlet 資訊,它現在是不同的。 在版本2103發行之前,如果您使用 update-help 搭配版本2010網站,您現在可以繼續使用 get-help

同樣地,如果您在版本2010網站上使用 update-help ,則在更新至2103版之後,請再次執行 update-help 以取得相容的說明內容版本。 否則 get-help 將只會傳回預設的使用資訊。

注意

這是2010版特有的問題。 因為結構的變更,所以在較新的版本中不會有問題。

PowerShell 模組

若裝置上的 Configuration Manager 主控台尚未連線到網站,且您手動匯入 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,這些 Cmdlet 會失敗,並出現下列錯誤: This cmdlet only supports the ".NET Framework" runtime.

新的 Cmdlet

Cmdlet 變更

此版本中的現有 Cmdlet 已進行下列變更。 變更可能是新功能、bug 修正或淘汰。 某些變更可能會中斷。 如果您使用此區段中所列的其中一個 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_DCMDeploymentErrorStatusSMS_DCMDeploymentNonCompliantStatusSMS_DCMDeploymentCompliantStatus
  • 藉由將輸出物件類型 SMS_AppDeploymentRequirementsNotMetStatus 變更為 SMS_AppDeploymentRequirementsNotMetAssetDetails,修正輸出無效類別類型的問題。
  • 將輸出物件類型從 SMS_AppDeploymentAssetDetails 變更為 SMS_AppDeploymentErrorAssetDetails ,以取得更多錯誤詳細資料。
  • 新增 SMS_UpdateDeploymentSummary 的輸入物件類型,讓此 Cmdlet 可以取得更新部署詳細資料。 將 CMSoftwareUpdateDeploymentStatus 的輸出傳遞給 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

已修正的錯誤 (Bug)

已修正安裝以 "yyyy/MM/dd" 時間格式建立的應用程式時的軟體中心顯示問題。

New-CMCertificateProfileScep

已修正的錯誤 (Bug)

已修正 SanType 參數的問題。

New-CMCollection (英文)

非中斷性變更

已修正搭配 Name 參數的驗證,以配合主控台。

New-CMOperatingSystemImage

非中斷性變更

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

New-CMOperatingSystemInstaller

非中斷性變更

已新增 Index 參數。 當您新增此參數時,網站會將目前的多索引映像取代為新的單一索引映像。

New-CMTSRule

非中斷性變更

參數 ReferencedVariableOperator 有另一個可能的值: NotLike

New-CMTSStepConditionVariable

非中斷性變更

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

New-CMSoftwareUpdateAutoDeploymentRule

重大變更

已修正 O365LanguageSelection 參數的問題。 您現在需要指定具有國家/地區名稱的語言。 此變更會將此參數與 Configuration Manager 主控台中的選項對齊。 例如, -O365LanguageSelection "English (United States)"

Set-CMCertificateProfileScep

已修正的錯誤 (Bug)

已修正 SanType 參數的問題。

Set-CMClientPushInstallation

非中斷性變更

加入參數 AllownNTLMFallback 以啟用 NTLM 回復。

Set-CMCollection (英文)

非中斷性變更

使用 NewName 參數修正驗證,以配合主控台。

Set-CMEmailProfile

非中斷性變更

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

Set-CMFallbackStatusPoint

非中斷性變更

修正不一致的參數名稱。

Set-CMThirdPartyUpdateCatalog

非中斷性變更

新增參數 CategoryNamePublishOptionCategoryIdPublishOption。 當您訂閱 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 參數的問題。 您現在需要指定具有國家/地區名稱的語言。 此變更會將此參數與 Configuration Manager 主控台中的選項對齊。 例如, -O365LanguageSelection "English (United States)"

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

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

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

若要提交新的功能要求,請參閱 UserVoice 上的 PowerShell 設定管理員群組。