Configuration Manager 2002 版的 Cmdlet 程式庫變更

  • 發行項

適用於：Configuration Manager (目前的分支)

注意

Configuration Manager最新分支版本 1910 是這些變更的基準。 如需詳細資訊，請參閱 Configuration Manager 1910 版的 Cmdlet 程式庫變更。

重要變更

新的 Cmdlet

New-CMSoftwareUpdatePhase

使用此 Cmdlet 建立軟體更新的部署階段。

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase"`
 -UserNotificationOption DisplaySoftwareCenterOnly

New-CMTaskSequencePhase

使用此 Cmdlet 建立工作順序的部署階段。

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

Get-CMPhase

使用此 Cmdlet 取得特定實例或階段式部署的部署階段。

Get-CMPhase -Id "66DEDF86-D0CB-457D-88BE-47E3FAC92A47"
$myPhasedDeployment | Get-CMPhase

New-CMApplicationAutoPhasedDeployment

使用此 Cmdlet，藉由產生具有相同設定的兩個階段，為應用程式建立階段式部署。

New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
 
$myApp | New-CMApplicationAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMSoftwareUpdateAutoPhasedDeployment

使用此 Cmdlet 來建立軟體更新的階段式部署，方法是產生具有相同設定的兩個階段。

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMSoftwareUpdateManualPhasedDeployment

使用此 Cmdlet 建立軟體更新的階段式部署。 您必須先使用 Cmdlet New-CMSoftwareUpdatePhase新增新的自訂部署階段。

$phase1 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotificationOption DisplaySoftwareCenterOnly
$phase2 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateNames ("myUpdateA", "myUpdateB") -Name "myPhaseDeployment" -AddPhases ($phase1, $phase2)
 
$phase3 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotificationOption DisplaySoftwareCenterOnly
$phase4 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateGroupName "myGroup" -Name "myPhaseDeploymentForGroup" -AddPhases ($phase3, $phase4)

New-CMTaskSequenceAutoPhasedDeployment

使用此 Cmdlet，藉由產生具有相同設定的兩個階段，為工作順序建立階段式部署。

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
 
$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMTaskSequenceManualPhasedDeployment

使用此 Cmdlet 建立工作順序的階段式部署。 您必須先使用 Cmdlet New-CMTaskSequencePhase新增新的自訂部署階段。

$phase1 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotification DisplayAll
$phase2 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotification HideAll
New-CMTaskSequenceManualPhasedDeployment -TaskSequenceName "myTaskSequence" -Name "phasedDeployment" -AddPhases ($phase1, $phase2)
 
$phase3 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotification DisplayAll
$phase4 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotification HideAll
$myTaskSequence | New-CMTaskSequenceManualPhasedDeployment -Name "phasedDeployment" -AddPhases ($phase3, $phase4)

Get-CMApplicationPhasedDeployment

使用此 Cmdlet 取得應用程式的階段式部署。

Get-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"

Get-CMSoftwareUpdatePhasedDeployment

使用此 Cmdlet 取得軟體更新的階段式部署。

Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "myUpdateName"

Get-CMTaskSequencePhasedDeployment

使用此 Cmdlet 取得工作順序的階段式部署。

Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"

Get-CMPhasedDeploymentStatus

使用此 Cmdlet 取得特定階段式部署的狀態。

Get-CMPhasedDeploymentStatus -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Get-CMPhasedDeploymentStatus -Catalog $catalog

Move-CMPhasedDeploymentToNext

使用此 Cmdlet 將指定的階段式部署移至下一個階段。

Move-CMPhasedDeploymentToNext -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Move-CMPhasedDeploymentToNext -Force

Resume-CMPhasedDeployment

使用此 Cmdlet 從暫停狀態繼續分階段部署。

Resume-CMPhasedDeployment -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Resume-CMPhasedDeployment -Force

Suspend-CMPhasedDeployment

使用此 Cmdlet 暫停指定的階段式部署。

Suspend-CMPhasedDeployment -Name "myPhasedDeploymentName"
  
$myPhasedDeployment | Suspend-CMPhasedDeployment -Force

Remove-CMApplicationPhasedDeployment

使用此 Cmdlet 移除應用程式的階段式部署。

Remove-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"
 
Remove-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMApplicationPhasedDeployment -Force

Remove-CMSoftwareUpdatePhasedDeployment

使用此 Cmdlet 移除軟體更新的階段式部署。

Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "mySoftwareUpdateName"
 
Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateGroupName "mySoftwareUpdateGroupName"
 
Remove-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMSoftwareUpdatePhasedDeployment -Force

Remove-CMTaskSequencePhasedDeployment

使用此 Cmdlet 移除工作順序的階段式部署。

Remove-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"
 
Remove-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMTaskSequencePhasedDeployment -Force

Add-CMPassiveSite

