New-CMPrestageMedia
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 イメージを事前設定するファイルを作成します。 詳細については、「 事前設定されたメディアを計画する」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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 に求めるメッセージを表示できるようにします。 このコマンドレットを実行するには、管理者特権のアクセス許可が必要です。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowUnattended
無人 OS の展開を許可するには、このパラメーターを追加します。 無人 OS の展開では、ネットワーク構成やオプションのタスク シーケンスの入力を求められません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowUnknownMachine
Configuration Manager が不明なコンピューターをプロビジョニングできるようにするには、このパラメーターを追加します。 不明なコンピューターは、サイトがまだ検出されていないコンピューターです。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Application
メディア ファイルの一部として含めるアプリケーション オブジェクトの配列を指定します。 タスク シーケンスがこのコンテンツを参照している場合は、最初にコンテンツをローカルで検索します。 コンテンツがメディアにない場合、タスク シーケンスは通常どおりネットワークからコンテンツをダウンロードしようとします。 アプリケーション オブジェクトを取得するには、 Get-CMApplication コマンドレットを 使用します。
型: | IResultObject[] |
Aliases: | Applications |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-BootImage
ブート イメージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMBootImage コマンドレットを 使用します。
型: | IResultObject |
Aliases: | BootImagePackage |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CertificateExpireTime
HTTP 通信用に自己署名メディア証明書を作成する場合、このパラメーターは証明書の有効期限の日付と時刻を指定します。 後で datetime を十分に指定します。 この証明書の有効期限が切れると、起動可能なメディアを使用できません。 開始日を設定するには、 -CertificateStartTime パラメーターを使用します。
例:
$date = [datetime]::p arseexact("11/16/2021", 'MM/dd/yyyy', $null)
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CertificatePassword
-CertificatePath パラメーターを使用して HTTPS 通信用の PKI 証明書をインポートする場合は、このパラメーターを使用して証明書ファイルのパスワードを指定します。
型: | SecureString |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CertificatePath
インポートする PKI 証明書のパスを指定します。 -CertificatePassword パラメーターを使用して、この証明書ファイルのパスワードを指定します。 HTTPS クライアント通信用にサイトを構成する場合は、これらのパラメーターを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CertificateStartTime
HTTP 通信用の自己署名証明書を作成するには、このパラメーターで証明書の開始日と時刻を指定します。 有効期限を設定するには、 -CertificateExpireTime パラメーターを使用します。 この日付までは、起動可能なメディアを使用できません。
例:
$date = [datetime]::p arseexact("11/16/2020", 'MM/dd/yyyy', $null)
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Comment
メディアの詳細を提供する省略可能な文字列。 このメディアの構成方法や使用方法を説明すると便利です。 最大長は 127 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CreatedBy
このメディアを作成したユーザーを指定する省略可能な文字列。これは追跡目的に役立ちます。 最大長は 50 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DistributionPoint
このメディアのコンテンツを配布する 1 つ以上の配布ポイント オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMDistributionPoint コマンドレットを 使用します。
型: | IResultObject[] |
Aliases: | DistributionPoints |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DriverPackage
メディア ファイルの一部として含めるドライバー パッケージ オブジェクトの配列を指定します。 タスク シーケンスがこのコンテンツを参照している場合は、コンテンツをローカルで検索します。 コンテンツがメディアにない場合、タスク シーケンスは通常どおりネットワークからコンテンツをダウンロードしようとします。 このオブジェクトを取得するには、 Get-CMDriverPackage コマンドレットを 使用します。
型: | IResultObject[] |
Aliases: | DriverPackages, PackageDriver, PackageDrivers |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Force
確認を求めずにコマンドを実行します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IncludeApplicationDependency
関連付けられているアプリケーションの依存関係を検出し、このメディアに追加するには、このパラメーターを追加します。
型: | SwitchParameter |
Aliases: | IncludeApplicationDependencies |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ManagementPoint
メディアが初期通信で使用する 1 つ以上の管理ポイント オブジェクトを指定します。 メディアの実行時の通信方法を決定するには、 -MediaMode パラメーターを使用します。 このオブジェクトを取得するには、 Get-CMManagementPoint コマンドレットを使用します。
型: | IResultObject[] |
Aliases: | ManagementPoints |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MediaMode
クライアントが管理ポイントを検索してデプロイ情報を取得する方法を指定します。
Dynamic
: メディアは管理ポイントに接続し、サイト境界内のクライアントの場所に基づいてクライアントを別の管理ポイントにリダイレクトします。SiteBased
: メディアは、 -ManagementPoint パラメーターで指定された管理ポイントを通信します。
型: | MediaMode |
指定可能な値: | Dynamic, SiteBased |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MediaPassword
セキュリティで保護された文字列パスワードを指定して、タスク シーケンス メディアを保護します。 このメディアを使用してデバイスを起動する場合は、パスワードを入力して続行する必要があります。
型: | SecureString |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoAutoRun
このパラメーターを追加して、メディアに autorun.inf ファイルを含めます。 Configuration Manager では、既定では追加されません。 このファイルは、一般的にマルウェア対策製品によってブロックされます。 Windows の自動実行機能の詳細については、「 自動実行が有効な CD-ROM アプリケーションの作成」を参照してください。 シナリオに必要な場合は、このパラメーターを追加してファイルを含めます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OperatingSystemImage
このメディアに含める OS イメージ パッケージ オブジェクトを指定します。 OperatingSystemImageIndex パラメーターを使用して、イメージ パッケージ内のイメージ インデックスを指定します。 このオブジェクトを取得するには、 Get-CMOperatingSystemImage コマンドレットを 使用します。
型: | IResultObject |
Aliases: | OperatingSystemImagePackage |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OperatingSystemImageIndex
OperatingSystemImage パラメーターからイメージ パッケージ内のイメージ インデックスを指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Package
メディア ファイルに含めるパッケージ オブジェクトの配列を指定します。 タスク シーケンスがこのコンテンツを参照している場合は、コンテンツをローカルで検索します。 コンテンツがメディアにない場合、タスク シーケンスは通常どおりネットワークからコンテンツをダウンロードしようとします。 このオブジェクトを取得するには、 Get-CMPackage コマンドレットを使用します。
型: | IResultObject[] |
Aliases: | Packages |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
作成するメディア ファイルへのパス。 形式は、ドライブ/ディレクトリ パスまたは有効なネットワーク パスです。 例:
C:\media\prestaged1.wim
\\server\share\prestaged1.wim
型: | String |
Aliases: | MediaPath, OutputPath, DriveName |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PrestartCommand
タスク シーケンスを開始する前に実行するコマンド ラインを指定します。 詳細については、「 タスク シーケンス メディアの事前開始コマンド」を参照してください。
型: | String |
Aliases: | PreExecCommandLine |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PrestartPackage
PrestartCommand を指定する場合は、このパラメーターを使用して、必要に応じて事前開始コンテンツのパッケージを指定します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SiteCode
バージョン 2010 以降に適用されます。 このパラメーターを ManagementPoint パラメーターと共に使用して、サイト コードを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TaskSequence
このメディアを実行するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TemporaryFolder
メディア作成プロセスでは、多くの一時的なドライブ領域が必要な場合があります。 既定では、Configuration Manager は現在のユーザーの一時ディレクトリである $env:temp
を使用します。 たとえば、「 C:\Users\jqpublic\AppData\Local\Temp\
」のように入力します。 これらの一時ファイルを格納する場所の柔軟性を高めるために、一時データをステージングするためのカスタムの場所を指定します。
型: | String |
Aliases: | TemporaryDirectory, StagingArea |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserDeviceAffinity
Configuration Manager でユーザー中心の管理をサポートするには、メディアを対象のコンピューターにユーザーを関連付ける方法を指定します。 OS 展開がユーザー デバイス アフィニティをサポートする方法の詳細については、「ユーザー を移行先コンピューターに関連付ける」を参照してください。
DoNotAllow
: ユーザー デバイス アフィニティを許可しません。 メディアは、ユーザーを対象のコンピューターに関連付けません。 このシナリオでは、OS を展開するときに、タスク シーケンスによってユーザーが移行先コンピューターに関連付けられません。AdministratorApproval
: 管理者の承認待ちのユーザー デバイス アフィニティを許可します。 メディアは、承認を付与した後、対象のコンピューターにユーザーを関連付けます。 この機能は、OS を展開するタスク シーケンスのスコープに基づいています。 このシナリオでは、タスク シーケンスによって、指定したユーザーと移行先コンピューターの間にリレーションシップが作成されます。 その後、管理ユーザーからの承認を待ってから OS を展開します。AutoApproval
: 自動承認でユーザー デバイス アフィニティを許可します。 メディアは、ユーザーを対象のコンピューターに自動的に関連付けます。 この機能は、OS を展開するタスク シーケンスのアクションに基づいています。 このシナリオでは、タスク シーケンスは、OS を移行先コンピューターに展開するときに、指定したユーザーと移行先コンピューターの間に関係を作成します。
型: | UserDeviceAffinityType |
指定可能な値: | DoNotAllow, AdministratorApproval, AutoApproval |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Variable
このメディアからのタスク シーケンスのデプロイ中に使用するタスク シーケンス変数のハッシュテーブルを指定します。
型: | Hashtable |
Aliases: | TaskSequenceVariables, Variables |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Version
このメディアのバージョンを指定するための省略可能な文字列値。これは、追跡とリビジョンの目的に役立ちます。 最大長は 32 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object
メモ
コマンドレットエイリアス: New-CMPrestagedMedia