New-CMSoftwareUpdateDeployment

ソフトウェア更新プログラムの展開を作成します。

構文

New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   -InputObject <IResultObject>
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、ソフトウェア更新プログラムをターゲット コレクションに展開します。

注:

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

例 1

New-CMSoftwareUpdateDeployment -DeploymentName "updates deployment" -SoftwareUpdateGroupName "software update group" -CollectionName "Desktop clients for SUM" -Description "a more detailed description of this deployment" -DeploymentType Required -VerbosityLevel AllMessages -AvailableDateTime "2020/08/25 02:00AM" -DeadlineDateTime "2020/08/26 02:00AM" -UserNotification DisplaySoftwareCenterOnly -SoftwareInstallation $True  -AllowRestart $True  -RestartServer $False -RestartWorkstation $False -PersistOnWriteFilterDevice $True -RequirePostRebootFullScan $True -ProtectedType RemoteDistributionPoint

パラメーター

-AcceptEula

一部のソフトウェア更新プログラムには、ライセンス条項が含まれます。 ソフトウェア更新プログラムを展開すると、ライセンス条項は表示されません。 関連付けられているライセンス条項に関係なく、すべてのソフトウェア更新プログラムを自動的に展開するには、このパラメーターを追加します。

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

-AllowRestart

インストール期限に達したら、このパラメーターを に $true 設定して、メンテナンス期間外で必要に応じてシステムの再起動を許可します。

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

-AvailableDateTime

ソフトウェア更新プログラムを使用できるタイミングを指定します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Collection

デプロイがターゲットConfiguration Managerコレクション オブジェクトを指定します。 Get-CMCollection コマンドレットを使用して、このオブジェクトを取得します。

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

-CollectionId

このソフトウェア更新プログラムの展開のターゲットとしてコレクション ID を指定します。

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

-CollectionName

このソフトウェア更新プログラムの展開のターゲットとしてコレクション名を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Comment

ソフトウェア更新プログラムの展開の説明 (省略可能) を指定します。

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineDateTime

必要なソフトウェア更新プログラムのインストール期限を指定します。 期限に達すると、クライアントは必要なソフトウェア更新プログラムをデバイスにインストールし、必要に応じてデバイスを再起動します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentName

ソフトウェア更新プログラムの展開の名前を指定します。

Type:String
Aliases:UpdateGroupDeploymentName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentType

この展開をユーザーがインストールできるかどうかを指定するか、指定した期限スケジュールで必要なインストールを行うかを指定します。

Type:DeploymentType
Accepted values:Required, Available
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployWithNoPackage

デプロイ パッケージを使用しないようにするには、このパラメーターを に $true 設定します。 クライアントは、ピアまたは Microsoft クラウドからソフトウェア更新プログラムのコンテンツをダウンロードします。

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

-DisableOperationsManagerAlert

ソフトウェアの更新中に Operations Manager アラートを無効にするかどうかを示します。

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

サイトは、このコレクション名に関連付けられている配布ポイント グループにコンテンツを配布します。

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

-DistributeContent

この展開を作成するときにソフトウェア更新プログラムのコンテンツを配布するには、このパラメーターを追加します。 クライアントがアクセスできる配布ポイントにコンテンツを配布するまで、クライアントはソフトウェア更新プログラムをインストールできません。

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

-DistributionPointGroupName

サイトは、この配布ポイント グループにコンテンツを配布します。

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

-DistributionPointName

サイトは、この配布ポイントにコンテンツを配布します。

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

-DownloadFromMicrosoftUpdate

ソフトウェア更新プログラムのコンテンツが現在のグループ、近隣グループ、またはサイト境界グループの配布ポイントで使用できない場合は、Microsoft Update からコンテンツをダウンロードします。

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

-ForceWildcardHandling

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

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

-GenerateOperationsManagerAlert

ソフトウェアのインストールが失敗したときに Operations Manager アラートを生成するかどうかを示します。

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

-GenerateSuccessAlert

デプロイのコンプライアンスが指定されたしきい値を下回ると、デプロイによってConfiguration Manager コンソールにアラートが生成されます。 既定のしきい値は 95% です。 しきい値を変更するには、 PercentSuccess パラメーターを 使用します。

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

-InputObject

展開するソフトウェア更新オブジェクトを指定します。

