2010 版的 設定管理員 Cmdlet 程式庫變更

適用於：設定管理員 (目前的分支)

這些版本資訊摘要說明 2010 版中對 設定管理員 Cmdlet 程式庫所做的變更。

從 2010 版開始，設定管理員 PowerShell Cmdlet 程式庫現在提供 PowerShell 7 的支援。 如需詳細資訊，請參閱 PowerShell 第 7 版的支援。

注意事項

設定管理員 目前分支 2002 版是這些變更的基準。 如需詳細資訊，請參閱 2006 版的 設定管理員 Cmdlet 程式庫變更。

雲端管理閘道

隨著管理遠端裝置的客戶越來越多，此版本包含數個適用於雲端管理閘道 (CMG) 的全新和改良的 Windows PowerShell Cmdlet。 您可以使用這些 Cmdlet 來自動化 CMG 服務的建立、設定和管理，並Azure Active Directory (Azure AD) 需求。

注意事項

雖然某些新的 Cmdlet 可能會與其他 Azure 服務一起使用，但它們只會使用雲端管理連線進行測試，以支援 CMG。

例如，Azure系統管理員會先在 Active Directory (Azure AD) 中建立兩個必要的應用程式Azure。 然後，編寫使用下列 Cmdlet 部署 CMG 的指令碼：

  1. Import-CMAADServerApplication：在 設定管理員 中建立 Azure AD 伺服器應用程式定義。
  2. Import-CMAADClientApplication：在 設定管理員 中建立 Azure AD 用戶端應用程式定義。
  3. 使用 Get-CMAADApplication 取得應用程式物件，然後傳遞給 New-CMCloudManagementAzureService 以在 設定管理員 中建立 Azure 服務連線。
  4. New-CMCloudManagementGateway：在 Azure 中建立 CMG 服務。
  5. Add-CMCloudManagementGatewayConnectionPoint：建立 CMG 連接點網站系統。

適用於 CMG 的新 Cmdlet

已更新 CMG 的 Cmdlet

下列現有的 Cmdlet 有重大改良。 如需詳細資訊，請參閱下列版本資訊：

適用於 CMG 的現有 Cmdlet

您可以繼續使用下列現有的 CMG Cmdlet：

新的 Cmdlet

應用程式管理

集合管理

Windows 10 版本升級

Microsoft Edge 瀏覽器設定檔

商務用 OneDrive 設定檔

已淘汰和移除的 Cmdlet

以下用於 設定管理員 混合式環境的 Cmdlet 已不再可用：

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

如需詳細資訊，請參閱 混合式 MDM 發生了什麼問題？

已取代下列 Cmdlet：

已知問題

無

Cmdlet 變更

我們已對此版本中的現有 Cmdlet 進行下列變更。 變更可能是新功能、錯誤修正或取代。 有些變更可能會破壞性。 如果您使用本節所列的其中一個 Cmdlet 或功能區域，請仔細檢閱變更，以了解它們如何影響您的使用。

Add-CMComplianceSettingRegistryKeyValue

如需詳細資訊，請參閱 Add-CMComplianceSettingRegistryKeyValue。

非中斷性變更

參數 ExpectedValue 可以接受空白值。

Add-CMDistributionPoint

如需詳細資訊，請參閱 Add-CMDistributionPoint。

已修正的錯誤

已修正發佈點建立的問題。

Add-CMDeviceCollectionDirectMembershipRule

如需詳細資訊，請參閱 Add-CMDeviceCollectionDirectMembershipRule。

已修正的錯誤

修正重複裝置號碼檢查的問題。

Add-CMManagementPoint

如需詳細資訊，請參閱 Add-CMManagementPoint。

已修正的錯誤

已修正雲端管理閘道支援的問題。

Add-CMPassiveSite

如需詳細資訊，請參閱 Add-CMPassiveSite。

已修正的錯誤

已修正階層中被動網站的問題。

Add-CMTaskSequenceStep

如需詳細資訊，請參閱 Add-CMTaskSequenceStep。

已修正的錯誤

修正使用包含大型指令碼的多個 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。

已修正的錯誤

已修正參數 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。

已修正的錯誤

已修正參數 集合的管線問題。

範例：

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

Invoke-CMConvertPackage

如需詳細資訊，請參閱 Invoke-CMConvertPackage。

中斷性變更

已移除 Package 參數。 管道傳遞套件物件，或使用 InputObject 參數。

非中斷性變更

