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
ビルドとキャプチャのシナリオでは、このパラメーターの状態によって次の動作が決まります。
$true
: タスク シーケンスは、OS イメージを適用する前にディスク & パーティションをフォーマットしません。$false
: タスク シーケンスには、OS イメージを適用する前に 、[ディスクのフォーマット] と [パーティション ディスク ] の手順が含まれています。
型: | 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 |
-CaptureLocallyUsingLink
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 パラメーターも使用します。
SaveLocally と CaptureLocallyUsingLink を使用して、タスク シーケンスがユーザーの状態を保存する場所を構成します。
型: | 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、DomainAccount、DomainPassword も指定します。 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
ファイル拡張子を持つファイル名が含まれます。
OperatingSystemFileAccount と OperatingSystemFileAccountPassword を使用して、この場所にアクセスできるアカウントを指定します。
このパラメーターは、 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 パラメーターを有効にする場合は、このパラメーターを使用して、キャプチャされたユーザー状態をタスク シーケンスで保存する場所を決定します。
$true
: タスク シーケンスは、ローカル状態の場所を構成し、ファイルをコピーする代わりにリンクを使用してローカルにキャプチャします。 この値は、[ ユーザー状態のキャプチャ ] ステップを構成します。- CaptureLocallyUsingLink パラメーターを使用して、ハード リンクの使用を構成します。
$false
: タスク シーケンスには、状態移行ポイントを使用する手順が含まれています。 次の手順を構成します。
型: | 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 など) を使用します。