版本 2010 的 Configuration Manager cmdlet 库更改

适用于: Configuration Manager(current branch)

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

从版本 2010 开始,Configuration Manager PowerShell cmdlet 库现在提供对 PowerShell 7 的支持。 有关详细信息,请参阅 对 PowerShell 版本 7 的支持

注意

Configuration Manager当前分支版本 2002 是这些更改的基线。 有关详细信息,请参阅版本 2006 Configuration Manager cmdlet 库更改

云管理网关

随着越来越多的客户现在管理远程设备,此版本包括云管理网关 (CMG) 的几个新增和改进的 Windows PowerShell cmdlet。 可以使用这些 cmdlet 自动创建、配置和管理 CMG 服务,并Azure Active Directory (Azure AD) 要求。

注意

虽然某些新 cmdlet 可能与其他Azure服务一起使用,但仅使用云管理连接对其进行测试,以支持 CMG。

例如,Azure管理员首先在 Azure Active Directory (Azure AD) 中创建两个必需的应用。 然后编写一个脚本,该脚本使用以下 cmdlet 部署 CMG:

  1. Import-CMAADServerApplication:在 Configuration Manager 中创建Azure AD 服务器应用定义。
  2. Import-CMAADClientApplication:在 Configuration Manager 中创建Azure AD 客户端应用定义。
  3. 使用 Get-CMAADApplication 获取应用对象,然后传递给 New-CMCloudManagementAzureService 以在 Configuration Manager 中创建Azure服务连接。
  4. New-CMCloudManagementGateway:在 Azure 中创建 CMG 服务。
  5. Add-CMCloudManagementGatewayConnectionPoint:创建 CMG 连接点站点系统。

适用于 CMG 的新 cmdlet

更新了 CMG 的 cmdlet

以下现有 cmdlet 进行了重大改进。 有关详细信息,请参阅以下发行说明:

CMG 的现有 cmdlet

可以继续使用以下现有 CMG cmdlet:

New cmdlet

应用管理

集合管理

Windows 10版本升级

Microsoft Edge 浏览器配置文件

OneDrive for Business配置文件

已弃用和已删除的 cmdlet

Configuration Manager混合环境的以下 cmdlet 不再可用:

  • Add-CMAndroidDeploymentType
  • Add-CMGooglePlayDeploymentType
  • Add-CMIosAppStoreDeploymentType
  • Add-CMIosDeploymentType
  • Set-CMAndroidDeploymentType
  • Set-CMGooglePlayDeploymentType
  • Set-CMIosAppStoreDeploymentType
  • Set-CMIosDeploymentType

有关详细信息,请参阅 混合 MDM 发生了什么情况?

以下 cmdlet 已弃用:

已知问题

Cmdlet 更改

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

Add-CMComplianceSettingRegistryKeyValue

有关详细信息,请参阅 Add-CMComplianceSettingRegistryKeyValue

非中断性变更

Parameter ExpectedValue 可以接受空值。

Add-CMDistributionPoint

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

已修复的 Bug

修复了分发点创建问题。

Add-CMDeviceCollectionDirectMembershipRule

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

已修复的 Bug

修复了重复设备编号检查的问题。

Add-CMManagementPoint

有关详细信息,请参阅 Add-CMManagementPoint

已修复的 Bug

修复了云管理网关支持的问题。

Add-CMPassiveSite

有关详细信息,请参阅 Add-CMPassiveSite

已修复的 Bug

修复了层次结构中被动站点的问题。

Add-CMTaskSequenceStep

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

已修复的 Bug

修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。

Add-CMWindowsAppxDeploymentType

有关详细信息,请参阅 Add-CMWindowsAppxDeploymentType

非中断性变更

添加了支持 MSIX 的函数。

Approve-CMDevice

有关详细信息,请参阅 Approve-CMDevice

非中断性变更

修复了使用 Get-CMDevice 时出现的问题。

Enable-CMSiteFeature

有关详细信息,请参阅 Enable-CMSiteFeature

非中断性变更

添加了支持云功能的新标志。

Get-CMScript

有关详细信息,请参阅 Get-CMScript

非中断性变更

添加了新的参数 ScriptGuid 以支持通过脚本 GUID 进行查询。

Get-CMSiteFeature

有关详细信息,请参阅 Get-CMSiteFeature

非中断性变更

添加了支持云功能的新标志。

Get-CMSoftwareUpdate

有关详细信息,请参阅 Get-CMSoftwareUpdate

非中断性变更

添加了新的参数 Vendor 以指定软件更新的源。

示例:

Get-CMSoftwareUpdate -Name $Update -Vendor "Microsoft​"

Get-CMStatusMessageQuery

有关详细信息,请参阅 Get-CMStatusMessageQuery

