バージョン 2002 のConfiguration Manager コマンドレット ライブラリの変更

Configuration Manager (現在のブランチ) に適用

注:

Configuration Manager現在のブランチ バージョン 1910 が、これらの変更のベースラインです。 詳細については、「バージョン 1910 のコマンドレット ライブラリの変更Configuration Manager」を参照してください。

重要な変更

新しいコマンドレット

New-CMSoftwareUpdatePhase

このコマンドレットを使用して、ソフトウェア更新プログラムの展開フェーズを作成します。

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

New-CMTaskSequencePhase

このコマンドレットを使用して、タスク シーケンスのデプロイ フェーズを作成します。

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

Get-CMPhase

このコマンドレットを使用して、特定のインスタンスまたは段階的なデプロイのデプロイ フェーズを取得します。

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

New-CMApplicationAutoPhasedDeployment

このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成することで、アプリケーションの段階的なデプロイを作成します。

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

このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成することで、ソフトウェア更新プログラムの段階的な展開を作成します。

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

このコマンドレットを使用して、ソフトウェア更新プログラムの段階的な展開を作成します。 最初にコマンドレットを 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

このコマンドレットを使用して、同じ設定で 2 つのフェーズを生成することで、タスク シーケンスの段階的な展開を作成します。

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

このコマンドレットを使用して、タスク シーケンスの段階的なデプロイを作成します。 最初にコマンドレットを 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

このコマンドレットを使用して、アプリケーションの段階的なデプロイを取得します。

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

Get-CMSoftwareUpdatePhasedDeployment

このコマンドレットを使用して、ソフトウェア更新プログラムの段階的な展開を取得します。

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

Get-CMTaskSequencePhasedDeployment

このコマンドレットを使用して、タスク シーケンスの段階的なデプロイを取得します。

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

Get-CMPhasedDeploymentStatus

このコマンドレットを使用して、特定の段階的デプロイの状態を取得します。

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

Move-CMPhasedDeploymentToNext

指定した段階的デプロイを次のフェーズに移動するには、このコマンドレットを使用します。

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

Resume-CMPhasedDeployment

中断状態から段階的なデプロイを再開するには、このコマンドレットを使用します。

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

Suspend-CMPhasedDeployment

指定した段階的デプロイを中断するには、このコマンドレットを使用します。

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

Remove-CMApplicationPhasedDeployment

このコマンドレットを使用して、アプリケーションの段階的なデプロイを削除します。

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

Remove-CMSoftwareUpdatePhasedDeployment

このコマンドレットを使用して、ソフトウェア更新プログラムの段階的な展開を削除します。

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

Remove-CMTaskSequencePhasedDeployment

タスク シーケンスの段階的な展開を削除するには、このコマンドレットを使用します。

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

Add-CMPassiveSite

パッシブ サイトを追加するには、このコマンドレットを使用します。

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

Get-CMThirdPartyUpdateCategory

サードパーティの更新カテゴリを取得するには、このコマンドレットを使用します。

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

パッシブ サイトを追加する前にコンテンツ ライブラリを移動するには、このコマンドレットを使用します。

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

Set-CMThirdPartyUpdateCategory

サードパーティの更新カテゴリを変更するには、このコマンドレットを使用します。

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

非推奨のコマンドレット

なし

既知の問題

なし

コマンドレットの変更

このバージョンの既存のコマンドレットに対して、次の変更が行われました。 変更には、新機能、バグ修正、または非推奨が含まれる場合があります。 一部の変更が壊れる可能性があります。 このセクションに記載されているいずれかのコマンドレットまたは機能領域を使用する場合は、変更内容を慎重に確認して、使用に与える影響を理解してください。

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

破壊的でない変更

  • コマンドレットでカタログの '同期スケジュール' の設定がサポートされるようになりました。
  • ネイティブ メソッドの変更により、内部関数呼び出しが変更されました。
Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule