1906版的 Configuration Manager Cmdlet 程式庫變更Configuration Manager Cmdlet Library changes for version 1906

適用於:Configuration Manager (最新分支)Applies to: Configuration Manager (Current Branch)

注意

Configuration Manager 最新分支1902版是這些變更的基準。Configuration Manager current branch version 1902 is the baseline for these changes. 如需詳細資訊,請參閱1902 版的 Configuration Manager Cmdlet 程式庫變更For more information, see Configuration Manager Cmdlet Library changes for version 1902.

重要變更Important changes

新的 CmdletNew cmdlets

Get-CMTSStepRunTaskSequenceGet-CMTSStepRunTaskSequence

使用此 Cmdlet 從特定工作順序取得執行工作順序步驟。Use this cmdlet to get the Run Task Sequence step from a specific task sequence.

$myStep = $ReferenceTaskSequence | Get-CMTSStepRunTaskSequence -StepName $name1

新增-CMSoftwareCenterTabItemNew-CMSoftwareCenterTabItem

使用此 Cmdlet 來建立自訂的軟體中心索引標籤。Use this cmdlet to create a custom Software Center tab.

$itemA = New-CMSoftwareCenterTabItem -Name "1abc" -Url http://www.a

New-CMTSStepRunTaskSequenceNew-CMTSStepRunTaskSequence

使用此 Cmdlet 來建立工作順序步驟執行工作順序Use this cmdlet to create the task sequence step Run Task Sequence.

$myStep = New-CMTSStepRunTaskSequence - Name $name1 -RunTaskSequence $refSubTaskSequence

Remove-CMTSStepRunTaskSequenceRemove-CMTSStepRunTaskSequence

使用 Cmdlet 從特定工作順序移除工作順序步驟執行工作順序Use cmdlet to remove the task sequence step Run Task Sequence from a specific task sequence.

$ReferenceTaskSequence | Remove-CMTSStepRunTaskSequence -StepName $myStep.Name -Force

設定-CMScriptSet-CMScript

使用此 Cmdlet 來編輯腳本。Use this cmdlet to edit a script.

Get-CMScript -ScriptName $name | Set-CMScript -ScriptFile $file

Set-CMTSStepRunTaskSequenceSet-CMTSStepRunTaskSequence

使用此 Cmdlet 來編輯工作順序步驟執行工作順序Use this cmdlet to edit the task sequence step Run Task Sequence.

$ReferenceTaskSequence | Set-CMTSStepRunTaskSequence -RunTaskSequence $refSubTaskSequence

已移除 CmdletRemoved cmdlets

NoneNone

已淘汰的 CmdletDeprecated cmdlets

  • CMAadConditionalAccessPolicyGet-CMAadConditionalAccessPolicy
  • 設定-CMAadConditionalAccessPolicySet-CMAadConditionalAccessPolicy

已知問題Known issues

下列專案是此版本中未解決的 Cmdlet 程式庫已知問題。The following items are known issues with the Cmdlet Library that aren't resolved in this version.

匯入-CMSecurityRoleImport-CMSecurityRole

Cmdlet 可能會因尋找檔案時發生 DirectoryNotFoundException 錯誤而失敗 SecuredRoles.xsdCmdlet may fail with a DirectoryNotFoundException error locating the file SecuredRoles.xsd.

因應措施Workaround

  • 呼叫檔案 Import-Module ConfigurationManager.psd1 ,而不是邏輯路徑或模組名稱。Call Import-Module against the ConfigurationManager.psd1 file, and not the logical path or module name.

設定-CMSoftwareUpdatePointSet-CMSoftwareUpdatePoint

即使基礎 SMS 提供者物件已變更,[排程] 的變更也可能不會顯示在 Configuration Manager 主控台中。Changes to Schedule may not be shown in the Configuration Manager console even though the underlying SMS Provider object has been changed.

因應措施Workaround

  • 結束並重新啟動 Configuration Manager 主控台。Quit and relaunch the Configuration Manager console.

資源追蹤和復原(搶鮮版(Beta))Resource tracking and recovery (beta)

此版本新增了 Cmdlet 來支援追蹤 PowerShell 執行時間所使用的 SMS 提供者物件,並在不再需要這些資源時加以清除。This version adds new cmdlets to support tracking SMS Provider objects used by the PowerShell runtime, and to clean up these resources when they're no longer needed.

  • 中斷連線-CMObjectDisconnect-CMObject
  • 開始-CMObjectTrackingStart-CMObjectTracking
  • 停止-CMObjectTrackingStop-CMObjectTracking

當您執行時 Start-CMObjectTracking ,PowerShell 執行時間會追蹤 IResultObject Cmdlet 程式庫 Cmdlet 所建立的物件。When you run Start-CMObjectTracking, the PowerShell runtime tracks IResultObject objects created by Cmdlet Library cmdlets. 針對不是以手動方式清除的 Cmdlet .Dispose() ,請 Disconnect-CMObject 針對個別物件使用來回收它們。For cmdlets that aren't manually cleaned up with .Dispose(), reclaim them by using Disconnect-CMObject against an individual object.

範例Example

# Reclaim a single tracked object
$o | Disconnect-CMObject