已修复的 Bug

修复了参数 ShowMessage 的问题。

Import-CMDriver

有关详细信息,请参阅 Import-CMDriver

非中断性变更

添加了新的参数 AdministrativeCategoryName ,以指定驱动程序类别的名称。

示例:

Import-CMDriver -UncFileLocation $DriverFolder -ImportFolder -ImportDuplicateDriverOption AppendCategory -AdministrativeCategory "Video drivers"

Invoke-CMAnalyzePackage

有关详细信息,请参阅 Invoke-CMAnalyzePackage

中断性变更

删除了 Package 参数。 通过管道传递包对象,或使用 InputObject 参数。

非中断性变更

添加了管道支持和 InputObject 参数。

示例:

$pkg | Invoke-CMAnalyzePackage

Invoke-CMClientAction

有关详细信息,请参阅 Invoke-CMClientAction

已修复的 Bug

修复了参数 集合的管道问题。

示例:

Get-CMCollection -Name "deviceCol1" | Invoke-CMClientAction -ActionType ClientNotificationRequestUsersPolicyNow

Invoke-CMConvertPackage

有关详细信息,请参阅 Invoke-CMConvertPackage

中断性变更

删除了 Package 参数。 通过管道传递包对象,或使用 InputObject 参数。

非中断性变更

添加了管道支持和 InputObject 参数。

示例:

$pkg | Invoke-CMConvertPackage

Invoke-CMReport

有关详细信息,请参阅 Invoke-CMReport

已修复的 Bug

修复了参数 Path 的问题。

Invoke-CMScript

有关详细信息,请参阅 Invoke-CMScript

非中断性变更

添加参数 ScriptParameter 以将参数传递给目标脚本。

示例:

$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}

Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash

New-CMBMSClientConfigureCheckIntervalPolicy

有关详细信息,请参阅 New-CMBMSClientConfigureCheckIntervalPolicy

已修复的 Bug

修复了创建新策略设置实例时出现的问题。

New-CMBoundary

有关详细信息,请参阅 New-CMBoundary

非中断性变更

在 BoundaryType 参数中添加了 VPN 选项。

New-CMBootableMedia

有关详细信息,请参阅 New-CMBootableMedia

非中断性变更

添加参数 SiteCode

New-CMCloudManagementGateway

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

非中断性变更

以下参数是新的:

  • CARootCert
  • EnableCloudDPFunction
  • EnableStorageQuota
  • EnableTrafficOut
  • EnforceProtocol
  • Force
  • GroupName
  • IsUsingExistingGroup
  • ServerAppClientID
  • ServiceCertPassword
  • ServiceCertPath
  • ServiceName
  • StorageCriticalPct
  • StorageQuotaGB
  • StorageWarningPct
  • TrafficOutStopService

以下参数已更新:

  • CheckClientCertRevocation
  • EnvironmentSetting
  • 地区
  • SubscriptionId
  • TrafficCriticalPct
  • TrafficWarningPct

中断性变更

将从此 cmdlet 中删除以下参数:

  • GovernmentSubscription
  • ManagementCertificatePassword
  • ManagementCertificatePath
  • PassThru
  • RootCertificatePath
  • ServiceCertificatePassword
  • ServiceCertificatePath
  • ServiceCName

New-CMCoManagementPolicy

有关详细信息,请参阅 New-CMCoManagementPolicy

非中断性变更

添加了多会话适用性

添加了 ARM64 适用性

New-CMComplianceRuleFileFolderDate

有关详细信息,请参阅 New-CMComplianceRuleFileFolderDate

非中断性变更

调整了 cmdlet 逻辑,以处理 参数“修改 ”和 “创建” 中的值,以与其他 cmdlet 保持一致。

New-CMComplianceRuleFileFolderSimple

有关详细信息,请参阅 New-CMComplianceRuleFileFolderSimple

中断性变更

将参数 PropertyType 的类型从 FileFolderProperty 更改为 SimpleFileFolderProperty 类型。

New-CMDetectionClauseDirectory

有关详细信息,请参阅 New-CMDetectionClauseDirectory

中断性变更

将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 FileFolderRuleExpressionOperator 类型。

New-CMDetectionClauseFile

有关详细信息,请参阅 New-CMDetectionClauseFile

中断性变更

将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 FileFolderRuleExpressionOperator 类型。

New-CMDetectionClauseMacBundle

有关详细信息,请参阅 New-CMDetectionClauseMacBundle

中断性变更

将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 MacRuleExpressionOperator 类型。

已修复的 Bug

修复了参数 PropertyType 的问题。

New-CMDetectionClauseMacPackage

有关详细信息,请参阅 New-CMDetectionClauseMacPackage

