New-CMBootableMedia

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

起動可能なメディアを作成します。

構文

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 (ベア メタル) に新しいバージョンのコンピューターをインストールするか、既存のコンピューターを置き換え、設定を転送します。

注意

このコマンドレットを実行するには、管理者特権のアクセス許可が必要です。

詳細については、「タスク シーケンス メディア の概要」を参照してください。

注意

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

例

例 1: 起動可能なメディアを作成する

最初のコマンドは、Boot image (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

このパラメーターを追加して、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
-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
-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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
-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
-FormatMedia

MediaType が指定されている場合は、このパラメーターを追加して、リムーバブル USB ドライブを FAT32 として書式設定し、起動 Usb 可能にできます。

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

メディアが CD/DVD セットか、リムーバブル USB ドライブかを指定します。

Type:MediaInputType
Accepted values:Usb, CdDvd
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
-Path

MediaType が指定されている場合は、Configuration Manager が出力ファイルを書き込む CdDvd 名前とパスを指定します。 たとえば、C:\output\boot.iso などです。

Type:String
Aliases:MediaPath, OutputPath, DriveName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrestartCommand

タスク シーケンスの前に実行される事前開始コマンドを指定します。 事前開始コマンドは、タスク シーケンスを実行して OS をインストールする前に、WINDOWS PE でユーザーと対話できるスクリプトまたは実行可能ファイルです。 コマンドが PE に対してネイティブWindows場合は 、PrestartPackageを使用してコマンドのファイルを含めます。

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

PrestartCommand パラメーターを使用する場合は、このパラメーターを使用して、事前開始コマンドのファイルを含むパッケージを指定します。 パッケージ オブジェクトを取得するには 、Get-CMPackage コマンドレットを使用 します。

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

ハッシュテーブルで 1 つ以上のタスク シーケンス変数と値を指定します。 タスク シーケンス変数は、タスク シーケンスの展開中に使用される名前と値のペアです。

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

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

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

入力

なし

出力

System.Object