# Reclaim all tracked objects
Disconnect-CMObject -All

一旦回收物件之後,就無法再重複使用它,或透過物件管線將它傳遞給另一個 Cmdlet。Once an object is reclaimed, it can no longer be reused or passed to another cmdlet through the object pipeline.

Stop-CMObjectTracking可以用來關閉物件追蹤。Stop-CMObjectTracking can be used to turn off object tracking. 先前配置的物件會維持使用中狀態。Previously allocated objects remain active.

取消認領資源可能會導致 SMS 提供者引發配額違規錯誤。Unclaimed resources can cause the SMS Provider to raise quota violation errors. 這些配額問題通常是使用大量 SMS 提供者物件或長時間執行的環境中的資訊清單。These quota issues typically manifest from working with large sets of SMS Provider objects or in long-running environments.

注意

這項功能是實驗性的,可能會在未來的版本中有所變更或移除。This feature is experimental and may be subject to change or removal in a future release. 它是選擇性的,而且預設不會啟用。It's opt-in and isn't enabled by default.

Cmdlet 變更Cmdlet changes

已對此版本中的現有 Cmdlet 進行下列變更。The following changes have been made to existing cmdlets in this version. 變更可能是新功能、bug 修正或淘汰。Changes may be new functionality, bug fixes, or deprecation. 某些變更可能會中斷。Some changes may be breaking. 如果您使用本節所列的其中一個 Cmdlet 或功能區域,請仔細檢查變更,以瞭解它們可能影響您的使用方式。If you use one of the cmdlets or feature areas listed in this section, carefully review the changes to understand how they may affect your use.

新增-CMComplianceSettingScriptAdd-CMComplianceSettingScript

已修正的 bugBugs that were fixed

  • 缺少支援補救的選項。Missing options to support remediate.

非中斷性變更Non-breaking changes

  • 已新增參數以支援補救:-RemediateAdded parameter to support remediate: -Remediate
範例Example
Add-CMComplianceSettingScript -InputObject $ci -DiscoveryScriptLanguage PowerShell -DataType String -Name "test1" -DiscoveryScriptText "test" -RemediationScriptLanguage PowerShell -RemediationScriptText "test"  -RuleName rule1 -ExpressionOperator IsEquals -ValueRule -ExpectedValue 1.0 -Remediate

新增-CMDeviceCollectionDirectMembershipRuleAdd-CMDeviceCollectionDirectMembershipRule

已修正的 bugBugs that were fixed

  • 當您嘗試套用數百個直接規則時,Cmdlet 會失敗。Cmdlet failed when you tried to apply hundreds of direct rules.

非中斷性變更Non-breaking changes

  • 將來自不同類別的查詢分隔,以改善效能。Separated the queries from different classes to improve the performance.

新增-CMMsiDeploymentTypeAdd-CMMsiDeploymentType

已修正的 bugBugs that were fixed

  • 當 Cmdlet 變更登入需求設定時,此行為與主控台不一致。The behavior wasn't consistent with the console when the cmdlet changes the logon requirement settings.
  • 缺少應用程式屬性。Missing application properties.
  • -LogonRequirementType當指定時,您可以為和指定錯誤的值 -RequireUserInteraction``-InstallationBehaviorType InstallForSystemIfResourceIsDeviceOtherwiseInstallForUserYou may specify wrong value for -LogonRequirementType and -RequireUserInteraction when they specify -InstallationBehaviorType InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser

非中斷性變更Non-breaking changes

  • 已修改「使用者經驗」設定的驗證邏輯:只有在您將 [使用者登入] 指定為登入需求時,才會封鎖「使用者互動」。Modified the validation logic for the "User Experience" settings: the "User Interaction" would be blocked only when you specified "no user logon" as the logon requirement.
  • 已新增應用程式屬性: CategoryInstance_UniqueIDsFeaturedAdded application properties: CategoryInstance_UniqueIDs and Featured
  • 已新增組合邏輯,以解決 -LogonRequirementType 、和中的問題 -RequireUserInteraction``-InstallationBehaviorTypeAdded combination logic to address issues in -LogonRequirementType, -RequireUserInteraction, and -InstallationBehaviorType

Add-CMScriptDeploymentTypeAdd-CMScriptDeploymentType

已修正的 bugBugs that were fixed

  • 將 null 值指定為時失敗 -AddRequirementFailed when specify null value to -AddRequirement.
  • 缺少應用程式屬性。Missing application properties.

非中斷性變更Non-breaking changes

  • 已新增 null 值的參數驗證。Added parameter validation for null value.
  • 已新增應用程式屬性: CategoryInstance_UniqueIDsFeaturedAdded application properties: CategoryInstance_UniqueIDs and Featured

新增-CMUserCollectionDirectMembershipRuleAdd-CMUserCollectionDirectMembershipRule

已修正的 bugBugs that were fixed

  • 當您嘗試套用數百個直接規則時,Cmdlet 會失敗。Cmdlet failed when you tried to apply hundreds of direct rules.

非中斷性變更Non-breaking changes

  • 將來自不同類別的查詢分隔,以改善效能。Separated the queries from different classes to improve the performance.

匯入-CMDriverImport-CMDriver

