Current Branch 1702 的 Configuration Manager Cmdlet 库更改

重要更改

文档库更新

有关最新的 cmdlet 库文档，请参阅 ConfigurationManager 模块参考。

已删除 cmdlet

以下 cmdlet 不再受支持，已删除：

• Add-CMNokiaDeploymentType

• Add-CMOutOfBandServicePoint

• Add-CMSystemHealthValidatorPoint

• Clear-CMAmtAuditLog

• Disable-CMAmtAuditLog

• Enable-CMAmtAuditLog

• Enable-CMAutomaticAmtProvisioning

• Get-CMAutomaticAmtProvisioningStatus

• Get-CMCmdletUpdateCheck

• Get-CMOutOfBandManagementComponent

• Get-CMOutOfBandServicePoint

• Get-CMSystemHealthValidatorPoint

• Get-CMSystemHealthValidatorPointComponent

• New-CMWiredProfileObject

• New-CMWirelessProfileObject

• Remove-CMAmtProvisioningData

• Remove-CMNokiaDeploymentType

• Remove-CMOutOfBandServicePoint

• Remove-CMSystemHealthValidatorPoint

• Send-CMCmdletUpdateCheck

• Set-CMCmdletUpdateCheck

• Set-CMNokiaDeploymentType

• Set-CMOutOfBandManagementComponent

• Set-CMOutOfBandServicePoint

• Set-CMSystemHealthValidatorPointComponent

• Update-CMAmtProvisioning

支持使用逻辑名称导入 ConfigurationManager 模块

现在支持使用逻辑名称或路径导入 ConfigurationManager 模块。

如果将 C：\Program Files (x86) \Microsoft Configuration Manager\AdminConsole\bin 或等效路径添加到 PSModulePath 变量，则可以使用以下项：

Import-Module ConfigrationManager

否则，可以使用以下内容：

Import-Module 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager'

已知问题

这些是 Cmdlet 库的已知问题，未在此版本中解决。

Get-CMAadConditionalAccessPolicy 和 Set-CMAadConditionalAccessPolicy

这些 cmdlet 需要 64 位 PowerShell 环境。

解决方法

• None

New cmdlet

这些是此版本新添加的 cmdlet，可添加新功能或增强现有 cmdlet 的功能。

iOS 注册配置文件

添加了用于配置 iOS 注册配置文件的新 cmdlet。

• Get-CMIosEnrollmentProfile

• New-CMIosEnrollmentProfile

• Remove-CMIosEnrollmentPRofile

• Set-CMIosEnrollmentProfile

云管理网关 cmdlet

添加了用于配置云管理网关站点角色的新 cmdlet。

• Add-CMCloudManagementGatewayConnectionPoint

• Get-CMCloudManagementGateway

• Get-CMCloudManagementGatewayConnectionPoint

• New-CMCloudManagementGateway

• Remove-CMCloudManagementGateway

• Remove-CMCloudManagementGatewayConnectionPoint

• Set-CMCloudManagementGateway

• Set-CMCloudManagementGatewayConnectionPoint

• Start-CMCloudManagementGateway

• Stop-CMCloudManagementGateway

数据仓库服务点 cmdlet

添加了用于配置数据仓库服务点站点角色的新 cmdlet。

• Add-CMDataWarehouseServicePoint

• Get-CMDataWarehouseServicePoint

• Remove-CMDataWarehouseServicePoint

• Set-CMDataWarehouseServicePoint

部署 cmdlet

已编写了几个新的 cmdlet，并围绕部署和部署监视方案进行了改进。

内容分发状态

Get-CMDistributionStatus 是一个新的 cmdlet，可用于获取任何内容对象的分发状态，例如应用程序、设置或程序包。

获取部署

已创建 Cmdlet 以获取与实际部署关联的对象。

• Get-CMApplicationDeployment

• Get-CMBaselineDeployment

• Get-CMConfigurationPolicyDeployment

• Get-CMPackageDeployment

• Get-CMSoftwareUpdateDeployment

• Get-CMTaskSequenceDeployment

部署创建

已创建用于创建新部署的 Cmdlet。 这些 cmdlet 取代了预先存在的 Start-CM*Deployment cmdlet。

• New-CMApplicationDeployment

• New-CMBaselineDeployment

• New-CMConfigurationPolicyDeployment

• New-CMPackageDeployment

• New-CMSoftwareUpdateDeployment

• New-TaskSequenceDeployment

改进了对象管道支持

