New-CMTaskSequence

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

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

構文

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 をクライアントに展開しますが、さまざまな目的で使用できます。 詳細については、「 タスク シーケンスを管理してタスクを自動化する」を参照してください。

注:

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

例

例 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

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplyAll

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

Type:Boolean
Aliases:ApplyAllImages
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BootImagePackageId

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

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

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

-BuildOperatingSystemImage

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

Type:SwitchParameter
Aliases:BuildOperatingSystemImageOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CaptureLocallyUsingLink

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

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

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

Type:Boolean
Aliases:CaptureLocallyUsingLinks
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CaptureNetworkSetting

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CaptureUserSetting

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

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CaptureWindowsSetting

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientPackagePackageId

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

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

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

-ConfigureBitLocker

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

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

-CreatedBy

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

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

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

-CustomTaskSequence

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

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

Type:SwitchParameter
Aliases:CustomOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Aliases:TaskSequenceDescription
Position:Named
Default value:None
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

-DomainAccount

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

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

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

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

-DomainName

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

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

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

-DomainOrganizationUnit

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

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

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

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

-DomainPassword

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

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

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

-GeneratePassword

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

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HighPerformance

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IgnoreInvalidApplication

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

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageDescription

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

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

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

-ImageVersion

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

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

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

-InstallationLicensingMode

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

Type:ServerLicensingMode
Accepted values:NonSpecify, PerSeat, PerServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstallationProperty

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

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

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

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

-InstallOperatingSystemImage

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

Type:SwitchParameter
Aliases:InstallOperatingSystemImageOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JoinDomain

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

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

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

Type:JoinType
Accepted values:DomainType, WorkgroupType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LocalAdminPassword

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

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

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumServerConnection

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-OperatingSystemFileAccount

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

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

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

-OperatingSystemFileAccountPassword

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

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

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemFilePath

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

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

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

-OperatingSystemImageIndex

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

Type:UInt32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImagePackageId

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

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

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

-PartitionAndFormatTarget

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

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

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

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

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

-SaveLocally

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateStyle

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

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

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

Type:SoftwareUpdateStyleType
Accepted values:All, Mandatory, NoInstall
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeZone

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

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

Type:TimeZoneInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpgradeOperatingSystem

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

Type:SwitchParameter
Aliases:UpgradeOperatingSystemOption
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UpgradePackageId

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

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

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

-UserStateMigrationToolPackageId

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

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

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

-WorkgroupName

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

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

入力

None

出力

IResultObject

メモ

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

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

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