Set-CMDriverPackage

  • リファレンス
モジュール:
ConfigurationManager

ドライバー パッケージを変更します。

構文

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 でドライバーを管理する」を参照してください。

注意

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

例

例 1: ドライバー パッケージの製造元とモデルを構成する

このコマンドは、ID XYZ00091を使用してドライバー パッケージの製造元とモデルを構成します。

Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-CopyToPackageShareOnDistributionPoint

クライアントは、配布ポイントからドライバー パッケージをいつでもダウンロードできます。 このパラメーターを $trueすると 、 サイトは配布ポイント上の名前付きネットワーク共有経由で使用できます。 カスタム共有名を指定するには、CustomPackageShareNameを使用します。

このオプションを有効にすると、配布ポイントに必要な領域が多くなされます。 このドライバー パッケージを配布するすべての配布ポイントに適用されます。

Type:Boolean
Aliases:CopyToPackageShareOnDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CustomPackageShareName

CopyToPackageShareOnDistributionPointを有効にした場合は、このパラメーターを使用して共有名をカスタマイズできます。 最大長は 127 文字で、次の文字を含めることはできません " / [ ] : | < > + = ; , ? * 。 共有名とフォルダー名を指定できますが、それぞれの最大文字数は 80 文字です。 たとえば、ShareName\FolderName などです。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

ドライバー パッケージを識別するのに役立つ、オプションのドライバー パッケージの説明を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPoint

このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectEnabled プロパティを設定します。

Type:Boolean
Aliases:DisconnectUsersFromDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointMins

このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectDelay プロパティを設定します。

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisconnectUserFromDistributionPointRetryCount

このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectNumRetries プロパティを設定します。

Type:UInt32
Aliases:DisconnectUsersFromDistributionPointsRetries
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointUpdateSchedule

スケジュールで配布ポイントを更新するには、このパラメーターを使用します。 スケジュール オブジェクトを取得するには 、New-CMSchedule コマンドレットを使用 します。

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DriverManufacturer

デバイスの製造元を設定するには、このパラメーターを使用します。 最大長は 100 文字です。

DriverModel パラメーターと 一緒に使用 します。 ドライバー カタログの管理や、タスク シーケンスの事前キャッシュに使用できます。 詳細については、「Configure pre-cache content for task sequences」を参照してください。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DriverModel

このパラメーターを使用して、デバイスのモデルを設定します。 最大長は 100 文字です。

DriverManufacturer パラメーターと一緒に使用します。 ドライバー カタログの管理や、タスク シーケンスの事前キャッシュに使用できます。 詳細については、「Configure pre-cache content for task sequences」を参照してください。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DriverPackageSource

ドライバー ファイルのソースとしてネットワークの場所へのファイル パスを指定します。

ドライバー パッケージを作成する場合、パッケージのソースの場所は、別のドライバー パッケージで使用されていない空のネットワーク共有を指している必要があります。 SMS プロバイダーには、その場所 に対するフル コントロール のアクセス許可が必要です。

ドライバー パッケージにデバイス ドライバーを追加すると、Configuration Manager によってこのパスにコピーされます。 ドライバー パッケージに追加できるのは、インポートしたドライバーと、ドライバー カタログで有効になっているデバイス ドライバーのみです。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Id

構成するドライバー パッケージの ID を指定します。 この値は、次の標準的なパッケージ ID です XYZ00020 。

Type:String
Aliases:PackageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

構成するドライバー パッケージ オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMDriverPackage コマンドレットを使用 します。

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-MulticastAllow

このパラメーターを [$true] に設定して、このパッケージをマルチキャスト経由で転送できます。 詳細については、「Configuration Manager を使用してネットワーク上にWindowsマルチキャストを使用する」を参照してください。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MulticastEncrypt

MulticastAllow を有効にした場合は、このパラメーターをマルチキャストパッケージ$trueに設定します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MulticastTransferOnly

MulticastAllow を有効にする場合は、このパラメーターをマルチキャスト$trueこのドライバーパッケージのみを転送する場合に設定します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

構成するドライバー パッケージの名前を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

ドライバー パッケージの新しい名前を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestageBehavior

事前設定されたコンテンツの配布ポイントを有効にした場合の動作を指定します。

  • ManualCopy: このパッケージ内のコンテンツを配布ポイントに手動でコピーする
  • DownloadDelta: 配布ポイントへのコンテンツの変更のみをダウンロードする
  • OnDemand: パッケージが配布ポイントに割り当てられているときにコンテンツを自動的にダウンロードする

詳細については、「事前設定された コンテンツを使用する」を参照してください。

Type:PrestageBehavior
Accepted values:ManualCopy, DownloadDelta, OnDemand
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Priority

サイトがコンテンツを他のサイトに送信する順序と、このサイトの配布ポイントを指定します。

サイトは、優先度が中または低のパッケージの前に優先度の高いコンテンツを送信します。 優先度が等しいパッケージは、作成順に送信されます。

Type:Priority
Accepted values:High, Medium, Low
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendToPreferredDistributionPoint

オンデマンド コンテンツ配布を優先配布ポイントに対して有効にする場合は、このパラメーターを [$true] に設定します。 この設定を有効にすると、クライアントがパッケージのコンテンツを要求し、そのコンテンツが配布ポイントで使用できない場合、管理ポイントはコンテンツを配布します。 詳細については、「オンデマンド コンテンツ 配布」を参照してください。

Type:Boolean
Aliases:SendToPreferredDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Version

ドライバー パッケージのバージョンを指定します。 この値は、管理する文字列です。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object