Set-CM*Deployment、Remove-CM*Deployment 和 Get-CM*DeploymentStatus 现在完全支持对象管道。

Start-CM<功能>已弃用部署 cmdlet

以下 Start-CM<功能>已弃用部署 cmdlet。 替换 cmdlet 在参数名称上可能有所不同，但应具有相同的功能，在某些情况下会得到改进。

• Start-CMApplicationDeployment (替换为 New-CMApplicationDeployment)

• Start-CMPackageDeployment (替换为 New-CMPackageDeployment)

• Start-CMBaselineDeployment (替换为 New-CMBaselineDeployment)

• Start-CMConfigurationPolicyDeployment (替换为 New-CMConfigurationPolicyDeployment)

• Start-CMTaskSequenceDeployment (替换为 New-CMTaskSequenceDeployment)

• Start-CMSoftwareUpdateDeployment (替换为 New-CMSoftwareUpdateDeployment)

Get-CMResultantSettings

此 cmdlet 将检索集合、设备或用户的结果客户端设置。

操作系统升级包更新

添加了用于创建和修改操作系统升级包更新计划的新 cmdlet。

• Clear-CMOperatingSystemUpgradeUpdateSchedule

• Get-CMOperatingSystemUpgradeUpdateSchedule

• New-CMOperatingSystemUpgradeUpdateSchedule

• Remove-CMOperatingSystemUpgradeUpdateSchedule

Remove-CMSoftwareUpdateFromGroup

此 cmdlet 将从软件更新组中删除软件更新。

Cmdlet 更改

已针对此版本的现有 cmdlet 进行了以下更改。 更改可能是新功能、bug 修复或弃用，并且可能会中断。 如果使用本节中列出的某个 cmdlet 或功能区域，请仔细查看更改，以了解它们如何影响你的使用。

其他更改

已修复的 Bug

cmdlet 框架可能无法正确使用某些提供程序类使用的大型SMS_EmbeddedPropertyList对象，从而导致在获取或设置这些值时出现未定义的行为。

反恶意软件策略或客户端设置的某些更改组合可能会导致生成无效策略。 处于此状态时，SMS 提供程序将返回“实例不是有效的客户端代理配置”错误。

用于配置管理点和软件更新点的 Cmdlet 添加了 EnableCloudGateway 参数，以允许这些角色与云管理网关一起使用。

站点维护时段配置

非中断性变更

CMMaintenanceWindow cmdlet 现在支持为站点配置维护时段。 Get-CMSite 的输出可以管道化为 New、Remove 或 Set-CMMaintenanceWindow，以配置站点的维护时段。

Add-CMDeploymentType

中断性变更

已删除对创建 Nokia 部署类型的支持。

Add-CMDeviceAfinityToUser

已修复的 Bug

Cmdlet 可能会意外失败并出现 ObjectNotFound 错误。

Add-CMDistributionPoint

已修复的 Bug

Cmdlet 允许在未启用 HTTPS 时将分发点配置为支持 Internet。

非中断性变更

添加了 AllowProxyTraffic 参数。

以前未使用的 InstallInternetServer 参数现在更改分发点配置。

弃用

已弃用 UseComputerAccount 参数。 若要使用计算机帐户，请将 “用户名” 设置为“$null”。

Add-CMEnrollmentPoint

已修复的 Bug

在创建的对象中缺少配置设置的注册点角色。

Add-CMEnrollmentProxyPoint

非中断性变更

添加了 ServiceHost 参数以允许指定远程注册点。

Add-CMIntuneSubscription

已修复的 Bug

ContactEmail 参数不能设置为 null 或空值。

Add-CMMulticastServicePoint

已修复的 Bug

UserName 不会验证域\用户格式是否正确。

StartUdpPort 和 EndUdpPort 参数不会验证某些错误配置的值。

StartIPAddress 和 EndIPAddress 参数不会验证某些错误配置的值。

非中断性变更

添加了 UseAnyRangeIP 参数。

弃用

不再支持 ClientTransferRate 参数。

Approve-CMUserDeviceAffinityRequest

已修复的 Bug

Cmdlet 允许批准以前处理的相关性请求。

Convert-CMSchedule

已修复的 Bug

InputObject 参数不接受管道计划对象。

Deny-CMUserDeviceAffinityRequest

已修复的 Bug

Cmdlet 允许拒绝以前处理的相关性请求。

Get-CMAlert

已修复的 Bug

无法检索客户端运行状况或终结点保护警报。

Get-CMSiteStatusMessage

