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

  • [アーティクル]

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

注意

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

重要な変更点

新しいコマンドレット

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