Set-CMDriverPackage
ドライバー パッケージを変更します。
構文
Set-CMDriverPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-DriverManufacturer <String>]
[-DriverModel <String>]
[-DriverPackageSource <String>]
-InputObject <IResultObject>
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priority>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMDriverPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-DriverManufacturer <String>]
[-DriverModel <String>]
[-DriverPackageSource <String>]
-Id <String>
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priority>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMDriverPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-DriverManufacturer <String>]
[-DriverModel <String>]
[-DriverPackageSource <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priority>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
ドライバー パッケージを変更するには、このコマンドレットを使用します。
詳細については、「 Configuration Manager でドライバーを管理する」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ドライバー パッケージの製造元とモデルを構成する
このコマンドは、ID XYZ00091を使用してドライバー パッケージの製造元とモデルを構成します。
Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CopyToPackageShareOnDistributionPoint
クライアントは常に配布ポイントからドライバー パッケージをダウンロードできます。 このパラメーターを $true に設定すると、サイトは配布ポイント上の名前付きネットワーク共有を介して使用できるようにします。 CustomPackageShareName を使用して、カスタム共有名を指定します。
このオプションを有効にすると、配布ポイントにさらに多くの領域が必要になります。 このドライバー パッケージを配布するすべての配布ポイントに適用されます。
| 型: | Boolean |
| Aliases: | CopyToPackageShareOnDistributionPoints |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CustomPackageShareName
CopyToPackageShareOnDistributionPoint を有効にした場合は、このパラメーターを使用して共有名をカスタマイズできます。 最大長は 127 文字で、次の文字を含めることはできません: " / [ ] : | < > + = ; , ? *。 共有名とフォルダー名を指定できますが、それぞれの最大文字数は 80 文字です。 たとえば、「 ShareName\FolderName 」のように入力します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
ドライバー パッケージを識別するのに役立つ、省略可能な説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisconnectUserFromDistributionPoint
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectEnabled プロパティを設定します。
| 型: | Boolean |
| Aliases: | DisconnectUsersFromDistributionPoints |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisconnectUserFromDistributionPointMins
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectDelay プロパティを設定します。
| 型: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsMinutes |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisconnectUserFromDistributionPointRetryCount
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectNumRetries プロパティを設定します。
| 型: | UInt32 |
| Aliases: | DisconnectUsersFromDistributionPointsRetries |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DistributionPointUpdateSchedule
スケジュールに従って配布ポイントを更新するには、このパラメーターを使用します。 schedule オブジェクトを取得するには、 New-CMSchedule コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DriverManufacturer
デバイスの製造元を設定するには、このパラメーターを使用します。 最大長は 100 文字です。
DriverModel パラメーターと共に使用します。 ドライバー カタログの管理や、タスク シーケンスの事前キャッシュに使用できます。 詳細については、「 タスク シーケンスの事前キャッシュ コンテンツを構成する」を参照してください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DriverModel
デバイスのモデルを設定するには、このパラメーターを使用します。 最大長は 100 文字です。
DriverManufacturer パラメーターと共に使用します。 ドライバー カタログの管理や、タスク シーケンスの事前キャッシュに使用できます。 詳細については、「 タスク シーケンスの事前キャッシュ コンテンツを構成する」を参照してください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DriverPackageSource
ドライバー ファイルをソースにするネットワークの場所へのファイル パスを指定します。
ドライバー パッケージを作成する場合、パッケージのソースの場所は、別のドライバー パッケージで使用されていない空のネットワーク共有を指している必要があります。 SMS プロバイダーには、その場所に対する フル コントロール アクセス許可が必要です。
ドライバー パッケージにデバイス ドライバーを追加すると、Configuration Manager によってこのパスにコピーされます。 ドライバー パッケージには、インポートし、ドライバー カタログで有効になっているデバイス ドライバーのみを追加できます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Id
構成するドライバー パッケージの ID を指定します。 この値は、標準パッケージ ID です (例: XYZ00020)。
| 型: | String |
| Aliases: | PackageId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
構成するドライバー パッケージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMDriverPackage コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MulticastAllow
このパラメーターを $true に設定して、このパッケージをマルチキャスト経由で転送できるようにします。 詳細については、「 マルチキャストを使用して Configuration Manager を使用してネットワーク経由で Windows を展開する」を参照してください。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MulticastEncrypt
MulticastAllow を有効にする場合は、このパラメーターを $true に設定してマルチキャスト パッケージを暗号化します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MulticastTransferOnly
MulticastAllow を有効にする場合は、このパラメーターを $true に設定して、マルチキャスト経由でのみこのドライバー パッケージを転送します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
構成するドライバー パッケージの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NewName
ドライバー パッケージの新しい名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrestageBehavior
事前設定されたコンテンツの配布ポイントを有効にする場合の動作を指定します。
-
ManualCopy: このパッケージ内のコンテンツを配布ポイントに手動でコピーします。 -
DownloadDelta: コンテンツの変更のみを配布ポイントにダウンロードする -
OnDemand: パッケージが配布ポイントに割り当てられると、コンテンツが自動的にダウンロードされます
詳細については、「 事前設定されたコンテンツを使用する」を参照してください。
| 型: | PrestageBehavior |
| 指定可能な値: | ManualCopy, DownloadDelta, OnDemand |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Priority
サイトが他のサイトとこのサイトの配布ポイントにコンテンツを送信する順序を指定します。
サイトは、優先度の高いコンテンツを中または低の優先順位のパッケージの前に送信します。 優先度が等しいパッケージは、作成された順序で送信されます。
| 型: | Priority |
| 指定可能な値: | High, Medium, Low |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SendToPreferredDistributionPoint
優先配布ポイントへのオンデマンド コンテンツ配布を有効にする場合は、このパラメーターを $true に設定します。 この設定を有効にすると、クライアントがパッケージのコンテンツを要求し、そのコンテンツが配布ポイントで使用できない場合、管理ポイントはコンテンツを配布します。 詳細については、「 オンデマンド コンテンツの配布」を参照してください。
| 型: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Version
ドライバー パッケージのバージョンを指定します。 この値は、管理する文字列です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object