非中断性变更

ComputerName、 Severity 和 SiteCode 参数现在接受数组值。

添加了 MessageId、 Module、 Component 和 FilterHashTable 参数，用于进一步筛选。

所有基于字符串的筛选器参数现在都接受通配符。

Get-CMWindowsEnrollmentProfilePackage

已修复的 Bug

不能指定没有参数的 cmdlet。

Import-CMComputerInformation

中断性变更

如果导入已存在的记录并且未指定新的 MergeIfExist 参数，Cmdlet 将失败。

Import-CMDriver

已修复的 Bug

使用 ImportFolder 时，驱动程序包可能会占用比预期更多的空间。

Install-CMClient

非中断性变更

从 Get-CMDevice 和 Get-CMResource 添加了对管道对象的支持。

Invoke-CMRemoteControl

已修复的 Bug

Cmdlet 不接受 来自 Get-CMSiteSystemServer 的管道对象。

如果站点系统服务器不是客户端计算机，则无法将其作为远程控制的目标。

New-CMActiveDirectoryForest

非中断性变更

添加了 UserName 参数以允许配置发现帐户。

添加了 AddPublishingSite 参数。

New-CMApplicationDeployment

非中断性变更

添加了 UpdateSupersedence 参数。

New-CMBoundaryGroup

中断性变更

FastLink 是 AddSiteSystemServer 参数中哈希表唯一受支持的值。 已删除对所有其他值的支持。

New-CMCertificateProfilePfx

已修复的 Bug

KeyStorageProvider 参数值可能不会按预期应用于新创建的证书配置文件。

New-CMGlobalCondition

中断性变更

已删除对创建 Nokia 全局条件的支持。

New-CMProgram

非中断性变更

添加了 AddSupportedOperatingSystemPlatform 参数。

New-CMSoftwareUpdateAutoDeploymentRule

已修复的 Bug

MicrosoftAsVendor 参数值可能不会应用于规则。

非中断性变更

添加了 Vendor 参数以支持第三方修补程序。

添加了 GenerateFailureAlert 参数。

New-CMSoftwareUpdateDeployment

非中断性变更

添加了 RequirePostRebootFullScan 参数。

New-CMStandaloneMedia

非中断性变更

添加了 MediaStartDate 和 MediaExpirationDate 参数，以支持媒体过期。

添加了 Application、 DriverPackage 和 Package 参数，用于添加其他媒体内容。

New-CMStatusMessageQuery

已修复的 Bug

创建的查询可能不会显示在预期的管理员控制台位置。

New-CMWindowsEnrollmentProfile

已修复的 Bug

EnrollmentProxyPoint 参数可以设置为 null 或空值。

SiteCode 参数值可能会导致管理员控制台中出现验证错误。

Remove-CMResource

已修复的 Bug

删除资源不会删除状态迁移关联。

Remove-CMWindowsEnrollmentProfilePackage

已修复的 Bug

运行 cmdlet 时，可能会引发不明确的ParameterSet 错误。

Set-CMActiveDirectoryForest

非中断性变更

添加了 UserName 参数以允许配置发现帐户。

添加了 AddPublishingSite 和 RemovePublishingSite 参数。

Set-CMAdvancedThreatProtectionPolicy

已修复的 Bug

增加或降低优先级可能会导致返回 ObjectNotFound 错误。

Set-CMAntimalwarePolicy

已修复的 Bug

WhatIf 可能不会显示预期的策略名称。

使用管道对象时，无法更改实时保护设置。

非中断性变更

Cmdlet 现在接受来自 Get-CMAntimalwarePolicy 的管道输入。

Set-CMApplication

非中断性变更

添加了 AddSupportContact、 AddOwner、 RemoveSupportContact、 RemoveOwner、 ClearSupportContact 和 ClearOwner 参数，以支持就地修改支持联系人或所有者。

Set-CMAppVVirtualEnvironment

已修复的 Bug

PassThru 不返回最新的对象。

Set-CMBaseline

已修复的 Bug

PassThru 不返回 SMS_ConfigurationItem 对象。

非中断性变更

添加了 ClearRequiredConfigurationItem、 ClearProhibitedConfigurationItem、 ClearOptionalConfigurationItem、 ClearOSConfigurationItem、 ClearSoftwareUpdate、 ClearBaseline、 RemoveRequiredConfigurationItem、 RemoveOptionalConfigurationItem、 RemoveProhibitedConfigurationItemRemoveOSConfigurationItem、 RemoveSoftwareUpdate、 RemoveBaseline、 AddSoftwareUpdate 和 AddBaseline 参数。