已修正的 bugBugs that were fixed

  • Cmdlet 無法正常運作。Cmdlet doesn't work correctly.

非中斷性變更Non-breaking changes

  • 已修正未處理的例外狀況問題。Fixed unhandled exception issue.
  • 已修正與主控台一致的來源路徑問題。Fixed source path issue to align with console.

匯入-CMDriverPackageImport-CMDriverPackage

已修正的 bugBugs that were fixed

  • -ImportActionType參數會針對所有物件設定相同的匯入動作。The -ImportActionType parameter would set same import action for all objects.

非中斷性變更Non-breaking changes

  • Cmdlet 會使用預設動作來匯入物件(如果您未指定的話)。Cmdlet would import object by using default action if you didn't specify one.
  • 已新增參數,以支援針對不同的物件類別指定匯入動作類型:-ImportActionTypeSpecAdded new parameter to support specifying import action type for different classes of object: -ImportActionTypeSpec
範例Example
# Specify import action type for different classes of object:
$classVsAction = @{"SMS_Driver" = [Microsoft.ConfigurationManagement.AdminConsole.MigrationAssistant.ImportActionType]::AppendDriverCategories}
Import-CMDriverPackage -ImportFilePath $filePath -ImportActionTypeSpec $classVsAction

匯入-CMTaskSequenceImport-CMTaskSequence

已修正的 bugBugs that were fixed

  • -ImportActionType參數會針對所有物件設定相同的匯入動作。The -ImportActionType parameter would set same import action for all objects.

非中斷性變更Non-breaking changes

  • Cmdlet 會使用預設動作來匯入物件(如果未指定的話)。Cmdlet would import object by using default action if didn't specify one.
  • 已新增參數,以支援針對不同的物件類別指定匯入動作類型:-ImportActionTypeSpecAdded new parameter to support specifying import action type for different classes of object: -ImportActionTypeSpec

叫用-CMClientActionInvoke-CMClientAction

已修正的 bugBugs that were fixed

  • -DeviceName如果您沒有「所有系統」集合的許可權,則使用參數、或的 Cmdlet -DeviceId -Device 會失敗。Cmdlet with parameter -DeviceName, -DeviceId, or -Device would fail if you don't have permission to "All Systems" collection.
  • 缺少喚醒電腦的選項。Missing options to wake up machine.

非中斷性變更Non-breaking changes

  • 已移除與主控台一致的集合許可權限制。Removed the collection permission limitation to align with console.
  • 已新增參數以支援喚醒電腦:Added new parameters to support waking up machine:
    • -ParentCollectionId
    • -ParentCollectionName
    • -ParentCollection
範例Example
# Wake up machine:
Invoke-CMClientAction -DeviceName "SleepDevice01" -ActionType ClientNotificationWakeUpClientNow -ParentCollectionId $col.CollectionID

叫用-CMEndpointProtectionScanInvoke-CMEndpointProtectionScan

已修正的 bugBugs that were fixed

  • -DeviceName如果您沒有「所有系統」集合的許可權,則使用參數、或的 Cmdlet -DeviceId -Device 會失敗。Cmdlet with parameter -DeviceName, -DeviceId, or -Device would fail if you don't have permission to "All Systems" collection.

非中斷性變更Non-breaking changes

  • 已移除與主控台一致的集合許可權限制。Removed the collection permission limitation to align with console.

叫用-CMQueryInvoke-CMQuery

已修正的 bugBugs that were fixed

  • CMQuery 命令未遵循 -LimitToCollectionID 參數。Invoke-CMQuery command didn't respect the -LimitToCollectionID parameter.

非中斷性變更Non-breaking changes

  • CMquery 物件中的參數支援空值 -LimitToCollectionIDSupported empty value for parameter -LimitToCollectionID in CMquery object.

CMApplicationDeploymentGet-CMApplicationDeployment

已修正的 bugBugs that were fixed

  • Cmdlet 會意外地摧毀物件 -InputObectCmdlet would unexpectedly destroy object with -InputObect.

非中斷性變更Non-breaking changes

  • 已修正物件處置問題。Fixed the object dispose issue.

新增-Export-cmapplicationNew-CMApplication

已修正的 bugBugs that were fixed

  • 無法設定大小大於250x250 的圖示。Failed to set icon that size is greater than 250x250.

非中斷性變更Non-breaking changes

  • 將圖示大小擴充至512x512 以配合主控台。Extended the icon size to 512x512 to align with console.

新增-CMApplicationDeploymentNew-CMApplicationDeployment

已修正的 bugBugs that were fixed

  • Cmdlet 會意外地摧毀物件 -InputObectCmdlet would unexpectedly destroy object with -InputObect.

非中斷性變更Non-breaking changes

  • 已修正物件處置問題。Fixed the object dispose issue.

新增-CMApplicationDisplayInfoNew-CMApplicationDisplayInfo

已修正的 bugBugs that were fixed

  • 無法設定大小大於250x250 的圖示。Failed to set icon that size is greater than 250x250.

非中斷性變更Non-breaking changes

  • 將圖示大小擴充至512x512 以配合主控台。Extended the icon size to 512x512 to align with console.

新增-CMAutoDeploymentRuleDeploymentNew-CMAutoDeploymentRuleDeployment

已修正的 bugBugs that were fixed

  • 遺漏「允許 WUMU」和「允許使用計量網路」選項的參數。Missing parameters for "Allow WUMU" and "Allow Use Metered Network" options.
  • 遺漏 "DelayGracePeriod" 和 "SoftwareUpdatesBehaviorOfRestart" 的參數Missing parameters for "DelayGracePeriod" and "SoftwareUpdatesBehaviorOfRestart"
  • 遺漏日期時間單位輸入的驗證。Missing validation for date time units input.

非中斷性變更Non-breaking changes

  • 已新增參數以支援設定「允許 WUMU」和「允許使用計量付費網路」選項:Added new parameters to support set "Allow WUMU" and "Allow Use Metered Network" options:
    • -AllowDownloadFromMicrosoftUpdate
    • -AllowUseMeteredNetwork
  • 已新增參數以支援設定 "DelayGracePeriod" 和 "SoftwareUpdatesBehaviorOfRestart" 選項:Added new parameters to support set "DelayGracePeriod" and "SoftwareUpdatesBehaviorOfRestart" options:
    • -SoftDeadlineEnabled
    • -RequirePostRebootFullScan
  • 已針對特定單位新增可用和期限的驗證。Added validation for available and deadline with specific unit.

新增-CMBaselineNew-CMBaseline

已修正的 bugBugs that were fixed

  • 需要支援「在共同管理用戶端上套用」的選項。Need option to support "Apply on co-management client".

非中斷性變更Non-breaking changes

  • 已新增參數以支援 [在共同管理用戶端上套用] 選項:Added new parameter to support the option "Apply on co-management client":
    • -AllowComanagedClients

新增-CMBootableMediaNew-CMBootableMedia

已修正的 bugBugs that were fixed

  • 需要支援「無法包含自動播放的功能」的選項。Need option to support "Ability to not include Autorun.inf".

非中斷性變更Non-breaking changes

  • 已新增新的參數,以支援「無法包含自動執行的功能」選項:Added new parameter to support the option "Ability to not include Autorun.inf":
    • -NoAutoRun

新增-CMCaptureMediaNew-CMCaptureMedia

已修正的 bugBugs that were fixed

  • 需要支援「無法包含自動播放的功能」的選項。Need option to support "Ability to not include Autorun.inf".

非中斷性變更Non-breaking changes

  • 已新增新的參數,以支援「無法包含自動執行的功能」選項:Added new parameter to support the option "Ability to not include Autorun.inf":
    • -NoAutoRun

新增-CMPackageNew-CMPackage

已修正的 bugBugs that were fixed

  • Cmdlet 可能會在封裝資訊中設定超大的文字。Cmdlet may set oversize text in package info.

非中斷性變更Non-breaking changes

  • 已針對要與主控台對齊的字串值新增長度驗證。Added length validation for string values to align with console.

新增-CMPackageDeploymentNew-CMPackageDeployment

已修正的 bugBugs that were fixed

  • Cmdlet 失敗,因為屬性名稱錯誤。Cmdlet failed because of wrong property name.

非中斷性變更Non-breaking changes

  • 已修正屬性名稱的問題。Fixed property name issue.

新增-CMPrestageMediaNew-CMPrestageMedia

已修正的 bugBugs that were fixed

  • 需要支援「無法包含自動播放的功能」的選項。Need option to support "Ability to not include Autorun.inf".

非中斷性變更Non-breaking changes

  • 已新增新的參數,以支援「無法包含自動執行的功能」選項:Added new parameter to support the option "Ability to not include Autorun.inf":
    • -NoAutoRun

新增-CMRequirementRuleCommonValueNew-CMRequirementRuleCommonValue

已修正的 bugBugs that were fixed

  • 當您指定具有通用值的需求規則時,部署類型的評估失敗。Evaluation failed on the deployment type when you specify requirement rule with common value.

非中斷性變更Non-breaking changes

  • 已修正字串值問題,以避免在單一字串中 '/r/n '。Fixed the string value issue to prevent '/r/n' in single string.

新增-CMScheduleNew-CMSchedule

已修正的 bugBugs that were fixed

  • 遺漏 offset day 選項。Missing offset day option.

非中斷性變更Non-breaking changes

  • 已新增參數 OffsetDay 以支援 monthlybyweekday 中的位移。Added parameter OffsetDay for supporting the offset in monthlybyweekday.
範例Example
New-CMSchedule -Start (Get-Date) -DayOfWeek Monday -WeekOrder Second -RecurCount 1 -OffsetDay 0

新增-CMSoftwareUpdateAutoDeploymentRuleNew-CMSoftwareUpdateAutoDeploymentRule

已修正的 bugBugs that were fixed

  • 您無法使用此 Cmdlet 將協力廠商目錄新增至自動部署規則。You couldn't add third-party catalogs to auto deployment rule with this cmdlet.
  • 缺少 Office 365 語言選擇。Missing Office 365 language selection.
  • 遺漏篩選選項:「架構」和「內容大小」。Missing filter options: "Architecture" and "Content Size".
  • 缺少使用單位的可用和期限時間驗證。Missing validation for available and deadline time with units.
  • 無法將 $false 設定為 -EnableAfterCreateFailed to set $false to -EnableAfterCreate.
  • 語言選擇的預設值不會與主控台對齊。Default values for language selection didn't align with console.