Type:IResultObject
Aliases:SoftwareUpdate, SoftwareUpdateGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PercentSuccess

GenerateSuccessAlert を に設定した場合は、このパラメーターを$true使用して、サイトがConfiguration Managerコンソール アラートを生成するコンプライアンスしきい値の割合を指定します。 指定しない場合、指定した期限までに展開で 95% のコンプライアンスが達成されない場合、サイトによってアラートが生成されます。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PersistOnWriteFilterDevice

ソフトウェア更新プログラムを一時オーバーレイにインストールして後で変更をコミットするか、インストール期限またはメンテナンス期間に変更をコミットするかを示します。

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

-ProtectedType

クライアントが近隣境界グループまたは既定のサイト境界グループの配布ポイントを使用できるかどうかを指定します。

Type:ProtectedType
Accepted values:NoInstall, RemoteDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequirePostRebootFullScan

このパラメーターは、次のコンソール オプションを制御します。 再起動時のソフトウェア更新プログラムの展開の再評価動作。 このオプションを に $true設定すると、クライアントがこの展開から更新プログラムをインストールするときに再起動した後、完全な更新プログラムの展開評価サイクルが実行されます。

Type:Boolean
Aliases:RunEvaluationAfterRestart
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestartServer

ソフトウェア更新プログラムの後にサーバーの再起動を許可するかどうかを示します。

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

-RestartWorkstation

ソフトウェア更新プログラムの後にワークステーションの再起動を許可するかどうかを示します。

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

-SavedPackageId

Type:String
Aliases:SavedDeploymentPackageId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SendWakeupPacket

展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。

  • $True: Configuration Managerスリープ状態からコンピューターをスリープ解除します。
  • $False: スリープ状態からコンピューターをスリープ解除しません。

コンピューターがスリープ解除するには、まず Wake On LAN を構成します。

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

-SoftDeadlineEnabled

このパラメーターを使用して、ADR 展開設定の [展開スケジュール ] ページで次のオプションを設定します。 クライアント設定で定義されている猶予期間まで、ユーザー設定に従ってこのデプロイを延期します。

Type:Boolean
Aliases:DelayEnforcementAndUpToGracePeriod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareInstallation

インストール期限に達したら、このパラメーターを に設定して $true 、メンテナンス期間外のソフトウェア更新プログラムのインストールを許可します。

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

-SoftwareUpdateGroupId

展開するソフトウェア更新プログラム グループの ID を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateGroupName

展開するソフトウェア更新プログラム グループの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateId

展開するソフトウェア更新プログラムの ID を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateName

展開するソフトウェア更新プログラムの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TimeBasedOn

クライアントがローカル時刻または UTC 時刻を使用して、デプロイの可用性を判断するように指定します。 UTC 時刻により、ソフトウェア更新プログラムがすべてのコンピューターで同時に使用できるようになります。

Type:TimeType
Accepted values:LocalTime, Utc
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeUnit

TimeValue パラメーターの値の種類を指定します。

Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeValue

時刻の整数値を指定します。 -TimeUnit パラメーターを使用して、この値の時間の種類を決定します。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnprotectedType

現在の境界グループまたは近隣境界グループの配布ポイントでソフトウェア更新プログラムを使用できない場合は、クライアントがサイトの既定の境界グループの配布ポイントからソフトウェア更新プログラムをダウンロードしてインストールできるかどうかを指定します。

Type:UnprotectedType
Accepted values:NoInstall, UnprotectedDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseBranchCache

Windows BranchCache を使用してソフトウェア更新プログラムのコンテンツをダウンロードするかどうかを示します。

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

-UseMeteredNetwork

クライアントが従量制課金ネットワークを使用して更新プログラムをダウンロードできるかどうかを示します。

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

-UserNotification

ユーザー通知エクスペリエンスを指定します。

  • DisplayAll: ソフトウェア センターに表示し、すべての通知を表示する
  • DisplaySoftwareCenterOnly: ソフトウェア センターに表示し、コンピューターの再起動に関する通知のみを表示します
  • HideAll: ソフトウェア センターとすべての通知で非表示にする
Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VerbosityLevel

このソフトウェア更新プログラムの展開に対してクライアントから返される状態メッセージの詳細レベルを指定します。

Type:VerbosityLevelType
Accepted values:AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object