Set-CMApplicationSupersedence

モジュール:

ConfigurationManager

アプリケーションの配置の種類の置き換えを設定します。

構文

Set-CMApplicationSupersedence
   [-Id] <Int32>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationSupersedence
   [-Name] <String>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationSupersedence
   [-InputObject] <IResultObject>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、指定したアプリケーションの配置の種類の置き換えを設定します。

詳細については、「 アプリケーションの置き換え」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: 配置の種類の置き換えを追加する

$AppSupersededName = "Superseded app"
$AppSuperseded = New-CMApplication -Name $AppSupersededName
$OriginalDT = Add-CMScriptDeploymentType -ApplicationName $AppSuperseded -DeploymentTypeName "ScriptDT01" -InstallCommand 'appsetup.exe'

$AppSupersedingName = "Superseding app"
$AppSuperseding = New-CMApplication -Name $AppSupersedingName
$AppSupersedingDT = Add-CMScriptDeploymentType -ApplicationName $AppSuperseding -DeploymentTypeName "ScriptDT02" -InstallCommand 'appsetup2.exe'

Set-CMApplicationSupersedence -ApplicationId ($AppSuperseding.CI_ID) -CurrentDeploymentTypeId ($AppSupersedingDT.CI_ID) -SupersededApplicationId ($AppSuperseded.CI_ID) -OldDeploymentTypeId ($OriginalDT.CI_ID)

例 2: 配置の種類の置き換えを削除する

Set-CMApplicationSupersedence -ApplicationName $AppSupersedingName -CurrentDeploymentTypeName ($AppSupersedingDT.LocalizedDisplayName) -SupersededApplicationName $AppSupersededName -OldDeploymentTypeName ($OriginalDT.LocalizedDisplayName) -RemoveSupersedence -Force

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CurrentDeploymentType

スーパーシング アプリケーションからデプロイの種類のオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMDeploymentType コマンドレットを使用します。

型:	IResultObject
Aliases:	ReplacementDeploymentType, SupersedingDeploymentType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CurrentDeploymentTypeId

スーパーセッション アプリケーションからデプロイの種類の ID を指定します。

型:	Int32
Aliases:	CurrentDeploymentTypeCIId, CurrentDeploymentTypeCI_ID, ReplacementDeploymentTypeId, ReplacementDeploymentTypeCIId, ReplacementDeploymentTypeCI_ID, SupersedingDeploymentTypeId, SupersedingDeploymentTypeCIId, SupersedingDeploymentTypeCI_ID
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CurrentDeploymentTypeName

スーパーシング アプリケーションからのデプロイの種類の名前を指定します。

型:	String
Aliases:	ReplacementDeploymentTypeName, SupersedingDeploymentTypeName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

確認を求めずにコマンドを実行するには、このパラメーターを追加します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

現在の (スーパーセッション) アプリケーションの ID を指定します。

型:	Int32
Aliases:	ApplicationId, CurrentApplicationId, CurrentApplicationCIId, CurrentApplicationCI_ID
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

現在の (スーパーシング) アプリケーションのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMApplication コマンドレットを 使用します。

型:	IResultObject
Aliases:	Application, CurrentApplication
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-IsUninstall

クライアントがスーパーセディング アプリケーションをインストールする前に置き換えられたアプリケーションをアンインストールするには、このパラメーターを $true に設定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

現在の (スーパーコンピューティング) アプリケーションのローカライズされた表示名を指定します。

型:	String
Aliases:	ApplicationName, LocalizedDisplayName, CurrentApplicationName, CurrentApplicationLocalizedDisplayName
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OldDeploymentType

置き換えられたアプリケーションからデプロイの種類のオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMDeploymentType コマンドレットを使用します。

型:	IResultObject
Aliases:	SupersededDeploymentType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OldDeploymentTypeId

置き換えられたアプリケーションからデプロイの種類の ID を指定します。

型:	Int32
Aliases:	OldDeploymentTypeCIId, OldDeploymentTypeCI_ID, SupersededDeploymentTypeId, SupersededDeploymentTypeCIId, SupersededDeploymentTypeCI_ID
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OldDeploymentTypeName

置き換えられたアプリケーションからのデプロイの種類の名前を指定します。

型:	String
Aliases:	SupersededDeploymentTypeName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveSupersedence

置き換えリレーションシップを削除するには、このパラメーターを追加します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SupersededApplication

古い (置き換えられた) アプリケーションのオブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMApplication コマンドレットを 使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SupersededApplicationId

古い (置き換えられた) アプリケーションの ID を指定します。

型:	Int32
Aliases:	SupersededApplicationCIId, SupersededApplicationCI_ID
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SupersededApplicationName

古い (置き換えられた) アプリケーションのローカライズされた表示名を指定します。

型:	String
Aliases:	SupersededApplicationLocalizedDisplayName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Get-CMApplication
• Get-CMDeploymentType
• アプリケーションを置き換える