非中斷性變更Non-breaking changes

  • 已新增協力廠商更新的廠商支援。Added vendor support for third-party updates.
  • 已新增 Office 365 語言選擇的新參數,以配合主控台:Added new parameter for Office 365 language selection to align with console:
    • -O365LanguageSelection
  • 已新增篩選選項「架構」和「內容大小」的新參數:Added new parameter for filter options "Architecture" and "Content Size":
    • -Architecture
    • -ContentSize
  • 已新增使用單位的可用和期限時間驗證。Added validation for available and deadline time with units.
  • 已修正要設定的邏輯 -EnableAfterCreateFixed the logic to set -EnableAfterCreate.
  • 已變更 [語言選擇] 的預設值以配合主控台。Changed the default values for language selection to align with console.
範例Example
# Set filter "Architecture":
$newADR = New-CMSoftwareUpdateAutoDeploymentRule -Collection $collection -DeploymentPackageName $PackageName -Name $name -Architecture X86, Itanium, X64

# Set filter "Content Size":
$newADR = New-CMSoftwareUpdateAutoDeploymentRule -Collection $collection -DeploymentPackageName $PackageName -Name $name -ContentSize $size

新增-CMSoftwareUpdateDeploymentNew-CMSoftwareUpdateDeployment

已修正的 bugBugs that were fixed

  • 遺漏 "DelayGracePeriod" 選項。Missing option for "DelayGracePeriod".

非中斷性變更Non-breaking changes

  • 已新增選項 "DelayGracePeriod" 的新參數:Added new parameter for option "DelayGracePeriod":
    • -SoftDeadlineEnabled

新增-CMStandaloneMediaNew-CMStandaloneMedia

已修正的 bugBugs that were fixed

  • 需要支援「無法包含自動播放的功能」的選項。Need option to support "Ability to not include Autorun.inf".

非中斷性變更Non-breaking changes

  • 已新增新的參數,以支援「無法包含自動執行的功能」選項:Added new parameter to support the option "Ability to not include Autorun.inf":
    • -NoAutoRun

新增-CMStatusFilterRuleNew-CMStatusFilterRule

已修正的 bugBugs that were fixed

  • -PropertyId「未攔截到例外狀況: System.object」失敗。-PropertyId failed "Exception not caught: System.ArgumentOutOfRangeException".

非中斷性變更Non-breaking changes

  • 已新增來源/PropertyID/PropertyValue 的驗證,以避免輸入無效。Added validation for Source/PropertyID/PropertyValue to avoid invalid input.

New-CMTSStepApplyNetworkSetting (英文)New-CMTSStepApplyNetworkSetting

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

新增-CMTSStepApplyWindowsSettingsNew-CMTSStepApplyWindowsSettings

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

New-CMTSStepCaptureSystemImage (英文)New-CMTSStepCaptureSystemImage

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

New-CMTSStepConnectNetworkFolder (英文)New-CMTSStepConnectNetworkFolder

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

New-CMTSStepDisableBitLocker (英文)New-CMTSStepDisableBitLocker

已修正的 bugBugs that were fixed

  • 需要設定「重新開機計數」的選項Need option to set "Reboot Count"

非中斷性變更Non-breaking changes

  • 已新增「重新開機計數」選項的新參數:Added new parameter for "Reboot Count" option:
    • -RebootCount

New-CMTSStepEnableBitLocker (英文)New-CMTSStepEnableBitLocker

已修正的 bugBugs that were fixed

  • 工作循序執行時,使用者 PIN 的工作順序步驟失敗。Task sequence step with user PIN failed when task sequence running.
  • 遺漏 [使用完整磁片加密] 選項的參數。Missing parameter for "Use full disk encryption" option.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.
  • 已新增 [使用完整磁片加密] 選項的新參數:Added new parameter for "Use full disk encryption" option:
    • -EncryptFullDisk

New-CMTSStepInstallApplication (英文)New-CMTSStepInstallApplication

已修正的 bugBugs that were fixed

  • 安裝應用程式之後,需要安裝應用程式步驟以從快取清除其內容的選項。Need option to install application step to clear its content from cache after installing the application.

非中斷性變更Non-breaking changes

  • 已新增參數,以在安裝應用程式之後清除快取中的內容:Added new parameter to clear its content from cache after installing the application:
    • -ClearCache

New-CMTSStepJoinDomainWorkgroup (英文)New-CMTSStepJoinDomainWorkgroup

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

New-CMTSStepRestoreUserState (英文)New-CMTSStepRestoreUserState

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

New-CMTSStepRunCommandLine (英文)New-CMTSStepRunCommandLine

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

New-CMTSStepRunPowerShellScript (英文)New-CMTSStepRunPowerShellScript

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

新增-CMWindowsFirewallPolicyNew-CMWindowsFirewallPolicy

已修正的 bugBugs that were fixed

  • 未設定相關的防火牆設定時,不應設定選項。Options shouldn't be configured when related firewall settings weren't set.