使用此 Cmdlet 新增被動月臺。

Add-CMPassiveSite -InputObject $SiteSystem -InstallDirectory $InstallPath -SourceFilePathOption CopySourceFileFromActiveSite
Add-CMPassiveSite -SiteCode $SiteCode -SiteSystemServerName $SiteSystemServerName -InstallDirectory $InstallPath -SourceFilePathOption UseLocalSourceDirectory -LocalSourceDirectory $LocalSourcePath

Get-CMThirdPartyUpdateCategory

使用此 Cmdlet 取得協力廠商更新類別。

Get-CMThirdPartyUpdateCategory
Get-CMThirdPartyUpdateCategory -Catalog $catalog
Get-CMThirdPartyUpdateCategory -CatalogId $catalogId -Id $categoryId
Get-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName
$catalog | Get-CMThirdPartyUpdateCategory -ParentId $parentId -PublishOption $publishOption

Move-CMContentLibrary

在新增被動月臺之前，請使用此 Cmdlet 來移動內容庫。

Move-CMContentLibrary -InputObject $Site -NewLocation $NewLocationPath
Move-CMContentLibrary -SiteCode $SiteCode -NewLocation $NewLocationPath

Set-CMThirdPartyUpdateCategory

使用此 Cmdlet 修改協力廠商更新類別。

Set-CMThirdPartyUpdateCategory -Catalog $catalog -Id $categoryId -PublishOption $publishOption -EnableCategories $true
$catalog | Set-CMThirdPartyUpdateCategory -Name $categoryName -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogId $catalogId -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -Categories $categories -PublishOption $publishOption -EnableCategories $true

已淘汰的 Cmdlet

無

已知問題

無

Cmdlet 變更

已對此版本中的現有 Cmdlet 進行下列變更。 變更可能是新功能、錯誤修正或取代。 某些變更可能會中斷。 如果您使用本節所列的其中一個 Cmdlet 或功能區域，請仔細檢閱變更，以瞭解這些變更可能會對您的使用造成何種影響。

Add-CMDeviceCollectionQueryMembershipRule

非中斷性變更

已為查詢規則新增更多錯誤處理。

Add-CMMsiDeploymentType

非中斷性變更

已新增下列新參數，可讓您在建立部署類型時設定修復命令和目錄選項：

  • RepairCommand
  • RepairWorkingDirectory

已修正的錯誤

建立部署類型時遺失設定修復命令和目錄選項的參數。

Add-CMScriptDeploymentTypes

重大變更

-ContentLocation 將不再接受空的資料夾。

已修正的錯誤

-ContentLocation 不應該允許空的資料夾。

Add-CMUserCollectionQueryMembershipRule

非中斷性變更

已為查詢規則新增更多錯誤處理。

Import-CMSoftwareLicense

非中斷性變更

已修正 -Timeout 的參數周框問題。

New-CMApplicationDeployment

非中斷性變更

已新增下列新參數，可讓您在建立應用程式的部署時設定修復應用程式選項：

  • AllowRepairApp

已修正的錯誤

在建立應用程式的部署時，遺漏設定修復應用程式選項的參數。

New-CMSiteSystem

非中斷性變更

已更正 -SiteSystemServerName 和 -PublicFqdn 的驗證。

已修正的錯誤

指定之 -SiteSystemServerName 和 -PublicFqdn 的限制錯誤。

New-CMTSRule

非中斷性變更

-ReferencedVariableName 現在接受以底線開頭的變數名稱。

已修正的錯誤

-ReferencedVariableName 不允許使用者指定以底線開頭的變數名稱。

Set-CMApplicationDeployment

非中斷性變更

已新增下列新參數，可讓您在設定應用程式的部署時設定修復應用程式選項：

  • AllowRepairApp

已修正的錯誤

為應用程式設定部署時，遺漏設定修復應用程式選項的參數。

Set-CMMsiDeploymentType

非中斷性變更

已新增下列新參數，可讓您在設定部署類型時設定修復命令和目錄選項：

  • RepairCommand
  • RepairWorkingDirectory

已修正的錯誤

在設定部署類型時遺失設定修復命令和目錄選項的參數。

Set-CMSite

非中斷性變更

已新增下列新參數，可讓您重試失敗被動月臺的安裝：

  • RetryInstallPassiveSite

已新增下列新參數，可讓您將被動月臺升階為主動：

  • PromotePassiveSiteToActive

Set-CMScriptDeploymentType

重大變更

-ContentLocation 將不再接受空的資料夾。

已修正的錯誤

-ContentLocation 不應該允許空的資料夾。

Set-CMThirdPartyUpdateCatalog

非中斷性變更

  • Cmdlet 現在支援為目錄設定「同步排程」。
  • 已修改因原生方法變更而導致的內部函式呼叫。
範例
Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule