配置服务器 2107 的 cmdlet 库更改

适用范围：Configuration Manager (Current Branch)

这些发行说明汇总了版本 2107 配置服务器 cmdlet 库的更改。

备注

配置服务器当前分支版本 2103 是这些更改的基线。 有关详细信息，请参阅 配置服务器 2103 的 cmdlet 库更改。

应用部署类型的新 cmdlet

管理应用程序部署类型的安装行为

这组新 cmdlet 适用于应用程序部署类型安装行为。 有关安装行为功能的更多常规信息，请参阅检查运行的可执行文件。

Add-CMDeploymentTypeInstallBehavior

使用此 cmdlet 向指定部署类型添加需要关闭才能成功安装应用的可执行文件。

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"

有关详细信息，请参阅 Add-CMDeploymentTypeInstallBehavior。

Get-CMDeploymentTypeInstallBehavior

使用此 cmdlet 从指定的部署类型获取需要关闭才能成功安装应用的可执行文件列表。

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt

有关详细信息，请参阅 Get-CMDeploymentTypeInstallBehavior。

Remove-CMDeploymentTypeInstallBehavior

使用此 cmdlet 从指定部署类型中删除需要关闭才能成功安装应用的可执行文件。

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"

有关详细信息，请参阅 Remove-CMDeploymentTypeInstallBehavior。

Set-CMDeploymentTypeInstallBehavior

使用此 cmdlet 修改需要关闭才能成功安装应用的可执行文件。

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"

有关详细信息，请参阅 Set-CMDeploymentTypeInstallBehavior。

管理应用程序部署类型的返回代码

这组新 cmdlet 适用于应用程序部署类型返回代码。 有关更多常规信息，请参阅部署类型返回代码。

Add-CMDeploymentTypeReturnCode

使用此 cmdlet 将返回代码添加到支持的部署类型。

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"

有关详细信息，请参阅 Add-CMDeploymentTypeReturnCode。

Get-CMDeploymentTypeReturnCode

使用此 cmdlet 可以从指定的部署类型中获取返回代码列表。

Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode

有关详细信息，请参阅 Get-CMDeploymentTypeReturnCode。

Remove-CMDeploymentTypeReturnCode

使用此 cmdlet 可以从指定部署类型中删除返回代码。

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602

有关详细信息，请参阅 Remove-CMDeploymentTypeReturnCode。

Set-CMDeploymentTypeReturnCode

使用此 cmdlet 可以修改指定部署类型的返回代码。

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"

有关详细信息，请参阅 Set-CMDeploymentTypeReturnCode。

其他新 cmdlet

Get-CMClientSettingDeployment

使用此 cmdlet 可获取自定义客户端设置对象的部署。 可以将此对象与 Remove-CMClientSettingDeployment 一起使用。

有关客户端设置的详细信息，请参阅如何配置客户端设置。

$clientSetting =  Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment

有关详细信息，请参阅 Get-CMClientSettingDeployment。

Get-CMDeploymentTypeDetectionClause

使用此 cmdlet 从指定的部署类型获取检测子句。

可以使用此 cmdlet 从一个应用获取检测子句，并将其应用到另一个应用，例如：

$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"

$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

有关详细信息，请参阅 Get-CMDeploymentTypeDetectionClause。

Get-CMPersistentUserSettingsGroup

使用此 cmdlet，可以获取已存储的站点范围内设置的列表。 这些设置将在你的不同设备上同步。

例如，处于活动状态或你已消除的 Configuration Manager 控制台通知。

有关详细信息，请参阅 Get-CMPersistentUserSettingsGroup。

Get-CMSoftwareUpdateContentInfo

使用此 cmdlet 获取软件更新内容信息。

$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]

有关详细信息，请参阅 Get-CMSoftwareUpdateContentInfo。

Remove-CMPersistentUserSettingsGroup

使用此 cmdlet，可以重置站点范围内设置。

例如，可以还原已消除的 Configuration Manager 控制台通知。 在运行此 cmdlet 并重启 Configuration Manager 控制台后，就会再次看到所有可用的通知。

有关详细信息，请参阅 Remove-CMPersistentUserSettingsGroup。

已弃用和已删除 cmdlet

下面用于启动部署的 cmdlet 已弃用，可能会在将来版本中删除：