已新增管線支援和 InputObject 參數。

範例：

$pkg | Invoke-CMConvertPackage

Invoke-CMReport

如需詳細資訊，請參閱 Invoke-CMReport。

已修正的錯誤

已修正參數 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。

已修正的錯誤

已修正建立新原則設定執行個體時的問題。

New-CMBoundary

如需詳細資訊，請參閱 New-CMBoundary。

非中斷性變更

在 BoundaryType 參數中新增 VPN 選項。

New-CMBootableMedia

如需詳細資訊，請參閱 New-CMBootableMedia。

非中斷性變更

新增參數 SiteCode。

New-CMCloudManagementGateway

如需詳細資訊，請參閱 New-CMCloudManagementGateway。

非中斷性變更

下列參數是新的：

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

更新下列參數：

  • CheckClientCertRevocation
  • EnvironmentSetting
  • 區域
  • SubscriptionId
  • TrafficCriticalPct
  • TrafficWarningPct

中斷性變更

會從此 Cmdlet 移除下列參數：

  • 政府訂閱
  • 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 type。

New-CMDetectionClauseDirectory

如需詳細資訊，請參閱 New-CMDetectionClauseDirectory。

中斷性變更

將參數 ExpressionOperator 的類型從 RuleExpressionOperator 變更為 FileFolderRuleExpressionOperator 類型。

New-CMDetectionClauseFile

如需詳細資訊，請參閱 New-CMDetectionClauseFile。

中斷性變更

將參數 ExpressionOperator 的類型從 RuleExpressionOperator 變更為 FileFolderRuleExpressionOperator 類型。

New-CMDetectionClauseMacBundle

如需詳細資訊，請參閱 New-CMDetectionClauseMacBundle。

中斷性變更

將參數 ExpressionOperator 的類型從 RuleExpressionOperator 變更為 MacRuleExpressionOperator 類型。

已修正的錯誤

已修正參數 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。

已修正的錯誤

已修正參數 DriverModel 的問題。

New-CM*PhasedDeployment

如需詳細資訊，請參閱下列文章：

已修正的錯誤

已修正參數 WhatIf 的問題。

非中斷性變更

新增重複階段名稱的驗證。

New-CMPrestageMedia

如需詳細資訊，請參閱 New-CMPrestageMedia。

非中斷性變更

新增參數 SiteCode。

New-CMProgram

如需詳細資訊，請參閱 New-CMProgram。

中斷性變更

將類型 RenameWithUnc 重新命名為 RunWithUnc 參數 DriveMode。

New-CMSoftwareUpdateDeployment

如需詳細資訊，請參閱 New-CMSoftwareUpdateDeployment。

非中斷性變更

針對未下載的軟體更新新增了新參數 DeployWithNoPackage 。

New-CMStandaloneMedia

如需詳細資訊，請參閱 New-CMStandaloneMedia。

已修正的錯誤

已修正參數 PrestartPackage 的問題

New-CMTaskSequence

如需詳細資訊，請參閱 New-CMTaskSequence。

已修正的錯誤

修正當您使用包含大型指令碼的多個 PowerShell 步驟時的原則大小問題。

New-CMTaskSequenceDeployment

如需詳細資訊，請參閱 New-CMTaskSequenceDeployment。

已修正的錯誤

已修正參數 AllowFallback 的問題。

非中斷性變更

新增了參數排 程 的驗證，以避免現有指派中的值重複。

New-CMTaskSequenceMedia

如需詳細資訊，請參閱 New-CMTaskSequenceMedia。

非中斷性變更

將媒體建立逾時從一天變更為三天。

New-CMTSPartitionSetting

如需詳細資訊，請參閱 New-CMTSPartitionSetting。

已修正的錯誤

已修正參數 EnableQuickFormat 的問題。

New-CMTSStepEnableBitLocker

如需詳細資訊，請參閱 New-CMTSStepEnableBitLocker。

已修正的錯誤

已修正使用者指定加密方法的問題。

New-CMTSStepOfflineEnableBitLocker

如需詳細資訊，請參閱 New-CMTSStepOfflineEnableBitLocker。

已修正的錯誤

已修正使用者指定加密方法的問題。

New-CMTSStepPreStartCheck

如需詳細資訊，請參閱 New-CMTSStepPreStartCheck。

已修正的錯誤

已修正新檢查整備步驟的問題。

已修正參數 OSLanguageId 的問題。