Set-CMBoundaryGroup

中断性变更

FastLink 是 AddSiteSystemServer 参数中哈希表唯一受支持的值。 已删除对所有其他值的支持。

Set-CMCertificateProfileTrustedRootCA

已修复的 Bug

使用对象管道可能会导致 ParameterBindingException 错误。

Set-CMClientPushInstallation

非中断性变更

添加了 AddAccount 和 RemoveAccount 参数，以支持客户端推送帐户的就地修改。

Set-CMClientSettingComputerAgent

已修复的 Bug

如果将 EnableHealthAttestation 或 UseOnPremisesHealthAttestation 设置为 true，则不需要 HealthAttestationUrl 参数值。

Set-CMComputerAssociation

非中断性变更

添加了 MigrationId 参数。

Set-CMDeploymentType

中断性变更

已删除对修改 Nokia 部署类型的支持。

Set-CMDiscoveryMethod

已修复的 Bug

PollingSchedule 值可能无法正确应用于发现方法。

Set-CMDistributionPoint

已修复的 Bug

Cmdlet 允许在未启用 HTTPS 时将分发点配置为支持 Internet。

非中断性变更

添加了 AllowProxyTraffic 参数。

以前未使用的 InstallInternetServer 参数现在更改分发点配置。

弃用

已弃用 UseComputerAccount 参数。 若要使用计算机帐户，请将 “用户名” 设置为“$null”。

Set-CMEmailNotificationComponent

非中断性变更

添加了 UseSsl 参数。

Set-CMFileReplicationRoute

已修复的 Bug

FileReplicationAccountName 参数不能设置为 null 或空值。

Set-CMHierarchySetting

非中断性变更

添加了 ExclusionCollection、 ExclusionCollectionId、 ExclusionCollectionName 和 EnableExclusionCollection 参数，用于配置客户端升级排除项。

Set-CMIntuneSubscription

已修复的 Bug

ContactEmail 参数不能设置为 null 或空值。

非中断性变更

MaximumUserDevice 参数现在支持介于 1 和 15 之间的值。

Set-CMIntuneSubscriptionWindowsPhoneProperty

已修复的 Bug

Cmdlet 可能会意外失败并出现 AetCleanupFailure 错误。

Set-CMMaintenanceTask

已修复的 Bug

PassThru 参数不会导致返回对象。

Set-CMMulticastServicePoint

已修复的 Bug

UserName 参数不会验证域\用户格式是否正确的值。

StartUdpPort 和 EndUdpPort 参数不会验证某些错误配置的值。

StartIPAddress 和 EndIPAddress 参数不会验证某些错误配置的值。

非中断性变更

添加了 UseAnyRangeIP 参数。

弃用

不再支持 ClientTransferRate 参数。

Set-CMProgram

非中断性变更

添加了 AddSupportedOperatingSystemPlatform、 RemoveSupportedOperatingSystemPlatform 和 RunOnAnyPlatform 参数。

Set-CMSite

已修复的 Bug

RemoveClientRequestServiceType 可能无法正确删除指定的值。

非中断性变更

添加了 SiteSystemCollectionBehavior、 ThresholdOfSelectCollectionMax、 ThresholdOfSelectCollectionByDefault 和 ThresholdOfSelectCollectionMax 参数，以配置站点的设备集合阈值。

Set-CMSiteSummaryTask

已修复的 Bug

PassThru 参数不会导致返回对象。

Set-CMSoftwareUpdateAutoDeploymentRule

已修复的 Bug

MicrosoftAsVendor 参数值可能不会应用于规则。

非中断性变更

添加了 Vendor 参数以支持第三方修补程序。

添加了 GenerateFailureAlert 参数。

Set-CMSoftwareUpdateDeployment

非中断性变更

添加了 RequirePostRebootFullScan 参数。

Set-CMSoftwareUpdatePointComponent

已修复的 Bug

EnableSynchronization 和 Schedule 参数的使用可能会导致生成不正确的警告，或者计划未按预期进行修改。

Set-CMStatusFilterRule

已修复的 Bug

对 Priority 参数值的更改可能不适用于状态筛选器规则。

Set-CMTaskSequence

弃用

已弃用 UseDefaultText 参数。 若要使用默认文本，请将 CustomText 设置为 $null。

Set-CMWindowsEnrollmentProfile

已修复的 Bug

颁发机构 参数并非在所有参数集中都可用。