Set-CMDriverBootImage
ブート イメージにドライバーを追加するか、ブート イメージからドライバーを削除します。
構文
Set-CMDriverBootImage
-BootImageId <String>
-DriverId <Int32>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImage <IResultObject>
-DriverId <Int32>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImage <IResultObject>
-DriverName <String>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImage <IResultObject>
-Driver <IResultObject>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImageId <String>
-DriverName <String>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImageId <String>
-Driver <IResultObject>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImageName <String>
-DriverId <Int32>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImageName <String>
-DriverName <String>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverBootImage
-BootImageName <String>
-Driver <IResultObject>
[-PassThru]
-SetDriveBootImageAction <SetDriveBootImageActionType>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-CMDriverBootImage コマンドレットは、ブート イメージにドライバーを追加するか、ブート イメージからドライバーを削除します。 Configuration Manager ドライバー カタログにインポートした Windows デバイス ドライバーを、1 つ以上のブート イメージに追加できます。 他の種類のドライバーは必要なく、ブート イメージのサイズが大きくなるため、大容量ストレージ デバイス ドライバーとネットワーク アダプター デバイス ドライバーのみをブート イメージに追加する必要があります。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ブート イメージにドライバーを追加する
PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction AddDriverToBootImage -DriverName "Adaptec Embedded SCSI HostRAID Controller" -BootImageName "Boot image (x64)"
このコマンドは、Adaptec Embedded SCSI HostRAID Controller という名前のドライバーをブート イメージ (x64) という名前のブート イメージに追加します。
例 2: ブート イメージからドライバーを削除する
PS XYZ:\> Set-CMDriverBootImage -SetDriveBootImageAction RemoveDriverFromBootImage -DriverName "Adaptec SCSI HostRAID Management Processor Device" -BootImageName "Boot image (x64)"
このコマンドは、Adaptec SCSI HostRAID 管理プロセッサ デバイスという名前のドライバーをブート イメージ (x64) という名前のブート イメージから削除します。
パラメーター
-BootImage
CMBootImage オブジェクトを指定します。 CMBootImage オブジェクトを取得するには、Get-CMBootImage コマンドレットを使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-BootImageId
ブート イメージの ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-BootImageName
ブート イメージの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Driver
ドライバー オブジェクトを指定します。 CMDriver オブジェクトを取得するには、Get-CMDriver コマンドレットを使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DriverId
ドライバーの ID を指定します。
型: | Int32 |
Aliases: | Id, CIId, CI_ID |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DriverName
ドライバーの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SetDriveBootImageAction
ブート イメージ アクションを指定します。 このパラメーターの有効な値は次のとおりです。
- AddDriverToBootImage
- RemoveDriverFromBootImage
型: | SetDriveBootImageActionType |
指定可能な値: | AddDriverToBootImage, RemoveDriverFromBootImage |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object