New-CMPrestageMedia

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

OS 展開の事前設定されたメディア ファイルを作成します。

構文

New-CMPrestageMedia
   [-Application <IResultObject[]>]
   [-Comment <String>]
   [-CreatedBy <String>]
   [-DriverPackage <IResultObject[]>]
   [-IncludeApplicationDependency]
   -OperatingSystemImage <IResultObject>
   [-OperatingSystemImageIndex <Int32>]
   [-Package <IResultObject[]>]
   -TaskSequence <IResultObject>
   [-Version <String>]
   [-AllowUacPrompt]
   [-AllowUnattended]
   [-AllowUnknownMachine]
   -BootImage <IResultObject>
   [-CertificateExpireTime <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-CertificateStartTime <DateTime>]
   -DistributionPoint <IResultObject[]>
   [-Force]
   -ManagementPoint <IResultObject[]>
   [-SiteCode <String>]
   -MediaMode <MediaMode>
   [-MediaPassword <SecureString>]
   [-NoAutoRun]
   -Path <String>
   [-PrestartCommand <String>]
   [-PrestartPackage <IResultObject>]
   [-TemporaryFolder <String>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-Variable <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMPrestageMedia コマンドレットは、新しいハード ドライブに OS イメージを事前設定するファイルを作成します。 詳細については、「事前設定された メディアを計画する」を参照してください。

注意

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

例

例 1: 事前設定されたメディアを作成する

最初のコマンドは、サイト コードCM1のmp01.contoso.comという名前のサイト システム サーバーの管理ポイント オブジェクトを取得し、オブジェクトを $ManagementPoint 変数に格納します。

2 番目のコマンドは 、BootImage01 という名前のブート イメージ オブジェクト を取得し、オブジェクトを変数 $BootImageします。

3 番目のコマンドは 、dist01.contoso.com という名前のサイト システム サーバーの配布ポイント オブジェクトをサイト コード CM1 に取得し、オブジェクトを $DistributionPoint 変数 に格納 します。

4 番目のコマンドは 、OSImagePkg01 という名前の OS イメージ オブジェクトを 取得し、オブジェクトを変数 $OSImageします。

最後**** のコマンドは、prestagedMedia.wim**** という名前の動的な事前設定されたメディア ファイルを作成し、ブート イメージは $BootImage、$DistributionPointに格納された配布ポイント 、$ManagementPointに格納された管理ポイント、$OSImage に格納されている OS イメージを作成します。

$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "mp01.contoso.com" -SiteCode "CM1"
$BootImage = Get-CMBootImage -Name "BootImage01"
$DistributionPoint = Get-CMDistributionPoint -SiteSystemServerName "dist01.contoso.com" -SiteCode "CM1"
$OSImage = Get-CMOperatingSystemImage -Name "OSImagePkg01"

New-CMPrestageMedia -MediaMode Dynamic -Path "\\server\share\PrestagedMedia.wim" -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPoint -OperatingSystemImage $OSImage

パラメーター

-AllowUacPrompt

このパラメーターを追加して、Windows (UAC) を使用して管理者のアクセス許可を昇格するように求めるメッセージを表示します。 このコマンドレットを実行するには、管理者特権のアクセス許可が必要です。

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

このパラメーターを追加して、無人 OS の展開を許可します。 無人 OS の展開では、ネットワーク構成やオプションのタスク シーケンスを求めるメッセージは表示されません。

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

Configuration Manager が不明なコンピューターをプロビジョニングするには、このパラメーターを追加します。 不明なコンピューターとは、サイトがまだ検出されていないコンピューターです。

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

メディア ファイルの一部として含めるアプリケーション オブジェクトの配列を指定します。 タスク シーケンスがこのコンテンツを参照する場合は、最初にコンテンツをローカルで検索します。 コンテンツがメディア内に存在しない場合、タスク シーケンスは通常通りネットワークからコンテンツをダウンロードします。 アプリケーション オブジェクトを取得するには 、Get-CMApplication コマンドレットを使用 します。

Type:IResultObject[]
Aliases:Applications
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootImage

ブート イメージ オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMBootImage コマンドレットを使用 します。

Type:IResultObject
Aliases:BootImagePackage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificateExpireTime

HTTP 通信用に自己署名証明書を作成する場合、このパラメーターは証明書の有効期限と時刻を指定します。 将来の日付を十分に指定します。 この証明書の有効期限が切れると、起動可能なメディアを使用できません。 開始日を 設定するには、-CertificateStartTime パラメーターを使用します。

例:

$date = [datetime]::p arseexact("11/16/2021", 'MM/dd/yyyy', $null)

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

-CertificatePath パラメーターを使用してHTTPS 通信用の PKI 証明書をインポートする場合は、このパラメーターを使用して証明書ファイルのパスワードを指定します。

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificatePath

インポートする PKI 証明書へのパスを指定します。 この証明書 ファイルのパスワードを指定するには、-CertificatePassword パラメーターを使用します。 HTTPS クライアント通信用にサイトを構成する場合は、次のパラメーターを使用します。

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

HTTP 通信用に自己署名証明書を作成するために、このパラメーターは証明書の開始日と時刻を指定します。 有効期限を 設定するには、-CertificateExpireTime パラメーターを使用します。 この日付まで起動可能なメディアを使用することはできません。

例:

$date = [datetime]::p arseexact("11/16/2020", 'MM/dd/yyyy', $null)

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

メディアに関する詳細を提供するオプションの文字列。 このメディアの構成方法や使用方法を説明すると便利です。 最大長は 127 文字です。

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

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

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

このメディアを作成したユーザーを指定するオプションの文字列で、追跡の目的に役立ちます。 最大長は 50 文字です。

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
-DistributionPoint

このメディアのコンテンツを配布する 1 つ以上の配布ポイント オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMDistributionPoint コマンドレットを使用 します。

Type:IResultObject[]
Aliases:DistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DriverPackage

メディア ファイルの一部として含めるドライバー パッケージ オブジェクトの配列を指定します。 タスク シーケンスがこのコンテンツを参照している場合、そのコンテンツはローカルで検索されます。 コンテンツがメディア内に存在しない場合、タスク シーケンスは通常通りネットワークからコンテンツをダウンロードします。 このオブジェクトを取得するには 、Get-CMDriverPackage コマンドレットを使用 します。

Type:IResultObject[]
Aliases:DriverPackages, PackageDriver, PackageDrivers
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

確認を求めずにコマンドを実行します。

Type:SwitchParameter
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
-IncludeApplicationDependency

関連付けられたアプリケーションの依存関係を検出し、このメディアに追加するには、このパラメーターを追加します。

Type:SwitchParameter
Aliases:IncludeApplicationDependencies
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ManagementPoint

メディアが初期通信で使用する 1 つ以上の管理ポイント オブジェクトを指定します。 -MediaMode パラメーターを使用して、メディアの実行時の通信方法を決定します。 このオブジェクトを取得するには 、Get-CMManagementPoint コマンドレットを使用 します。

Type:IResultObject[]
Aliases:ManagementPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MediaMode

クライアントが管理ポイントを検索して展開情報を取得する方法を指定します。

  • Dynamic: メディアは管理ポイントに接続し、サイト境界内のクライアントの場所に基づいてクライアントを別の管理ポイントにリダイレクトします。

  • SiteBased: メディアは、-ManagementPoint パラメーターで指定された 管理ポイントを通信 します。

Type:MediaMode
Accepted values:Dynamic, SiteBased
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MediaPassword

タスク シーケンス メディアを保護するためのセキュリティで保護された文字列パスワードを指定します。 このメディアを使用してデバイスを起動する場合は、パスワードを入力して続行する必要があります。

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NoAutoRun

メディアに autorun.inf ファイルを含めるには、このパラメーターを追加します。 Configuration Manager は既定では追加されません。 このファイルは、一般的にマルウェア対策製品によってブロックされます。 自動実行機能の詳細については、「Windows自動実行が有効な CD-ROM アプリケーションの作成」を参照してください。 シナリオに必要な場合は、このパラメーターを追加してファイルを含める。

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

このメディアに含める OS イメージ パッケージ オブジェクトを指定します。 OperatingSystemImageIndex パラメーターを使用して、イメージ パッケージ内のイメージ インデックスを指定します。 このオブジェクトを取得するには 、Get-CMOperatingSystemImage コマンドレットを使用 します。

Type:IResultObject
Aliases:OperatingSystemImagePackage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OperatingSystemImageIndex

OperatingSystemImageパラメーターからイメージ パッケージ内のイメージ インデックスを指定します。

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

メディア ファイルに含めるパッケージ オブジェクトの配列を指定します。 タスク シーケンスがこのコンテンツを参照している場合、そのコンテンツはローカルで検索されます。 コンテンツがメディア内に存在しない場合、タスク シーケンスは通常通りネットワークからコンテンツをダウンロードします。 このオブジェクトを取得するには 、Get-CMPackage コマンドレットを使用 します。

Type:IResultObject[]
Aliases:Packages
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Path

作成するメディア ファイルへのパス。 形式は、ドライブ/ディレクトリ パスまたは有効なネットワーク パスのいずれかです。 例:

  • C:\media\prestaged1.wim
  • \\server\share\prestaged1.wim
Type:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestartCommand

タスク シーケンスを開始する前に実行するコマンド ラインを指定します。 詳細については、「タスク シーケンス メディア の事前開始コマンド」を参照してください。

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

PrestartCommand を指定する場合は、このパラメーターを使用して、必要に応じて事前開始コンテンツのパッケージを指定します。

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

バージョン 2010 以降に適用されます。 サイト コードを指定するには 、ManagementPoint パラメーターと一緒にこのパラメーターを使用します。

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

このメディアを実行するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMTaskSequence コマンドレットを使用 します。

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

メディア作成プロセスでは、多くの一時的なドライブ領域が必要な場合があります。 既定では、Configuration Manager は現在のユーザーの一時ディレクトリを使用します $env:temp 。 たとえば、C:\Users\jqpublic\AppData\Local\Temp\ などです。 これらの一時ファイルの保存場所を柔軟に設定するには、一時データをステージングするカスタムの場所を指定します。

Type:String
Aliases:TemporaryDirectory, StagingArea
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDeviceAffinity

Configuration Manager でユーザー中心の管理をサポートするには、メディアでユーザーを移動先のコンピューターに関連付ける方法を指定します。 OS 展開でユーザー デバイスアフィニティをサポートする方法の詳細については、「ユーザーを宛先コンピューターに関連付 ける」を参照してください。

  • DoNotAllow: ユーザーのデバイスアフィニティを許可しない。 メディアは、ユーザーを移動先のコンピューターに関連付けるわけではありません。 このシナリオでは、タスク シーケンスは OS の展開時にユーザーを移動先のコンピューターに関連付けしません。

  • AdministratorApproval: ユーザー デバイスアフィニティ保留中の管理者の承認を許可します。 メディアは、承認を付与した後、ユーザーを移動先のコンピューターに関連付ける。 この機能は、OS を展開するタスク シーケンスのスコープに基づいて行います。 このシナリオでは、タスク シーケンスによって、指定したユーザーと移動先コンピューターとの間にリレーションシップが作成されます。 その後、OS を展開する前に、管理ユーザーからの承認を待ちます。

  • AutoApproval: 自動承認を使用してユーザー デバイスのアフィニティを許可します。 メディアは、ユーザーを移動先のコンピューターに自動的に関連付ける。 この機能は、OS を展開するタスク シーケンスのアクションに基づいて行います。 このシナリオでは、タスク シーケンスは、OS を展開先のコンピューターに展開するときに、指定したユーザーと移動先コンピューターの間にリレーションシップを作成します。

Type:UserDeviceAffinityType
Accepted values:DoNotAllow, AdministratorApproval, AutoApproval
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Variable

このメディアからのタスク シーケンスの展開中に使用するタスク シーケンス変数のハッシュテーブルを指定します。

Type:Hashtable
Aliases:TaskSequenceVariables, Variables
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Version

このメディアのバージョンを指定するオプションの文字列値で、追跡およびリビジョンの目的に役立ちます。 最大長は 32 文字です。

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

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

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

入力

なし

出力

System.Object

メモ

コマンドレットエイリアス: New-CMPrestagedMedia