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

例

例 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 に求めるメッセージを表示できるようにします。 このコマンドレットを実行するには、管理者特権のアクセス許可が必要です。

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

-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

-Confirm

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

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

-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

-FormatMedia

MediaType が の場合はUsb、このパラメーターを追加してリムーバブル USB ドライブを FAT32 としてフォーマットし、起動できるようにします。

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

-MediaType

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

Type:MediaInputType
Accepted values:Usb, CdDvd
Position:Named
Default value:None
Required:True
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

-Path

MediaType が の場合はCdDvd、出力ファイルを書き込む名前とパスConfiguration Manager指定します。 たとえば、「 C:\output\boot.iso 」のように入力します。

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

-PrestartCommand

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

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

-PrestartPackage

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

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

-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

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

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

-WhatIf

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

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

入力

None

出力

System.Object