已弃用的 cmdlet	Replacement
Start-CMApplicationDeploymentSimulation	带有 Simulation 参数的 New-CMApplicationDeployment
Start-CMClientSettingDeployment	New-CMClientSettingDeployment
Start-CMAntimalwarePolicyDeployment	New-CMAntimalwarePolicyDeployment

由于不再支持底层功能，因此无法再使用以下 cmdlet：

• Add-CMApplicationCatalogWebServicePoint

• Add-CMApplicationCatalogWebsitePoint

• Get-CMApplicationCatalogWebServicePoint

• Get-CMApplicationCatalogWebsitePoint

• Remove-CMApplicationCatalogWebServicePoint

• Remove-CMApplicationCatalogWebsitePoint

• Set-CMApplicationCatalogWebsitePoint

• Get-CMVhd

• New-CMVhd

• Remove-CMVhd

• Set-CMVhd

Cmdlet 更改

此版本中的现有 cmdlet 进行了以下更改。 更改可能是新功能或 bug 修复。 某些更改可能会中断。 如果使用本部分中列出的 cmdlet 或功能区域之一，请仔细查看更改，了解这些更改对使用的影响。

Add-CMDeviceCollectionDirectMembershipRule

有关详细信息，请参阅 Add-CMDeviceCollectionDirectMembershipRule。

已修复的 Bug

修复了在尝试添加数以千计的设备作为直接成员身份规则时的问题。

Add-CMDistributionPoint

有关详细信息，请参阅 Add-CMDistributionPoint。

重大更改

默认最小可用空间从 50 MB 更改为 500 MB。

Add-CMTaskSequenceStep

有关详细信息，请参阅 Add-CMTaskSequenceStep。

非重大变化

删除不必要的参数 StepName。

Disconnect-CMTrackedObject

有关详细信息，请参阅 Disconnect-CMTrackedObject。

非重大变化

为此 cmdlet 添加了别名 Disconnect-CMObject。

Get-CMApplicationGroup

有关详细信息，请参阅 CMApplicationGroup。

已修复的 Bug

修复了获取正确应用组路径的问题。

Get-CMDeploymentStatusDetails

有关详细信息，请参阅 CMDeploymentStatusDetails。

已修复的 Bug

修复了查询条件，以避免出现类型不匹配问题。

Import-CMAntimalwarePolicy

有关详细信息，请参阅 CMAntimalwarePolicy。

非重大变化

添加了对包含可能不需要的应用程序的审核模式策略的支持。 有关详细信息，请参阅 可能不需要的应用程序的审核模式。

Import-CMQuery

有关详细信息，请参阅 CMQuery。

已修复的 Bug

修复了取消阻止导入函数的问题。

New-CMAdministrativeUser

有关详细信息，请参阅 CMAdministrativeUser。

已修复的 Bug

修复了用户名为时的问题 me 。

New-CMApplicationDeployment

有关详细信息，请参阅 CMApplicationDeployment。

非重大变化

添加了 AutoCloseExecutable 参数，以启用 "安装行为" 的应用程序部署设置。

New-CMCloudManagementGateway

有关详细信息，请参阅 New-CMCloudManagementGateway。

重大更改

ServiceCertPassword 参数现在是必需的。

New-CMMigrationJob

有关详细信息，请参阅 CMMigrationJob。

已修复的 Bug

取消阻止软件分发部署对象的迁移。

New-CMSecondarySite

有关详细信息，请参阅 new-cmsecondarysite。

重大更改

已将默认的最小可用空间从 200 MB 更改为 500 mb。

New-CMSoftwareUpdateAutoDeploymentRule

有关详细信息，请参阅 New-CMSoftwareUpdateAutoDeploymentRule。

已修复的 Bug

修复了 产品 参数的问题。 如果有多个具有相同名称的产品，它现在会选择所有这些产品。

New-CMSoftwareUpdateDeployment

有关详细信息，请参阅 CMSoftwareUpdateDeployment。

非重大变化

为“注释”参数添加了“说明”别名 。

New-CMTaskSequence

有关详细信息，请参阅 New-CMTaskSequence。

非重大变化

• 将 Description 参数的最大长度扩展为 512 个字符。

• 添加了新的参数 高性能 以支持性能设置。