中断性变更

将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 MacRuleExpressionOperator 类型。

New-CMDetectionClauseRegistryKeyValue

有关详细信息,请参阅 New-CMDetectionClauseRegistryKeyValue

中断性变更

将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 RegistryValueRuleExpressionOperator 类型。

New-CMDetectionClauseWindowsInstaller

有关详细信息,请参阅 New-CMDetectionClauseWindowsInstaller

中断性变更

将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 WindowsInstallerRuleExpressionOperator 类型。

New-CMDriverPackage

有关详细信息,请参阅 New-CMDriverPackage

已修复的 Bug

修复了参数 DriverModel 的问题。

New-CM*PhasedDeployment

有关详细信息,请参阅以下文章:

已修复的 Bug

修复了参数 WhatIf 的问题

非中断性变更

添加了对重复阶段名称的验证。

New-CMPrestageMedia

有关详细信息,请参阅 New-CMPrestageMedia

非中断性变更

添加参数 SiteCode

New-CMProgram

有关详细信息,请参阅 New-CMProgram

中断性变更

已将参数 DriveMode 的类型RenameWithUncRunWithUnc重命名为 。

New-CMSoftwareUpdateDeployment

有关详细信息,请参阅 New-CMSoftwareUpdateDeployment

非中断性变更

为未下载的软件更新添加了新参数 DeployWithNoPackage

New-CMStandaloneMedia

有关详细信息,请参阅 New-CMStandaloneMedia

已修复的 Bug

修复了参数 PrestartPackage 的问题

New-CMTaskSequence

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

已修复的 Bug

修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。

New-CMTaskSequenceDeployment

有关详细信息,请参阅 New-CMTaskSequenceDeployment

已修复的 Bug

修复了参数 AllowFallback 的问题。

非中断性变更

添加了对参数 Schedule 的验证,以避免现有赋值重复。

New-CMTaskSequenceMedia

有关详细信息,请参阅 New-CMTaskSequenceMedia

非中断性变更

将媒体创建中的超时时间从一天更改为三天。

New-CMTSPartitionSetting

有关详细信息,请参阅 New-CMTSPartitionSetting

已修复的 Bug

修复了参数 EnableQuickFormat 的问题。

New-CMTSStepEnableBitLocker

有关详细信息,请参阅 New-CMTSStepEnableBitLocker

已修复的 Bug

修复了用户指定的加密方法的问题。

New-CMTSStepOfflineEnableBitLocker

有关详细信息,请参阅 New-CMTSStepOfflineEnableBitLocker

已修复的 Bug

修复了用户指定的加密方法的问题。

New-CMTSStepPreStartCheck

有关详细信息,请参阅 New-CMTSStepPreStartCheck

已修复的 Bug

修复了新检查就绪步骤的问题。

修复了参数 OSLanguageId 的问题。

非中断性变更

为 UEFI 检查 CheckUefi 添加新参数。

Remove-CMTaskSequenceGroup

有关详细信息,请参阅 Remove-CMTaskSequenceGroup

已修复的 Bug

修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。

Set-CM*PhasedDeployment

有关详细信息,请参阅以下文章:

已修复的 Bug

修复了参数 WhatIf 的问题

Set-CMBoundary

有关详细信息,请参阅 Set-CMBoundary

非中断性变更

BoundaryType 中添加VPN了选项。

Set-CMClientSettingComputerRestart

有关详细信息,请参阅 Set-CMClientSettingComputerRestart

非中断性变更

添加了一个新参数 NoRebootEnforcement

Set-CMClientSettingSoftwareUpdate

有关详细信息,请参阅 Set-CMClientSettingSoftwareUpdate

非中断性变更

添加了参数:

  • EnableInstallation
  • ThreadPriority
  • EnableDynamicUpdate

示例:

Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true

Set-CMCloudManagementGateway

有关详细信息,请参阅 Set-CMCloudManagementGateway

非中断性变更

以下参数是新的:

  • CARootCert
  • EnableCloudDPFunction
  • EnableStorageQuota
  • EnableTrafficOut
  • EnforceProtocol
  • RemoveCertThumbprints
  • StorageCriticalPct
  • StorageQuotaGB
  • StorageWarningPct
  • TrafficOutStopService
  • VMInstanceCount

中断性变更

将从此 cmdlet 中删除以下参数:

  • VMInstancesCount

Set-CMDiscoveryMethod

有关详细信息,请参阅 Set-CMDiscoveryMethod

已修复的 Bug

修复了参数 AddGroupDiscoveryScope 的问题。

Set-CMDistributionPoint

有关详细信息,请参阅 Set-CMDistributionPoint

非中断性变更

