版本 2103 的 Configuration Manager cmdlet 库更改

适用于: Configuration Manager(current branch)

这些发行说明汇总了对版本 2103 中的 Configuration Manager cmdlet 库的更改。

注意

Configuration Manager Current Branch 版本 2010 是这些更改的基准。 有关详细信息,请参阅版本 2010 的 Configuration Manager cmdlet 库更改

可更新 PowerShell 帮助的已知问题

从版本 2010 开始,可以使用 Update-Help cmdlet 下载 Configuration Manager 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 版本网站使用了 Update-Help ,则现在可以继续使用 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

虽然 Configuration Manager 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.

New 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 可以获取更新部署详细信息。 将 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

已修复的 bug

修复了安装使用时间格式“yyyy/MM/dd”创建的应用时软件中心显示的问题。

New-CMCertificateProfileScep

已修复的 bug

修复了参数 SanType 的问题。

New-CMCollection

非重大更改

修复 了使用名称 参数的验证以与主机保持一致。

New-CMOperatingSystemImage

非重大更改

添加了参数 索引。 添加此参数后,站点将从多索引图像中提取单个索引图像。 然后,它会将新图像放置在与原始图像相同的源文件夹中。

New-CMOperatingSystemInstaller

非重大更改

添加了参数 索引。 添加此参数时,站点会将当前多索引图像替换为新的单索引图像。

New-CMTSRule

非重大更改

Parameter ReferencedVariableOperator 还有另一个可能的值: NotLike

New-CMTSStepConditionVariable

非重大更改

参数 OperatorType 还有另一个可能的值: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

重大更改

修复了参数 O365LanguageSelection 的问题。 现在需要指定具有国家/地区名称的语言。 此更改使此参数与 Configuration Manager 控制台中的选项保持一致。 例如,-O365LanguageSelection "English (美国)"

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 (美国)"

如何提供反馈或报告问题

本文中描述的许多修复和改进都是你反馈的结果。

若要发送反馈,请使用 Configuration Manager 控制台。 有关详细信息,请参阅 PowerShell 的反馈