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:\>)。詳細については、「作業の開始」を参照してください。

例

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

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

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

3 番目のコマンドは、サイトコード CM1で dist01.contoso.com というサイトシステムサーバーの配布ポイントオブジェクトを取得し、そのオブジェクトを $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

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

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

-AllowUnattended

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

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

-AllowUnknownMachine

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

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

-Application

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

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

-BootImage

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

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

-CertificateExpireTime

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

以下に例を示します。

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

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

-CertificatePassword

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

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

-CertificatePath

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

Type:	String
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

メディアの詳細を提供する省略可能な文字列。このメディアの構成方法や使用方法を説明すると便利です。最大長は 127 文字です。

Type:	String
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

-CreatedBy

このメディアを作成したユーザーを指定する省略可能な文字列。これは追跡目的に役立ちます。最大長は 50 文字です。

Type:	String
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

-DistributionPoint

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

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

-DriverPackage

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

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

-Force

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

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

-IncludeApplicationDependency

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

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

-ManagementPoint

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

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

-MediaMode

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

Dynamic: メディアは管理ポイントに接続し、サイト境界内のクライアントの場所に基づいてクライアントを別の管理ポイントにリダイレクトします。
SiteBased: メディアは、 -ManagementPoint パラメーターで指定された管理ポイントを通信します。

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

-MediaPassword

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

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

-NoAutoRun

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

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

-OperatingSystemImage

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

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

-OperatingSystemImageIndex

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

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

-Package

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

Type:	IResultObject[]
Aliases:	Packages
Position:	Named
Default value:	None
Required:	False
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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PrestartCommand

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

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

-PrestartPackage

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

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

-SiteCode

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

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

-TaskSequence

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

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
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
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Variable

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

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

-Version

このメディアのバージョンを指定するための省略可能な文字列値。これは、追跡とリビジョンの目的に役立ちます。最大長は 32 文字です。

Type:	String
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

入力

None

出力

System.Object

メモ

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