添加了支持Microsoft连接缓存的参数:

  • EnableDoinc
  • DiskSpaceUnit
  • DiskSpaceDoinc
  • LocalDriveDoinc
  • RetainDoincCache
  • AgreeDoincLicense

示例:

$dp | Set-CMDistributionPoint -EnableDoinc $true -AgreeDoincLicense $true

$dp | Set-CMDistributionPoint -RetainDoincCache $true -EnableDoinc $true -AgreeDoincLicense $true

$dp | Set-CMDistributionPoint -LocalDriveDoinc "Z:" -DiskSpaceDoinc 9000 -DiskSpaceUnit GB

Set-CMDriverPackage

有关详细信息,请参阅 Set-CMDriverPackage

已修复的 Bug

修复了参数 DriverModel 的问题。

Set-CMManagementPoint

有关详细信息,请参阅 Set-CMManagementPoint

已修复的 Bug

修复了云管理网关支持的问题。

Set-CMProgram

有关详细信息,请参阅 Set-CMProgram

中断性变更

已将参数 DriveMode 的类型RenameWithUncRunWithUnc重命名为 。

Set-CMSiteMaintenanceTask

有关详细信息,请参阅 Set-CMSiteMaintenanceTask

非中断性变更

添加了以下新参数,用于为具有远程 SMS 提供程序的环境配置站点备份目标和 SQL 备份目标

  • SiteBackupPath
  • SqlBackupPath

示例:

Set-CMSiteMaintenanceTask -Name $TaskName  -SiteBackupPath "c:\site-backup" -SqlBackupPath "c:\sql-backup" -BeginTime (Get-Date) -DaysOfWeek Sunday,Monday -EnableAlert $true -Enabled $true

Set-CMSoftwareUpdateAutoDeploymentRule

有关详细信息,请参阅 Set-CMSoftwareUpdateAutoDeploymentRule

已修复的 Bug

修复了 Get-CMSoftwareUpdateAutoDeploymentRule 中具有 Fast 选项的输入对象的问题。

Set-CMSoftwareUpdateDeploymentPackage

有关详细信息,请参阅 Set-CMSoftwareUpdateDeploymentPackage

已修复的 Bug

修复了参数 RemoveExpiredRemoveSuperceded 的问题

Set-CMSoftwareUpdateGroup

有关详细信息,请参阅 Set-CMSoftwareUpdateGroup

已修复的 Bug

修复了添加未下载的软件更新的问题。

Set-CMStatusFilterRule

有关详细信息,请参阅 Set-CMStatusFilterRule

已修复的 Bug

修复了 Name 参数的问题,以确保它包含 Get-CMStatusFilterRule

Set-CMTaskSequenceDeployment

有关详细信息,请参阅 Set-CMTaskSequenceDeployment

已修复的 Bug

修复了参数 ScheduleEvent 的问题。

修复了参数 AllowFallback 的问题。

非中断性变更

添加了对参数 Schedule 的验证,以避免现有赋值重复。

添加了用于配置计划的新参数:

  • ClearSchedule
  • RemoveSchedule
  • AddSchedule

添加了用于配置 ScheduleEvent 的新参数:

  • ClearScheduleEvent
  • RemoveScheduleEvent
  • AddScheduleEvent

示例:

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddSchedule $schedule1, $schedule2

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddScheduleEvent LogOn, LogOff

Set-CMTSStep*

已修复的 Bug

修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。

Set-CMTSStepEnableBitLocker

有关详细信息,请参阅 Set-CMTSStepEnableBitLocker

已修复的 Bug

修复了用户指定的加密方法的问题。

Set-CMTSStepOfflineEnableBitLocker

有关详细信息,请参阅 Set-CMTSStepOfflineEnableBitLocker

已修复的 Bug

修复了用户指定的加密方法的问题。

Set-CMTSStepPreStartCheck

有关详细信息,请参阅 Set-CMTSStepPreStartCheck

非中断性变更

为 UEFI 添加了一个新参数检查:, CheckUefi

Set-CMWindowsAppxDeploymentType

有关详细信息,请参阅 Set-CMWindowsAppxDeploymentType

非中断性变更

添加了支持 MSIX 的函数。

Start-CMCloudManagementGateway

有关详细信息,请参阅 Start-CMCloudManagementGateway

已修复的 Bug

更正了 CMG 状态的验证。

Start-CMContentDistribution

有关详细信息,请参阅 Start-CMContentDistribution

非中断性变更

添加了参数 DeploymentPackageIdDeploymentPackageName 的别名,以便更好地了解。

Stop-CMCloudManagementGateway

有关详细信息,请参阅 Stop-CMCloudManagementGateway

已修复的 Bug

更正了 CMG 状态的验证。

如何提供反馈或报告问题

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

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