New-CMWindows10EditionUpgrade
Windows 10 エディションのアップグレード ポリシーを作成します。
構文
New-CMWindows10EditionUpgrade
[-Description <String>]
[-EditionUpgradeWithClient <Boolean>]
[-LicenseFile <String>]
-Name <String>
[-ProductKey <String>]
[-WindowsEdition <WindowsEditionType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Windows 10 エディションのアップグレード ポリシーを作成します。 プロダクト キーまたはライセンス情報を指定して、Windows 10 を別のエディションにアップグレードします。 詳細については、「 Configuration Manager を使用して Windows デバイスを新しいエディションにアップグレードする」を参照してください。
例
例 1
New-CMWindows10EditionUpgrade -Name "NewEditionPolicyByKey" -WindowsEdition Windows10Enterprise -ProductKey "123ab-cd456-789ef-2j3k4-0ghi1"パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
ポリシーの説明 (省略可能) を指定します。
| 型: | String |
| Aliases: | LocalizedDescription |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EditionUpgradeWithClient
このパラメーターを使用して、作成するエディションのアップグレードの種類を指定します。
-
$true: ポリシーは、Configuration Manager クライアントで管理されるデバイス用です。 ProductKey パラメーターを使用して、ライセンス キーを指定します。 -
$false: このポリシーは、オンプレミスの MDM で管理する Windows 10 Mobile を実行しているデバイスを対象としています。 LicenseFile パラメーターを使用して、XML ライセンス ファイルを指定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LicenseFile
EditionUpgradeWithClient パラメーターを $false に設定する場合は、このパラメーターを使用して XML ライセンス ファイルへのパスを指定します。 Microsoft ボリューム ライセンス サービス センター (VLSC) からライセンス ファイルを取得します。 このファイルには、ポリシーを対象とするすべてのデバイス上の新しいバージョンの Windows のライセンス情報が含まれています。 ライセンス XML を含む Windows 10 Mobile Enterprise の ISO ファイルをダウンロードします。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
この Windows 10 エディションのアップグレード ポリシーの名前を指定します。
| 型: | String |
| Aliases: | LocalizedDisplayName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ProductKey
EditionUpgradeWithClient パラメーターを $true に設定する場合は、このパラメーターを使用して、新しいバージョンの Windows の有効なプロダクト キーを指定します。 このプロダクト キーには、複数のライセンス認証キー (MAK)、または汎用ボリューム ライセンス キー (GVLK) を指定できます。 GVLK は、キー管理サービス (KMS) クライアント セットアップ キーとも呼ばれます。 詳細については、「 ボリュームライセンス認証の計画」を参照してください。 KMS クライアント セットアップ キーの一覧については、Windows Server ライセンス認証ガイドの 付録 A を参照してください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WindowsEdition
LicenseFile または ProductKey に対応する Windows 10 のターゲット エディションを指定します。
| 型: | WindowsEditionType |
| 指定可能な値: | Windows10Enterprise, Windows10Education, Windows10EnterpriseN, Windows10EducationN, WindowsPhone10, HolographicEnterprise |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject