New-CMTaskSequence

タスク シーケンスを作成します。

構文

New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-BuildOperatingSystemImage]
   [-ClientPackagePackageId <String>]
   [-CreatedBy <String>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-ImageDescription <String>]
   [-ImageVersion <String>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   [-MaximumServerConnection <Int32>]
   -Name <String>
   -OperatingSystemFileAccount <String>
   [-OperatingSystemFileAccountPassword <SecureString>]
   -OperatingSystemFilePath <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-CaptureLocallyUsingLink <Boolean>]
   [-CaptureNetworkSetting <Boolean>]
   [-CaptureUserSetting <Boolean>]
   [-CaptureWindowsSetting <Boolean>]
   [-ClientPackagePackageId <String>]
   [-ConfigureBitLocker <Boolean>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   [-InstallOperatingSystemImage]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   -Name <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-PartitionAndFormatTarget <Boolean>]
   [-ProductKey <String>]
   [-SaveLocally <Boolean>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-UserStateMigrationToolPackageId <String>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   -Name <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-UpgradeOperatingSystem]
   -UpgradePackageId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-BootImagePackageId <String>]
   [-CustomTaskSequence]
   [-Description <String>]
   [-HighPerformance <Boolean>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

タスク シーケンスを作成するには、このコマンドレットを使用します。 通常、タスク シーケンスを使用して OS をクライアントに展開しますが、さまざまな目的で使用できます。 詳細については、「 タスク シーケンスを管理してタスクを自動化する」を参照してください。

注:

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

例 1: カスタム タスク シーケンスを作成する

この例では、最初にコマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。

このコマンドは、Custom という名前の空のタスク シーケンスを作成 します

$parameters = @{
  CustomTaskSequence = $true
  Name = "Custom"
  Description = "NewCustom parameter set"
  HighPerformance = $false
  BootImagePackageId = "XYZ00002"
}

New-CMTaskSequence @parameters

例 2: OS イメージをインストールするタスク シーケンスを作成する

この例では、最初にコマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。

このコマンドは、 OS イメージをインストールする Os イメージのインストール という名前のタスク シーケンスを作成します。 また、このシナリオに適用される他のパラメーターも含まれています。

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  InstallOperatingSystemImage = $true
  Name = "Install OS image"
  Description = "NewInstallOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  CaptureNetworkSetting = $true
  CaptureUserSetting = $true
  SaveLocally = $true
  CaptureLocallyUsingLink = $true
  UserStateMigrationToolPackageId = "XYZ00001"
  CaptureWindowsSetting = $true
  ConfigureBitLocker = $true
  PartitionAndFormatTarget = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "DomainType"
  DomainAccount = "contoso\jqpublic"
  DomainName = "contoso"
  DomainOrganizationUnit = "LDAP://OU=Workstations,OU=Devices,DC=na,DC=contoso,DC=com"
  DomainPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $false
  SoftwareUpdateStyle = "All"
}

New-CMTaskSequence @parameters

例 3: OS をビルドしてキャプチャするタスク シーケンスを作成する

この例では、最初にコマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。

この例では、指定された場所とアカウントを使用して OS イメージをビルド してキャプチャする、Build and capture という名前のタスク シーケンスを作成します。 また、このシナリオに適用される他のパラメーターも含まれています。

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  BuildOperatingSystemImage = $true
  Name = "Build and capture"
  Description = "NewBuildOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "WorkgroupType"
  WorkgroupName = "groupwork"
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $true
  SoftwareUpdateStyle = "All"
  OperatingSystemFilePath = "\\server1\images\capture.wim"
  ImageDescription = "image description"
  ImageVersion = "image version 1"
  CreatedBy = "jqpublic"
  OperatingSystemFileAccount = "contoso\jqpublic" 
  OperatingSystemFileAccountPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
}

New-CMTaskSequence @parameters

例 4: OS をアップグレードするタスク シーケンスを作成する

このコマンドは、 インプレース アップグレード という名前のタスク シーケンスを作成し、ID XYZ02EBAを使用してアップグレード パッケージを使用して OS をアップグレードすることを指定します。

New-CMTaskSequence -UpgradeOperatingSystem -Name "In-place upgrade" -UpgradePackageId "XYZ02EBA" -SoftwareUpdateStyle All

パラメーター

-ApplicationName

タスク シーケンス中にインストールするアプリケーション名の配列を指定します。 このパラメーターは、[ アプリケーションのインストール] タスク シーケンス ステップを構成します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ApplyAll

ビルドとキャプチャのシナリオでは、このパラメーターの状態によって次の動作が決まります。

型:Boolean
Aliases:ApplyAllImages
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BootImagePackageId

OS を展開するタスク シーケンスで使用するブート イメージ パッケージの ID を指定します。 この値は、 XYZ00005などの標準パッケージ ID です。

このパラメーターは、タスク シーケンスのプロパティを構成します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BuildOperatingSystemImage

このパラメーターを追加して、ビルドとキャプチャのシナリオのタスク シーケンスを作成します。 詳細については、「OS を キャプチャするためのタスク シーケンスの作成」を参照してください。

型:SwitchParameter
Aliases:BuildOperatingSystemImageOption
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

SaveLocally パラメーターを有効にしてユーザー設定とファイルをローカルに保存する場合は、ファイルをコピーするのではなく、リンクを使用してローカルにキャプチャする$trueにこのパラメーターを設定します。 Configuration Manager がユーザーの状態をローカルに格納するために使用するリンクは、ハード リンクと呼ばれます。

SaveLocally$false場合、コマンドレットはこのパラメーターを無視します。

このパラメーターは、[ ユーザー状態のキャプチャ ] ステップを構成します。

型:Boolean
Aliases:CaptureLocallyUsingLinks
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CaptureNetworkSetting

タスク シーケンスでネットワーク設定をキャプチャできるようにするには、このパラメーターを $true に設定します。 このオプションを有効にすると、タスク シーケンスに [ ネットワーク設定のキャプチャ] ステップが含まれます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CaptureUserSetting

タスク シーケンスでユーザー設定とファイルをキャプチャできるようにするには、このパラメーターを $true に設定します。 このオプションを有効にすると、タスク シーケンスに [ユーザー状態のキャプチャ ] ステップが含まれます。 UserStateMigrationToolPackageId パラメーターも使用します。

SaveLocallyCaptureLocallyUsingLink を使用して、タスク シーケンスがユーザーの状態を保存する場所を構成します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CaptureWindowsSetting

タスク シーケンスで Windows 設定をキャプチャできるようにするには、このパラメーターを $true に設定します。 このオプションを有効にすると、タスク シーケンスに [Windows 設定のキャプチャ] ステップが含まれます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClientPackagePackageId

タスク シーケンスの実行時にインストールするクライアント パッケージの ID を指定します。 この値は、 XYZ00003などの標準パッケージ ID です。 サイトの割り当てとクライアントの構成は自動的に行われます。 InstallationProperty パラメーターを使用して、追加のインストール パラメーターを指定できます。

このパラメーターは、 セットアップ Windows および ConfigMgr タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConfigureBitLocker

このパラメーターを $true に設定して、BitLocker で使用するタスク シーケンスを構成します。 このオプションを有効にすると、タスク シーケンスには次の手順が含まれます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CreatedBy

ビルドとキャプチャのシナリオでは、キャプチャされたイメージ ファイルの作成者に対応する省略可能な文字列を指定します。 最大の長さは、255 文字です。

このパラメーターは、 OS イメージのキャプチャ タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CustomTaskSequence

このパラメーターを追加して、ステップを含むカスタム タスク シーケンスを作成します。 詳細については、「 カスタム タスク シーケンスの作成」を参照してください。

その後、35 個の New-CMTSStep コマンドレットを使用して、カスタム タスク シーケンスにステップを追加できます。 詳細については、「 タスク シーケンスの手順について」を参照してください。 各セクションでは、タスク シーケンスの手順について説明し、関連するコマンドレットへのリンクを示します。

型:SwitchParameter
Aliases:CustomOption
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

タスク シーケンスの説明 (省略可能) を指定します。 最大長は 512 文字です。 このパラメーターは、タスク シーケンスのプロパティを構成します。

型:String
Aliases:TaskSequenceDescription
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DomainAccount

コンピューターをドメインに参加させるために必要なアクセス許可を持つアカウントを指定します。 次の形式を使用します: Domain\User。 詳細については、「 ask sequence domain join account」を参照してください。

DomainName パラメーターを使用してドメイン名を指定し、DomainPassword を使用してこのアカウントのパスワードを指定します。

このパラメーターは 、[ネットワーク設定の適用] タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DomainName

タスク シーケンスを実行するときにコンピューターを参加させるドメインの名前を指定します。 このパラメーターは 、[ネットワーク設定の適用] タスク シーケンス ステップを構成します。

DomainAccount パラメーターを使用して、このドメインに参加するためのアクセス許可を持つアカウントを指定します。 DomainOrganizationUnit パラメーターを使用して、コンピューター アカウントを作成する OU を指定することもできます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DomainOrganizationUnit

ドメインにコンピューター アカウントを作成するドメイン組織単位 (OU) を指定します。 この値の形式は、ライトウェイト ディレクトリ アクセス プロトコル (LDAP) パスです (例: LDAP//OU=OSD staging,DC=contoso,DC=com)。 DomainName パラメーターで指定したドメインに OU を指定します。

既存のコンピューター アカウントが既に OU に存在する場合、Active Directory では OU の変更は許可されないため、この設定は無視されます。

このパラメーターは 、[ネットワーク設定の適用] タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DomainPassword

DomainAccount パラメーターで指定したアカウントのパスワードのセキュリティで保護された文字列を指定します。

このパラメーターは 、[ネットワーク設定の適用] タスク シーケンス ステップを構成します。

型:SecureString
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-GeneratePassword

ローカル管理者パスワードをランダムに生成し、アカウントを無効にするには、このパラメーターを $true に設定します。 この構成をお勧めします。

このパラメーターは、[ Windows 設定の適用] タスク シーケンス ステップを構成します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-HighPerformance

このパラメーターを $true に設定して、タスク シーケンス オプションを高パフォーマンスの電源プランとして実行できるようにします。 このパラメーターは、タスク シーケンスのプロパティを構成します。 詳細については、「 電源プランのパフォーマンスの向上」を参照してください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IgnoreInvalidApplication

このパラメーターを $true に設定した場合、アプリケーションのインストールが失敗した場合、タスク シーケンスは一覧にアプリケーションをインストールし続けます。 ApplicationName パラメーターでこのパラメーターを使用します。

このパラメーターは、[ アプリケーションのインストール] タスク シーケンス ステップを構成します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ImageDescription

ビルドとキャプチャのシナリオでは、キャプチャされたイメージ ファイルを記述する省略可能な文字列を指定します。 最大の長さは、255 文字です。

このパラメーターは、 OS イメージのキャプチャ タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ImageVersion

ビルドとキャプチャのシナリオでは、キャプチャされたイメージ ファイルのバージョンとして省略可能な文字列を指定します。 この値を定義します。OS バージョンである必要はありません。 最大長は 32 文字です。

このパラメーターは、 OS イメージのキャプチャ タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InstallationLicensingMode

この設定は、サポートされなくなった従来のバージョンの Windows にのみ適用されます。 バージョン 2010 以降、タスク シーケンス エディターに設定が表示されなくなります。 この設定を引き続き使用する既存のタスク シーケンスは、引き続き同じように機能します。

型:ServerLicensingMode
指定可能な値:NonSpecify, PerSeat, PerServer
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InstallationProperty

タスク シーケンスが Configuration Manager クライアントをインストールするときに使用する追加のインストール プロパティを指定します。 サイトの割り当てと既定の構成は、タスク シーケンスによって自動的に指定されます。 複数のインストール プロパティを入力するには、スペースで区切ります。 プロパティにスペースが含まれている場合は、引用符 (") で囲みます。 詳細については、「 Configuration Manager のクライアント インストール パラメーターとプロパティについて」を参照してください。

この一覧に SMSSITECODE を含めることはできません。

このパラメーターは、 セットアップ Windows および ConfigMgr タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InstallOperatingSystemImage

このパラメーターを追加して、OS イメージのインストール シナリオのタスク シーケンスを作成します。 詳細については、「OS を インストールするためのタスク シーケンスの作成」を参照してください。

型:SwitchParameter
Aliases:InstallOperatingSystemImageOption
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JoinDomain

このパラメーターを使用して 、[ネットワーク設定の適用] タスク シーケンス ステップを構成します。 コンピューターは、ワークグループまたはドメインに参加する必要があります。

  • DomainType: ドメインに参加します。 DomainName、DomainAccountDomainPassword も指定します。 DomainOrganizationUnit を使用することもできます。

  • WorkgroupType: ワークグループに参加します。 ワークグループ名も指定 します。 この値は 、BuildOperatingSystemImage パラメーターと共に使用します。 ビルドとキャプチャのシナリオでは、タスク シーケンスはイメージをキャプチャする前に常にワークグループに参加します。

型:JoinType
指定可能な値:DomainType, WorkgroupType
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-LocalAdminPassword

GeneratePassword に推奨されるオプションを使用しない場合は、このパラメーターを使用して、ローカル管理者パスワードとしてセキュリティで保護された文字列を指定します。

このパラメーターは、[ Windows 設定の適用] タスク シーケンス ステップを構成します。

型:SecureString
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaximumServerConnection

この設定は、サポートされなくなった従来のバージョンの Windows にのみ適用されます。 バージョン 2010 以降、タスク シーケンス エディターに設定が表示されなくなります。 この設定を引き続き使用する既存のタスク シーケンスは、引き続き同じように機能します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

タスク シーケンスの名前を指定します。 最大長は 50 文字です。 このパラメーターは、タスク シーケンスのプロパティを構成します。

型:String
Aliases:TaskSequenceName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OperatingSystemFileAccount

ビルドとキャプチャのシナリオでは、 OperatingSystemFilePath パラメーターで指定したネットワーク共有に対するアクセス許可を持つドメイン アカウントの名前を指定します。 OperatingSystemFileAccountPassword を使用して、アカウント のパスワードを設定します。

このパラメーターは、 OS イメージのキャプチャ タスク シーケンス ステップを構成します。

型:String
Aliases:CaptureOperatingSystemFileAccount
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OperatingSystemFileAccountPassword

ビルドとキャプチャのシナリオでは、 OperatingSystemFileAccount のパスワードにセキュリティで保護された文字列を指定します。

このパラメーターは、 OS イメージのキャプチャ タスク シーケンス ステップを構成します。

型:SecureString
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OperatingSystemFilePath

ビルドとキャプチャのシナリオでは、Configuration Manager がキャプチャした OS イメージを格納するために使用するネットワークの場所へのファイル パスを指定します。 パスには、 .wim ファイル拡張子を持つファイル名が含まれます。 OperatingSystemFileAccountOperatingSystemFileAccountPassword を使用して、この場所にアクセスできるアカウントを指定します。

このパラメーターは、 OS イメージのキャプチャ タスク シーケンス ステップを構成します。

型:String
Aliases:CaptureOperatingSystemFilePath
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OperatingSystemImageIndex

[ OS イメージの適用 ] タスク シーケンス ステップにインストールする OS イメージのインデックスを指定します。

型:UInt32
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OperatingSystemImagePackageId

インストールする OS イメージ パッケージの ID を指定します。 OperatingSystemImageIndex を使用して、イメージ インデックスを指定します。 この値は、 XYZ00050などの標準パッケージ ID です。

このパラメーターは、 OS イメージの適用 タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartitionAndFormatTarget

OS をインストールする前に、このパラメーターをタスク シーケンスの $true に設定して、ターゲット コンピューターをパーティション分割してフォーマットします。

このパラメーターは、[ ディスクのフォーマット] および [パーティション ディスク] タスク シーケンスステップを構成します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProductKey

OS インストールの Windows プロダクト キーを指定します。

このパラメーターは、[ Windows 設定の適用] タスク シーケンス ステップを構成します。

型:String
Aliases:InstallationProductKey
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SaveLocally

CaptureUserSetting パラメーターを有効にする場合は、このパラメーターを使用して、キャプチャされたユーザー状態をタスク シーケンスで保存する場所を決定します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SoftwareUpdateStyle

タスク シーケンス中にソフトウェア更新プログラムをインストールするかどうかを指定します。 値によって、ソフトウェア更新プログラムの展開の種類が決まります。

  • All: インストール、すべてのソフトウェア更新プログラムで使用できます
  • Mandatory: インストール、必須のソフトウェア更新プログラムにのみ必要です
  • NoInstall: ソフトウェア更新プログラムをインストールしない

このパラメーターは、[ ソフトウェア更新プログラムのインストール ] タスク シーケンス ステップを構成します。

型:SoftwareUpdateStyleType
指定可能な値:All, Mandatory, NoInstall
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TimeZone

Windows のこのインストールの既定のタイム ゾーンを指定します。 タイム ゾーン オブジェクトを取得するには、組み込みの Get-TimeZone コマンドレットを使用します。

このパラメーターは、[ Windows 設定の適用] タスク シーケンス ステップを構成します。

型:TimeZoneInfo
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UpgradeOperatingSystem

このパラメーターを追加して、OS アップグレード シナリオのタスク シーケンスを作成します。 詳細については、「OS を アップグレードするためのタスク シーケンスの作成」を参照してください。

型:SwitchParameter
Aliases:UpgradeOperatingSystemOption
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UpgradePackageId

使用する OS アップグレード パッケージの ID を指定します。 この値は、 XYZ00052などの標準パッケージ ID です。

このパラメーターは、 アップグレード OS タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserStateMigrationToolPackageId

CaptureUserSetting$true に設定する場合は、このパラメーターを使用して、ユーザー状態移行ツール (USMT) パッケージの ID を指定します。 この値は、 XYZ00012などの標準パッケージ ID です。

このパラメーターは、ユーザー状態のキャプチャとユーザー状態の復元の手順を構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WorkgroupName

JoinDomain パラメーターを WorkgroupType に設定した場合は、このパラメーターを使用してワークグループ名を指定します。 このパラメーターは 、[ネットワーク設定の適用] タスク シーケンス ステップを構成します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequencePackage」を参照してください。

[ Windows 設定の適用] タスク シーケンス ステップで、このコマンドレットは、コマンドレットを実行するユーザーに ユーザー名 の値を設定し、 組織名 をコマンドレットを実行するコンピューター名に設定します。

このコマンドレットを使用して、すべてのタスク シーケンスとステップの設定を構成することはできません。 その他の設定を構成するには、 Set-CMTaskSequence コマンドレットと Set-CMTSStep コマンドレット ( Set-CMTSStepApplyOperatingSystem など) を使用します。