New-CMBootableMedia
起動可能なメディアを作成します。
構文
New-CMBootableMedia
[-AllowUacPrompt]
[-AllowUnattended]
[-AllowUnknownMachine]
-BootImage <IResultObject>
[-CertificateExpireTime <DateTime>]
[-CertificatePassword <SecureString>]
[-CertificatePath <String>]
[-CertificateStartTime <DateTime>]
-DistributionPoint <IResultObject[]>
[-Force]
[-FormatMedia]
-ManagementPoint <IResultObject[]>
[-SiteCode <String>]
-MediaMode <MediaMode>
[-MediaPassword <SecureString>]
-MediaType <MediaInputType>
[-NoAutoRun]
-Path <String>
[-PrestartCommand <String>]
[-PrestartPackage <IResultObject>]
[-TemporaryFolder <String>]
[-UserDeviceAffinity <UserDeviceAffinityType>]
[-Variable <Hashtable>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットは、OS のデプロイに使用されるメディアを作成します。 起動可能なメディアには、ブート イメージ、省略可能な事前開始コマンドと関連ファイル、および Configuration Manager ファイルが含まれています。 起動可能なメディアを使用して、新しいバージョンの Windows を新しいコンピューター (ベア メタル) にインストールしたり、既存のコンピューターと転送設定を置き換えたりします。
注:
このコマンドレットを実行するには、管理者特権のアクセス許可が必要です。
詳細については、「 タスク シーケンス メディアの概要」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 起動可能なメディアを作成する
最初のコマンドは、 ブート イメージ (x64) という名前のブート イメージ オブジェクトを取得し、 $BootImage 変数に格納します。 2 番目のコマンドは、 SiteServer01.Contoso.com の配布ポイント ロールを取得し、 $DistributionPoint 変数に格納します。 3 番目のコマンドは、 SiteServer02.Contoso.com の管理ポイント ロールを取得し、 $ManagementPoint 変数に格納します。 最後のコマンドは、動的モードで起動可能なメディアを作成します。 前の変数に格納されているオブジェクトを使用します。
$BootImage = Get-CMBootImage -Name "Boot image (x64)"
$DistributionPoint = Get-CMDistributionPoint -SiteCode CM1
$ManagementPoint = Get-CMManagementPoint -SiteSystemServerName "SiteSystemServer02.Contoso.com"
New-CMBootableMedia -MediaMode Dynamic -MediaType CdDvd -Path "\\Server\share\test.iso" -AllowUnknownMachine -BootImage $BootImage -DistributionPoint $DistributionPoint -ManagementPoint $ManagementPointパラメーター
-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 |
-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 |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DistributionPoint
ブート イメージを配布した 1 つ以上の配布ポイント オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMDistributionPoint コマンドレットを 使用します。
| 型: | IResultObject[] |
| Aliases: | DistributionPoints |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Force
確認を求めずにコマンドを実行します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FormatMedia
MediaType がUsbされている場合は、このパラメーターを追加してリムーバブル USB ドライブを FAT32 としてフォーマットし、起動可能にすることができます。
| 型: | SwitchParameter |
| 配置: | 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 |
-MediaType
メディアが CD/DVD セットかリムーバブル USB ドライブかを指定します。
| 型: | MediaInputType |
| 指定可能な値: | Usb, CdDvd |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NoAutoRun
このパラメーターを追加して、メディアに autorun.inf ファイルを含めます。 Configuration Manager では、既定では追加されません。 このファイルは、一般的にマルウェア対策製品によってブロックされます。 Windows の自動実行機能の詳細については、「 自動実行が有効な CD-ROM アプリケーションの作成」を参照してください。 シナリオに必要な場合は、このパラメーターを追加してファイルを含めます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Path
MediaType がCdDvdされている場合は、Configuration Manager が出力ファイルを書き込む名前とパスを指定します。 たとえば、「 C:\output\boot.iso 」のように入力します。
| 型: | String |
| Aliases: | MediaPath, OutputPath, DriveName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrestartCommand
タスク シーケンスの前に実行される事前開始コマンドを指定します。 事前開始コマンドは、タスク シーケンスを実行して OS をインストールする前に、Windows PE でユーザーと対話できるスクリプトまたは実行可能ファイルです。 コマンドが Windows PE にネイティブでない場合は、 PrestartPackage を使用してコマンドのファイルを含めます。
| 型: | String |
| Aliases: | PreExecCommandLine |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrestartPackage
PrestartCommand パラメーターを使用する場合は、このパラメーターを使用して、prestart コマンドのファイルを含むパッケージを指定します。 パッケージ オブジェクトを取得するには、 Get-CMPackage コマンドレットを使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SiteCode
バージョン 2010 以降に適用されます。 このパラメーターを ManagementPoint パラメーターと共に使用して、サイト コードを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | 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
ハッシュテーブルに 1 つ以上のタスク シーケンス変数と値を指定します。 タスク シーケンス変数は、タスク シーケンスのデプロイ中に使用される名前と値のペアです。
| 型: | Hashtable |
| Aliases: | TaskSequenceVariables, Variables |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object