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