非中斷性變更Non-breaking changes

  • 已新增程式碼以檢查相依參數的防火牆設定。Added code to check firewall setting for dependent parameters.

移除-CMSoftwareUpdatePointRemove-CMSoftwareUpdatePoint

已修正的 bugBugs that were fixed

  • 當您執行 Cmdlet 來刪除軟體更新點之後,WCM 不會重設。WCM wasn't reset after you ran the cmdlet to delete a software update point.

非中斷性變更Non-breaking changes

  • 已新增在您刪除軟體更新點時重設 WCM 的邏輯。Added logic to reset the WCM when you delete a software update point.

設定-Export-cmapplicationSet-CMApplication

已修正的 bugBugs that were fixed

  • 無法設定大小大於250x250 的圖示。Failed to set icon that size is greater than 250x250.

非中斷性變更Non-breaking changes

  • 將圖示大小擴充至512x512 以配合主控台。Extended the icon size to 512x512 to align with console.

設定-CMAutoDeploymentRuleDeploymentSet-CMAutoDeploymentRuleDeployment

已修正的 bugBugs that were fixed

  • 遺漏「允許 WUMU」和「允許使用計量網路」選項的參數。Missing parameters for "Allow WUMU" and "Allow Use Metered Network" options.
  • 遺漏 "DelayGracePeriod" 和 "SoftwareUpdatesBehaviorOfRestart" 的參數Missing parameters for "DelayGracePeriod" and "SoftwareUpdatesBehaviorOfRestart"
  • 遺漏日期時間單位輸入的驗證。Missing validation for date time units input.

非中斷性變更Non-breaking changes

  • 已新增參數以支援設定「允許 WUMU」和「允許使用計量付費網路」選項:Added new parameters to support set "Allow WUMU" and "Allow Use Metered Network" options:
    • -AllowDownloadFromMicrosoftUpdate
    • -AllowUseMeteredNetwork
  • 已新增參數以支援設定 "DelayGracePeriod" 和 "SoftwareUpdatesBehaviorOfRestart" 選項:Added new parameters to support set "DelayGracePeriod" and "SoftwareUpdatesBehaviorOfRestart" options:
    • -SoftDeadlineEnabled
    • -RequirePostRebootFullScan
  • 已針對特定單位新增可用和期限的驗證。Added validation for available and deadline with specific unit.

設定-CMBaselineSet-CMBaseline

已修正的 bugBugs that were fixed

  • 需要支援「在共同管理用戶端上套用」的選項。Need option to support "Apply on co-management client".

非中斷性變更Non-breaking changes

  • 已新增參數以支援 [在共同管理用戶端上套用] 選項:Added new parameter to support the option "Apply on co-management client":
    • -AllowComanagedClients

設定-CMClientSettingPowerManagementSet-CMClientSettingPowerManagement

已修正的 bugBugs that were fixed

  • 遺漏 [允許網路喚醒] 選項的參數。Missing parameter for "Allow network wake-up" option.

非中斷性變更Non-breaking changes

  • 已新增參數以支援網路喚醒:Added new parameter to support network wakeup:
    • -NetworkWakeupOption
範例Example
Set-CMClientSettingPowerManagement -Name "test settings" -AllowUserToOptOutFromPowerPlan $true -EnableWakeupProxy $true -NetworkWakeupOption Enabled -WakeupProxyPort 25511 -WakeOnLanPort 10 -FirewallExceptionForWakeupProxy None

設定-CMClientSettingSoftwareCenterSet-CMClientSettingSoftwareCenter

已修正的 bugBugs that were fixed

  • 支援自訂索引標籤功能。Support custom tab feature.

非中斷性變更Non-breaking changes

  • 已新增參數以支援自訂索引標籤作業:Added new parameters to support custom tab operation:
    • -ClearCustomTab
    • -RemoveCustomTabName
    • -AddCustomTab
    • -SetVisibleTabName
    • -SetInvisibleTabName
    • -SelectCustomTabName
    • -SelectBuiltInTab
    • -SelectTabIndex
    • -MoveSelectedTabToIndex
    • -SelectedTabNewName
    • -SelectedTabNewUrl

棄用功能Deprecations

  • 已取代的參數:Deprecated Parameters:
    • -CustomTabName
    • -CustomTabUrl
範例Example
# Add custom tab instances to client setting:
$itemA = New-CMSoftwareCenterTabItem -Name "1abc" -Url "http://www.a"
$itemB = New-CMSoftwareCenterTabItem -Name "2abc" -Url "https://www.b"
$itemC = New-CMSoftwareCenterTabItem -Name "3abc" -Url "http://www.c"
$itemD = New-CMSoftwareCenterTabItem -Name "4abc" -Url "https://www.d"
$itemE = New-CMSoftwareCenterTabItem -Name "5abc" -Url "http://www.e"
Set-CMClientSettingSoftwareCenter -DefaultSetting -AddCustomTab ($itemA, $itemB, $itemC, $itemD, $itemE)

#Set custom tab to invisible by name:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SetInvisibleTabName ("2abc","4abc", "5abc")

# Remove custom tab by name:
Set-CMClientSettingSoftwareCenter -DefaultSetting -RemoveCustomTabName ("3abc","4abc")