非中斷性變更

為 UEFI 檢查新增新參數 CheckUefi。

Remove-CMTaskSequenceGroup

如需詳細資訊，請參閱 Remove-CMTaskSequenceGroup。

已修正的錯誤

修正當您使用包含大型指令碼的多個 PowerShell 步驟時的原則大小問題。

Set-CM*PhasedDeployment

如需詳細資訊，請參閱下列文章：

已修正的錯誤

已修正參數 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。

已修正的錯誤

已修正參數 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。

已修正的錯誤

已修正參數 DriverModel 的問題。

Set-CMManagementPoint

如需詳細資訊，請參閱 Set-CMManagementPoint。

已修正的錯誤

已修正雲端管理閘道支援的問題。

Set-CMProgram

如需詳細資訊，請參閱 Set-CMProgram。

中斷性變更

將類型 RenameWithUnc 重新命名為 RunWithUnc 參數 DriveMode。

Set-CMSiteMaintenanceTask

如需詳細資訊，請參閱 Set-CMSiteMaintenanceTask。

非中斷性變更

新增下列新參數，用於為具有遠端簡訊提供者的環境設定 網站備份目的地 和 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。

已修正的錯誤

修正來自 Get-CMSoftwareUpdateAutoDeploymentRule 的輸入物件與 快速 選項的問題。

Set-CMSoftwareUpdateDeploymentPackage

如需詳細資訊，請參閱 Set-CMSoftwareUpdateDeploymentPackage。

已修正的錯誤

已修正參數 RemoveExpired 與 RemoveSuperceded 的問題。

Set-CMSoftwareUpdateGroup

如需詳細資訊，請參閱 Set-CMSoftwareUpdateGroup。

已修正的錯誤

修正新增未下載軟體更新的問題。

Set-CMStatusFilterRule

如需詳細資訊，請參閱 Set-CMStatusFilterRule。

已修正的錯誤

已修正 Name 參數的問題，以確保它與 Get-CMStatusFilterRule 包含。

Set-CMTaskSequenceDeployment

如需詳細資訊，請參閱 Set-CMTaskSequenceDeployment。

已修正的錯誤

已修正參數 ScheduleEvent 的問題。

已修正參數 AllowFallback 的問題。

非中斷性變更

新增了參數排 程 的驗證，以避免現有指派中的值重複。

新增了用於設定排程的新參數：

  • ClearSchedule
  • RemoveSchedule
  • AddSchedule

新增了設定 ScheduleEvent 的新參數：

  • ClearScheduleEvent
  • RemoveScheduleEvent
  • AddScheduleEvent

範例：

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

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddScheduleEvent LogOn, LogOff

Set-CMTSStep*

已修正的錯誤

修正當您使用包含大型指令碼的多個 PowerShell 步驟時的原則大小問題。

Set-CMTSStepEnableBitLocker

如需詳細資訊，請參閱 Set-CMTSStepEnableBitLocker。

已修正的錯誤

已修正使用者指定加密方法的問題。

Set-CMTSStepOfflineEnableBitLocker

如需詳細資訊，請參閱 Set-CMTSStepOfflineEnableBitLocker。

已修正的錯誤

已修正使用者指定加密方法的問題。

Set-CMTSStepPreStartCheck

如需詳細資訊，請參閱 Set-CMTSStepPreStartCheck。

非中斷性變更

新增了 UEFI check：， CheckUefi 的新參數。

Set-CMWindowsAppxDeploymentType

如需詳細資訊，請參閱 Set-CMWindowsAppxDeploymentType。

非中斷性變更

新增支援 MSIX 的功能。

Start-CMCloudManagementGateway

如需詳細資訊，請參閱 Start-CMCloudManagementGateway。

已修正的錯誤

已修正 CMG 狀態的驗證。

Start-CMContentDistribution

如需詳細資訊，請參閱 Start-CMContentDistribution。

非中斷性變更

為參數 DeploymentPackageId 和 DeploymentPackageName 新增別名，以便更容易理解。

Stop-CMCloudManagementGateway

如需詳細資訊，請參閱 Stop-CMCloudManagementGateway。

已修正的錯誤

已修正 CMG 狀態的驗證。

如何提供意見反應或回報問題

本文所述的許多修正和改善功能都是您意見反應的結果。

若要傳送意見反應，請使用 設定管理員 主控台。 如需詳細資訊，請參閱 PowerShell 的意見反應。

  • Last updated on