• 已删除旧的 InstallationLicensingMode 参数。

• 已删除 NewInstallOSImageVhd 参数集。

• 删除了 InstallOperatingSystemImageVhd 参数。

New-CMTaskSequenceDeployment

有关详细信息，请参阅 CMTaskSequenceDeployment。

已修复的 Bug

修复了高性能电源计划的问题。

New-CMTSStepApplyDriverPackage

有关详细信息，请参阅 CMTSStepApplyDriverPackage。

非重大变化

添加了用于验证指定 PackageId 的包的条件。

New-CMTSStepApplyOperatingSystem

有关详细信息，请参阅 New-CMTSStepApplyOperatingSystem。

已修复的 Bug

修复了 DestinationVariable 参数的验证问题，以允许以下划线 (_) 开头的值。

非重大变化

添加了 LayeredDriver 参数以支持在操作系统部署过程中分层的键盘驱动程序。

New-CMTSStepUpgradeOperatingSystem

有关详细信息，请参阅 CMTSStepUpgradeOperatingSystem。

非重大变化

添加了新参数“SoftwareUpdate”，以指定升级 OS 任务序列步骤的功能更新。

Publish-CMPrestageContent

有关详细信息，请参阅 publish-cmprestagecontent。

已修复的 Bug

修复了潜在的无效对象问题。

Remove-CMApplicationGroup

有关详细信息，请参阅 CMApplicationGroup。

已修复的 Bug

修复了在使用管道时获取正确的应用组路径的问题。

Set-CMAntimalwarePolicy

有关详细信息，请参阅 CMAntimalwarePolicy。

非重大变化

添加了参数 PuaProtection ，以支持可能不需要的应用程序。

Set-CMApplicationDeployment

有关详细信息，请参阅 CMApplicationDeployment。

非重大变化

添加了 AutoCloseExecutable 参数，以启用 "安装行为" 的应用程序部署设置。

Set-CMClientSetting

有关详细信息，请参阅 CMClientSetting。

非重大变化

为 SoftwareMetering 参数添加了有意义的弃用消息。

Set-CMClientSettingSoftwareUpdate

有关详细信息，请参阅 CMClientSettingSoftwareUpdate。

非重大变化

添加了参数 EnableWsusCertPinning 以支持证书固定。

Set-CMDeploymentType

有关详细信息，请参阅 Set-CMDeploymentType。

已修复的 Bug

修复了 AddRequirement 参数添加新规则时遇到的问题。

Set-CMMsiDeploymentType

有关详细信息，请参阅 CMMsiDeploymentType。

已修复的 Bug

根据安装程序类型更新部署类型，以避免在更改内容位置时重置配置。

非重大变化

添加对指定 ContentLocation 参数的文件夹路径的支持。

Set-CMTaskSequence

有关详细信息，请参阅 CMTaskSequence。

非重大变化

添加了新的参数 高性能 以支持任务序列的性能设置。

Set-CMTSStepApplyDriverPackage

有关详细信息，请参阅 CMTSStepApplyDriverPackage。

非重大变化

添加了用于验证指定 PackageId 的包的条件。

Set-CMTSStepApplyOperatingSystem

有关详细信息，请参阅 CMTSStepApplyOperatingSystem。

已修复的 Bug

修复了与 目标 参数有关的问题。

非重大变化

添加了 LayeredDriver 参数以支持在操作系统部署过程中分层的键盘驱动程序。

Set-CMTSStepUpgradeOperatingSystem

有关详细信息，请参阅 CMTSStepUpgradeOperatingSystem。

非重大变化

添加了新参数“SoftwareUpdate”，以指定升级 OS 任务序列步骤的功能更新。

Start-CMDistributionPointUpgrade

有关详细信息，请参阅 CMDistributionPointUpgrade。

重大更改

将默认的最小可用空间设置为 500 MB。

Update-CMDistributionPoint

有关详细信息，请参阅 Update-CMDistributionPoint。

已修复的 Bug

修复了在安装和卸载文件夹不同时更新内容的问题。

如何提供反馈或报告问题

本文中所述的许多修补程序和改进都是您的反馈结果。

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

若要提交新的功能请求，请参阅 UserVoice 上 Configuration Manager的 PowerShell 组。