# Set custom tab to visible by name:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SetVisibleTabName ("2abc", "5abc")

# Move selected custom tab to specific position by name:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectCustomTabName "1abc" -MoveSelectedTabToIndex 0

# Move selected built-in tab to specific position:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectBuiltInTab AvailableSoftware -MoveSelectedTabToIndex 0

# Move selected tab to specific position by current index of position:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectTabIndex 0 -MoveSelectedTabToIndex 1

# Modify custom tab's name and Url by name:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectCustomTabName "1abc" -SelectedTabNewName "new1abc" -SelectedTabNewUrl http://www.aNew

# Clean up all custom tabs from the client setting:
Set-CMClientSettingSoftwareCenter -DefaultSetting -ClearCustomTab

設定-CMComplianceRuleValueSet-CMComplianceRuleValue

已修正的 bugBugs that were fixed

  • 無法設定登錄類型規則的補救。Failed to set remediation for registry type rule.

非中斷性變更Non-breaking changes

  • 修改程式碼以支援登錄類型規則的補救。Modified the code to support remediation for registry type rule.

Set-CMDistributionPointSet-CMDistributionPoint

已修正的 bugBugs that were fixed

  • 遺失重新指派發佈點的設定。Missing setting to reassign distribution point.

非中斷性變更Non-breaking changes

  • 已新增參數:Added new parameter:
    • -ReassignSiteCode
範例Example
Set-CMDistributionPoint -SiteSystemServerName "MyDP.TestDOM.net" -ReassignSiteCode "NEW" -SiteCode "OLD"

設定-CMMsiDeploymentTypeSet-CMMsiDeploymentType

已修正的 bugBugs that were fixed

  • 當 Cmdlet 變更登入需求設定時,此行為與主控台不一致。The behavior wasn't consistent with the console when cmdlet changes the logon requirement settings.
  • 缺少應用程式屬性。Missing application properties.
  • -LogonRequirementType -RequireUserInteraction 當您指定時,您可以為和指定錯誤的值-InstallationBehaviorType InstallForSystemIfResourceIsDeviceOtherwiseInstallForUserYou may specify the wrong value for -LogonRequirementType and -RequireUserInteraction when you specify -InstallationBehaviorType InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser

非中斷性變更Non-breaking changes

  • 已修改「使用者經驗」設定的驗證邏輯:只有在您將 [使用者登入] 指定為登入需求時,才會封鎖「使用者互動」。Modified the validation logic for the "User Experience" settings: the "User Interaction" would be blocked only when you specified "no user logon" as the logon requirement.
  • 已新增應用程式屬性: ' CategoryInstance_UniqueIDs ' 和 ' 精選 'Added application properties: 'CategoryInstance_UniqueIDs' and 'Featured'
  • 已新增組合邏輯,以解決 -LogonRequirementType 、和中的問題 -RequireUserInteraction``-InstallationBehaviorTypeAdded combination logic to address issues in -LogonRequirementType, -RequireUserInteraction, and -InstallationBehaviorType

設定-CMPackageSet-CMPackage

已修正的 bugBugs that were fixed

  • Cmdlet 可能會在封裝資訊中設定超大的文字。Cmdlet may set oversize text in package info.

非中斷性變更Non-breaking changes

  • 已針對要與主控台對齊的字串值新增長度驗證。Added length validation for string values to align with console.

Set-CMScriptDeploymentTypeSet-CMScriptDeploymentType

已修正的 bugBugs that were fixed

  • 將 null 值指定為時失敗 -AddRequirementFailed when specify null value to -AddRequirement.
  • 缺少應用程式屬性。Missing application properties.

非中斷性變更Non-breaking changes

  • 已新增 null 值的參數驗證。Added parameter validation for null value.
  • 已新增應用程式屬性: ' CategoryInstance_UniqueIDs ' 和 ' 精選 'Added application properties: 'CategoryInstance_UniqueIDs' and 'Featured'

設定-CMSoftwareUpdateAutoDeploymentRuleSet-CMSoftwareUpdateAutoDeploymentRule

已修正的 bugBugs that were fixed

  • 您無法使用這個 Cmdlet,將協力廠商目錄新增至自動部署規則。You couldn't add third-party catalogs to auto deployment rule by using this cmdlet.
  • 缺少 Office 365 語言選擇。Missing Office 365 language selection.
  • 遺漏篩選選項:「架構」和「內容大小」。Missing filter options: "Architecture" and "Content Size".
  • 缺少使用單位的可用和期限時間驗證。Missing validation for available and deadline time with units.
  • 無法將 $false 設定為-EnableAfterCreateFailed to set $false to -EnableAfterCreate

非中斷性變更Non-breaking changes

  • 已新增協力廠商更新的廠商支援。Added vendor support for the third-party updates.
  • 已新增 Office 365 語言選擇的新參數,以配合主控台:Added new parameter for Office 365 language selection to align with console:
    • -O365LanguageSelection
  • 已新增篩選選項「架構」和「內容大小」的新參數:Added new parameter for filter options "Architecture" and "Content Size":
    • -Architecture
    • -ContentSize
  • 已新增使用單位的可用和期限時間驗證。Added validation for available and deadline time with units.
  • 已修正要設定的邏輯-EnableAfterCreateFixed the logic to set -EnableAfterCreate
