适用于: Configuration Manager(current branch)
这些发行说明汇总了版本 2103 中对 Configuration Manager cmdlet 库的更改。
注意
Configuration Manager当前分支版本 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
- Get-CMApplicationGroup:使用此 cmdlet 获取应用程序组。
- Get-CMDuplicateHardwareIdGuid:通过 GUID 获取重复的硬件标识符。
- Get-CMDuplicateHardwareIdMacAddress:按 MAC 地址获取重复的硬件标识符。
- New-CMApplicationGroup:使用此 cmdlet 创建新的应用程序组。
- Publish-CMThirdPartySoftwareUpdateContent:使用此 cmdlet 发布第三方更新内容。
- Remove-CMApplicationGroup:使用此 cmdlet 删除特定的应用程序组。
- Remove-CMClientSettingDeployment:使用此 cmdlet 删除客户端设置的特定部署。
- Set-CMApplicationGroup:使用此 cmdlet 配置特定的应用程序组。
- Set-CMCISupportedPlatform:使用此 cmdlet 为配置项目配置平台。
- Sync-CMCloudManagementGateway:将云管理网关的配置 (CMG) 同步到Azure。
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_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
已修复的 Bug
修复了安装使用时间格式“yyyy/MM/dd”创建的应用时的软件中心显示问题。
New-CMCertificateProfileScep
已修复的 Bug
修复了参数 SanType 的问题。
New-CMCollection
非中断性变更
修复了 使用 Name 参数与控制台保持一致的验证。
New-CMOperatingSystemImage
非中断性变更
添加了参数 Index。 添加此参数时,站点将从多索引图像中提取单个索引图像。 然后,它将新图像放置在与原始图像相同的源文件夹中。
New-CMOperatingSystemInstaller
非中断性变更
添加了参数 Index。 添加此参数时,站点会将当前多索引图像替换为新的单索引图像。
New-CMTSRule
非中断性变更
参数 引用VariableOperator 具有另一个可能的值: NotLike。
New-CMTSStepConditionVariable
非中断性变更
Parameter OperatorType 具有另一个可能的值: NotLike
New-CMSoftwareUpdateAutoDeploymentRule
中断性变更
修复了参数 O365LanguageSelection 的问题。 现在需要指定具有国家/地区名称的语言。 此更改使此参数与 Configuration Manager 控制台中的选项保持一致。 例如,-O365LanguageSelection "English (美国)"
Set-CMCertificateProfileScep
已修复的 Bug
修复了参数 SanType 的问题。
Set-CMClientPushInstallation
非中断性变更
添加参数 AllownNTLMFallback 以启用 NTLM 回退。
Set-CMCollection
非中断性变更
修复了 使用 NewName 参数与控制台保持一致的验证。
Set-CMEmailProfile
非中断性变更
- 修复了 将 NewName 参数指定
sAMAccountName为帐户用户名时出现的问题。 - 修复了解析 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。
非中断性变更
Parameter OperatorType 具有另一个可能的值: NotLike
Set-CMSoftwareUpdateAutoDeploymentRule
中断性变更
修复了参数 O365LanguageSelection 的问题。 现在需要指定具有国家/地区名称的语言。 此更改使此参数与 Configuration Manager 控制台中的选项保持一致。 例如,-O365LanguageSelection "English (美国)"
如何提供反馈或报告问题
本文中所述的许多修复和改进都是你的反馈的结果。
若要发送反馈,请使用 Configuration Manager 控制台。 有关详细信息,请参阅 PowerShell 的反馈。