範例Example
# Set filter "Architecture":
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -Architecture X86, Itanium, X64 -Force  
# Set filter "Content Size":
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ ReferenceADRName  -ContentSize $size

設定-CMSoftwareUpdateDeploymentSet-CMSoftwareUpdateDeployment

已修正的 bugBugs that were fixed

  • 遺漏 "DelayGracePeriod" 選項。Missing option for "DelayGracePeriod".

非中斷性變更Non-breaking changes

  • 已新增選項 "DelayGracePeriod" 的新參數:Added new parameter for option "DelayGracePeriod":
    • -SoftDeadlineEnabled

設定-CMStatusFilterRuleSet-CMStatusFilterRule

已修正的 bugBugs that were fixed

  • -PropertyId「未攔截到例外狀況: System.object」失敗。-PropertyId failed "Exception not caught: System.ArgumentOutOfRangeException".

非中斷性變更Non-breaking changes

  • 已新增來源/PropertyID/PropertyValue 的驗證,以避免輸入無效。Added validation for Source/PropertyID/PropertyValue to avoid invalid input.

設定-CMTaskSequenceDeploymentSet-CMTaskSequenceDeployment

已修正的 bugBugs that were fixed

  • Cmdlet 會意外地摧毀物件 -InputObectCmdlet would unexpectedly destroy object with -InputObect.

非中斷性變更Non-breaking changes

  • 已修正物件處置問題。Fixed the object dispose issue.

Set-CMTSStepApplyNetworkSetting (英文)Set-CMTSStepApplyNetworkSetting

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

設定-CMTSStepApplyWindowsSettingsSet-CMTSStepApplyWindowsSettings

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

Set-CMTSStepCaptureSystemImage (英文)Set-CMTSStepCaptureSystemImage

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

Set-CMTSStepConnectNetworkFolder (英文)Set-CMTSStepConnectNetworkFolder

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

Set-CMTSStepDisableBitLocker (英文)Set-CMTSStepDisableBitLocker

已修正的 bugBugs that were fixed

  • 需要設定「重新開機計數」的選項Need option to set "Reboot Count"

非中斷性變更Non-breaking changes

  • 已新增「重新開機計數」選項的新參數:Added new parameter for "Reboot Count" option:
    • -RebootCount

Set-CMTSStepEnableBitLocker (英文)Set-CMTSStepEnableBitLocker

已修正的 bugBugs that were fixed

  • 工作循序執行時,使用者 PIN 的工作順序步驟失敗。Task sequence step with user PIN failed when task sequence running.
  • 遺漏 [使用完整磁片加密] 選項的參數。Missing parameter for "Use full disk encryption" option.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.
  • 已新增 [使用完整磁片加密] 選項的新參數:Added new parameter for "Use full disk encryption" option:
    • -IsEncryptFullDisk

Set-CMTSStepInstallApplication (英文)Set-CMTSStepInstallApplication

已修正的 bugBugs that were fixed

  • 安裝應用程式之後,需要安裝應用程式步驟以從快取清除其內容的選項。Need option to install application step to clear its content from cache after installing the application.

非中斷性變更Non-breaking changes

  • 已新增參數,以在安裝應用程式之後清除快取中的內容:Added new parameter to clear its content from cache after installing the application:
    • -ClearCache

Set-CMTSStepJoinDomainWorkgroup (英文)Set-CMTSStepJoinDomainWorkgroup

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

Set-CMTSStepRestoreUserState (英文)Set-CMTSStepRestoreUserState

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

Set-CMTSStepRunCommandLine (英文)Set-CMTSStepRunCommandLine

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

Set-CMTSStepRunPowerShellScript (英文)Set-CMTSStepRunPowerShellScript

已修正的 bugBugs that were fixed

  • 工作循序執行時,具有使用者認證屬性的工作順序步驟無法登入。Task sequence step with user credential property failed to sign in when task sequence running.

非中斷性變更Non-breaking changes

  • 已修正安全性物件問題。Fixed security object issue.

設定-CMWindowsFirewallPolicySet-CMWindowsFirewallPolicy

已修正的 bugBugs that were fixed

  • 未設定相關的防火牆設定時,不應設定選項。Options shouldn't be configured when related firewall settings weren't set.

非中斷性變更Non-breaking changes

  • 已新增程式碼以檢查相依參數的防火牆設定。Added code to check firewall setting for dependent parameters.

開始-CMPackageDeploymentStart-CMPackageDeployment

已修正的 bugBugs that were fixed

  • Cmdlet 失敗,因為屬性名稱錯誤。Cmdlet failed because of wrong property name.

非中斷性變更Non-breaking changes

  • 已修正屬性名稱的問題。Fixed property name issue.

如何提供意見反應或報告問題How to provide feedback or report issues

本文所述的許多修正和改進都是您的意見反應的結果。Many of the fixes and improvements described in this article are a result of your feedback.

若要提交 bug 報告,請使用[Configuration Manager 主控台中的 傳送笑臉]。To submit bug reports, use send a smile in the Configuration Manager console. 針對新的功能要求,請使用UserVoiceFor new feature requests, use UserVoice.