2015/12/24 追記

WMF 5.0 RTM のインストールによって、環境変数の PSModulePath がデフォルト設定にリセットされるバグが見つかったため、現在ダウンロードセンターから外されています。

修正が確認できしだい再度公開される予定とのことですので、少しお待ちください。なお、もし既に WMF5.0 RTM をインストールしていた場合、この問題に該当しています。また、WMF 5.0 RC や Production Preview ではこの問題は生じていません。

Windows Management Framework (WMF) 5.0 currently removed from Download Center

本文

ついに PowerShell v5 RTM がリリースされました。

Windows Management Framework (WMF) 5.0 RTM is now available

f:id:guitarrapc_tech:20151219033301p:plain

そう、RTM ということは完全な製品版です。多くの機能がありますが、リリースノートをさくっと見ていきましょう。

サクッとみたのに長いです。

過去の記事はこちら。

tech.guitarrapc.com

2015/12/24 追記
本文
目次
リリースノート
サポートOS環境
- WMF5.0 RTM のインストールが可能になった環境
- WFM5.0 RTM をいれてはいけないソフトウェア環境
ダウンロード
インストール
既知の問題
- 初回のみPoweShell ショートカットが動作しない
- DSC
機能一覧
リリースノートにない機能
BUG: ScheduledTasks module broken in 1511
まとめ

リリースノート

https://msdn.microsoft.com/en-us/powershell/wmf/releasenotes?f=255&MSPPError=-2147217396

サポートOS環境

気になるサポートOS環境ですが、WMFv5 Production Preview から大きく変わりました。サポートがサーバー系OSのみに変わりました。これには色々あったようですが、多くは語りません。まずはサーバー系OSでお試しください。

記事を書き終えた瞬間に、Windows 8.1 / 7 SP1 もサポートされました。従来のWMF PP などと同様のOSサポートになりました。

Operating System	サービスパック	エディション	前提条件
Windows Server 2012 R2		All, except IA64	.NET 4.5以上
Windows Server 2012		All, except IA64	.NET 4.5以上
Windows Server 2008 R2	SP1	All, except IA64	WMF 4.0 is installed / .NET 4.5以上
Windows 8.1		Pro, Enterprise
Windows 7	SP1	All	WMF 4.0 is installed / .NET 4.5以上

WMF5.0 RTM のインストールが可能になった環境

以前の WMF5.0 Production Preview では以下のサーバーアプリケーションを入れているシステムでのインストールは対応していませんでした。が、 WMF5.0 RTM のインストールは可能になりました。

System Center 2012 Configuration Manager

WFM5.0 RTM をいれてはいけないソフトウェア環境

現時点では、以下のサーバーアプリケーションをいれているシステムでは WMF5.0 をインストールしないでください。

Microsoft Exchange Server 2013
Microsoft Exchange Server 2010 SP3
Microsoft SharePoint Server 2013
Microsoft SharePoint Server 2010
System Center 2012 Virtual Machine Manager

ダウンロード

Microsoft Download Center からどうぞ

Download Windows Management Framework 5.0 (Superceeded by WMF 5.1 RTM version: http://aka.ms/wmf5download) from Official Microsoft Download Center

OS 環境ごとのインストールパッケージは以下の通りです。

Operating System	アーキテクチャ	インストールパッケージ名
Windows Server 2012 R2	x64	W2K12R2-KB3094174-x64.msu
Windows Server 2012	x64	W2K12-KB3094175-x64.msu
Windows Server 2008 R2	x64	W2K8R2-KB3094176-x64.msu
Windows 8.1	x64	W2K12R2-KB3094174-x64.msu
Windows 8.1	x86	Win8.1-KB3094174-x86.msu
Windows 7 SP1	x64	W2K8R2-KB3094176-x64.msu
Windows 7 SP1	x86	Win7-KB3094176-x86.msu

f:id:guitarrapc_tech:20151219034805p:plain

インストール

少し注意が必要です。

Windows Server 2012 R2 と Windows Server 2012

まずは以下を確認してください。

Windows PowerShell 2.0 (該当する場合) が有効であること
- Windows Server 2012 R2 Server Core では Windows Server 2.0 が無効になっています。その場合は以下のコマンドで有効化できます。

dism /online /enable-feature:MicrosoftWindowsPowerShellV2
dism /online /enable-feature:MicrosoftWindowsPowerShellV2-WOW64

バージョン

Windows 10 TH2 (Build 10586) と同じバージョンです。

$PSVersionTable

# WMF 5 RTM

Name                           Value
----                           -----
PSVersion                      5.0.10586.56
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.10586.56
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

が、 Windows 10 TH2 と WMF 5 RTMは、マイナーバージョンが実は違ったりします。

# Windows 10 TH2

Name                           Value
----                           -----
PSVersion                      5.0.10586.0
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
BuildVersion                   10.0.10586.0
CLRVersion                     4.0.30319.42000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

PSReadLine

Windows 10 の PowerShell 5.0 とは違い、PSReadLine は PoweShell.Core に入ってきていません。

PowerShell コンソールの強化のためにも、ご自分でいれてください。

github.com

アンインストール

以下のコマンドを実行することでアンインストールできます。

Windows Server 2012 R2

wusa /uninstall /kb:3094174

Windows Server 2012

wusa /uninstall /kb:3094175

Windows Server 2008 R2 SP1

wusa /uninstall /kb:3094176

既知の問題

初回のみPoweShell ショートカットが動作しない

以下のどちらかを行うと直ります。

PowerShell ショートカットを右クリック -> Windows PowerShell
PowerShell ショートカットを右クリック -> Windows PowerShell -> Run As Administrator

DSC

破壊的変更に伴い、いくつかあります。

破壊的変更 : 証明書による暗号化が失敗する

WMF5 RTM で別方式になったためです。対処は、証明書を「Encipherment か Key Encipherment Key 利用」と「Document Encryption Enhanced Key 利用 (1.3.6.1.4.1.311.80.1)]で再生成してください。

詳細はここで。

Protect-CmsMessage

Start-DscConfiguration など一部 Cmdlet がエラー

LCM failed to retrieve the property PendingJobStep from the object of class dscInternalCache .
    + CategoryInfo : ObjectNotFound: (root/Microsoft/...gurationManager:String) \[\], CimException
    + FullyQualifiedErrorId : MI RESULT 6
    + PSComputerName : localhost

管理者として、DSCEngineCache.mof を削除します。

Remove-Item -Path $env:SystemRoot\\system32\\Configuration\\DSCEngineCache.mof

WMF 5.0 Production Preview に上書きして WMF 5.0 RTM をインストール

管理者で以下のコマンド実行します。

mofcomp $env:windir\\system32\\wbem\\DscCoreConfProv.mof

Get-DscConfiguration -Debug するとLCM状態が不安定になる

Get-DscConfiguration cmdlet の Debug 中に、CTRL+Cで中断しないこと。

Stop-DscConfiguration -Debug するとハング

Get-DscConfiguration -Debug するとLCM状態が不安定になる

で示した方法を実行します。

DSCResource の Verbose メッセージがLCMをDebugModeにしていると見えない

LCM のデバッグモードを無効にします。

Invoke-DscResource の実行がGet-DscConfigurationStatus cmdletで取得できない

対処なし

Get-DscConfigurationStatus が Pull実行結果を Consistency として返す

Pull 実行されたノードは、Initial ではなくConsistency として返します。

Invoke-DscResource が呼び出し先のメッセージを返さない。

LCM や DSC Resource 生成された verbose, warning, error messages は出力されません。

Invoke-DscResource を使うと DSC Resource がデバッグしにくい

LCM が Debug モードになっていると Invoke-DscResource は RunspaceId を返さないため、リモートデバッグが困難です。

Get-PSHostProcessInfo, Enter-PSHostProcess , Get-Runspace, Debug-Runspace で RunSpaceId を特定して利用しましょう。

一つのノードに対して様々な Partial Configuration を適用するとどのリソースなのか判別できない

Partial Configuration が異なる場合、別のリソース名を利用します。

Start-DscConfiguration –UseExisting が -Credential パラメータを受け付けない

CIM Session を利用します。

ノード名に IPv6 Addresses

サポートしていません。

Class-Based DSC Resources のデバッグ

サポートしていません。

DSC Class-Based Resource で$scriptスコープで定義した変数が他のDSCResource で利用できない

クラス構文の仕様です。各DSC Class 自体に関数や変数をそれぞれ設定してください。

PSDscRunAsCredential 使用時のデバッグ

サポートしていません。

DSC Composite Resources で PsDscRunAsCredential が利用できない

Credential を代わりに使ってください。

Get-DscResource -Syntax が PsDscRunAsCredential を正しく反映しない

サポートしていません。が、ISE での編集中のみ正しいメタデータがインテリセンスにでます。

Windows 7 で WindowsOptionalFeature がサポートされていない

DISM module を必要とするため、Windows 8 以上である必要があります。

Set-DscLocalConfigurationManager を WMF4.0 や WMF5.0 PP に実行しても失敗する

直接Invoke-CimMethodで設定してください。WMF 5.0 RTM 入れましょう。

$computerName = "WIN-3B576EM3669"
$mofPath = "C:\\$computerName.meta.mof"
$configurationData = \[Byte\[\]\]\[System.IO.File\]::ReadAllBytes($mofPath)
$totalSize = \[System.BitConverter\]::GetBytes($configurationData.Length + 4 )
$configurationData = $totalSize + $configurationData
Invoke-CimMethod -Namespace root/microsoft/windows/desiredstateconfiguration -class MSFT\_DSCLocalConfigurationManager -name SendMetaConfigurationApply -arguments @{ConfigurationData = \[Byte\[\]\]$configurationData} -Verbose -ComputerName $computerName

機能一覧

さくっとピックアップです。

Just Enough Administration (JEA)

詳細はここで。

gallery.technet.microsoft.com

これまで Windows においてユーザーが管理者権限がほしい場合、昇格していましたがこれではすべてのコマンドが管理者扱いでした。つまり Azure のサブスクリプションにおける共同管理者状態です。これに対してJEA では、リモートエンドポイントを作成して、そこにつないだユーザーを「指定したコマンド、スクリプト、実行ファイルに限定して」管理者昇格することが可能になります。これを Role base Administrationと呼びます。つまり Azure の Role Base Account Control のようなイメージです。

必要な操作のエンドポイントにつないで必要な操作をやることで、必要な分だけの実行制御を行う。大事です。

クラス構文を用いたユーザー定義型の作成

PowerShell v4 におけるDSC に続いて、v5 でも言語デザインに大きな更新が入りました。クラス構文の導入です。

他のオブジェクト指向プログラミング言語 (OOP) と同じような、シンタックスやセマンティックがクラス構文で提供されます。目標としているのは、開発者とIT Proがお互いに必要なシーンでもっとPowerShell を活用できるようにすることです。PowerShell での成果物 (DSC リソースなど) の生成を高速化することを目指しています。

サポートされているシナリオは以下の通りです。

DSC リソースの定義とそれに伴う型を PowerShell言語機能で提供すること
OOP の一般的な構文(Class / Propery / Method 他) を用いて、ユーザー定義型を提供すること。
クラス継承をPowerShell やクラスベースのDSCリソースでサポート
型のデバッグをPowerShell 言語機能として提供
例外の生成と発生をきっちりしたメカニズムで正しい権限で扱うこと

若干変わっている部分がありますが、Preview の時点では以下のように使えました。

tech.guitarrapc.com

モジュールやスクリプト外部では定義した型が利用できなかったり、Enumのベースタイプには int のみ指定可能*1など、まだまだいくつか制限があります。それでも、DSCリソースなど動作をきっちり制御したい場合は、クラス構文がレキシカルスコープだったり、型の初期化から呼び出しまできっちり制御できるのはいいでしょう。*2

実行中PowerShellスクリプトのデバッグ

実行中のスクリプトに対して、デバッガーをブレイク挿入可能になりました。VS のリモートデバッグのようなイメージです。ローカルでもリモートでも動作するのでぜひぜひ！

Enter-PSHostProcess
Exit-PSHostProcess

リモートセッション先のファイルの編集をISEで可能に

ようは ssh 先のドキュメントを Vim で操作、保存できるように、PowerShell ISE も PS Remortingでつないだリモートセッションにあるファイルの編集保存が可能になりました。

ローカルからリモートを対話形式で編集できるの、やっと実装です。やったね！

デバッグ強化

RunSpace に対するデバッグが可能になりました。valentia もそうですが、PowerShell での非同期操作はコールバックメインなので、コールバック実行中のセッションをデバッグできるのはうれしのです。

Get-Runspace
Debug-Runspace
Enable-RunspaceDebug
Disable-RunspaceDebug
Get-RunspaceDebug

DSC の Configuration にかかわる更新

PSDesiredStateConfiguration モジュールが 1.1 に更新されました。

ノード間の協調動作

以下のリソースを利用して、指定ノード完了をまってから続行したりなど協調動作が可能になりました。

WaitForAll
WaitForAny
WaitForSome

MOF がデフォルトで暗号化されます。

WMF v4 の DSC で屑かったのが、MOF がデフォルトプレーンテキストだったことです。暗号化には証明書が必要と大変クズでした。まじサイテー。

WMF v5 ではデフォルト暗号化されます。証明書もいりません。やったね！！！！！暗号化は、Windows Data Protection で行われます。

次の図の通り、DSCサーバーで作ったMOF はこれまで通り暗号化されません、がノードに転送されたMOFは暗号化されます。

f:id:guitarrapc_tech:20151219042841p:plain

Configuration のヘルプサポート

読み込んだ Configuration に対して help Configurationname でヘルプが出ます！

例えば以下のような Configuration を実行してから、

configuration HelpSample1
{
    param([string]$computername,[string]$filePath)
    File f
    {
        Contents="Hello World"
        DestinationPath = "c:\Destination.txt"
    }
}

ヘルプを見ようとしてもでませんでした。

man HelpSample1

これが、WMF5 からヘルプがでます。

<#
.SYNOPSIS
The synopsis for the configuration goes here. This can be one line, or many.

.DESCRIPTION
The description for the configuration is usually a longer, more detailed explanation of what the script or function does. Use as many lines as you need.

.PARAMETER computername
Here, the dotted keyword is followed by a single parameter name. Don't precede that with a hyphen. The following lines describe the purpose of the parameter:

.PARAMETER filePath
Provide a PARAMETER section for each parameter that your script or function accepts.

.EXAMPLE
There's no need to number your examples.

.EXAMPLE
Windows PowerShell will number them for you when it displays your help text to a user.
#>

configuration HelpSample1
{
    param([string]$computername,[string]$filePath)
    File f
    {
        Contents="Hello World"
        DestinationPath = "c:\Destination.txt"
    }
}

こんな感じですね。

HelpSample1 -?

NAME
HelpSample1

SYNOPSIS
The synopsis for the configuration goes here. This can be one line, or many.

SYNTAX
HelpSample1 [[-InstanceName] <String>] [[-DependsOn] <String[]>] [[-OutputPath] <String>] [[-ConfigurationData] <Hashtable>] [[-computername] <String>] [[-filePath] <String>] [<CommonParameters>]

DESCRIPTION
The description for the configuration is usually a longer, more detailed explanation of what the script or function does. Take as many lines as you need.

RELATED LINKS

REMARKS

To see the examples, type: "get-help HelpSample1 -examples".
For more information, type: "get-help HelpSample1 -detailed".
For technical information, type: "get-help HelpSample1 -full".

DSC のISE インテリセンスサポート向上

どれもやっとです。だいぶん楽になります。

Ctrl + Spaceでコンフィグレーション名の列挙がサポートされました。
リソースのプロパティが列挙型の場合自動補完されるようになりました。
DependsOn を使っているときに、他リソースの補完がきくようになりました。
リソースのプロパティのタブ補完が強化されました。

DSC のコンフィグレーション競合検知

以下のWeb-Server のインストールのように、同一コンフィグレーションでプロパティが一致している定義が複数あった場合、今後検知されます。

もしプロパティが違う値の場合は検知されないのでお気を付けを。

Configuration IIS_FrontEnd
{
    WindowsFeature FE_IIS         #Identical resource
    {
        Ensure = 'Present'
        Name = 'Web-Server'
    }

    WindowsFeature FTP
    {
        Ensure = 'Present'
        Name = 'Web-FTP-Server'
    }
}

Configuration IIS_Worker
{
    WindowsFeature Worker_IIS      #Identical resource
    {
        Ensure = 'Present'
        Name = 'Web-Server'
    }

    WindowsFeature ASP
    {
        Ensure = 'Present'
        Name = 'Web-ASP-Net45'
    }
}

Configuration WebApplication
{
    IIS_Frontend Web {}

    IIS_Worker ASP {}
}

Import-DscResource がバージョンサポート

バージョンの指定が可能になりました。

PowerShell v5 で複数バージョンのモジュールサイドロードが可能になったことを受けて、Import-DscResource もモジュールバージョンを指定可能になりました。大事大事。

32bit 環境での Configuration キーワードサポート

これまで DSC は 64bit 環境でのみサポートされてましたが、32bit でもサポートされました。

DSC の Resource にかかわる更新

クラス構文による DSC リソースの記述サポート

いくつかの特殊な属性[DscProperty(Mandatory)]や[BaseFileResource]などを含めて、PowerShell のクラス構文で DSC リソース記述がサポートされました。

DSC リソーススクリプトのデバック

以下のCmdlet でデバッグすることが可能になりました。

Enable-DscDebug
Disable-DscDebug

やっとですよ。こんな感じですね。 WMF5 のデバッグ機能の強化はここに目標が集約されています。

Enter-PSSession -ComputerName MGMT-10001-827
Enter-PSHostProcess -Id 2640 -AppDomainName DscPsPluginWkr\_AppDomain
Debug-Runspace -Id 3

PsDscRunAsCredential の自動サポート

DSC を指定ユーザーで実行したいことありませんでしたか？わたしめちゃめちゃいつも思ってました。

別ユーザーのコンテキストで実行しようと思ったら、タスクスケジューラを使うなど迂回措置をとる必要があったためとてもうれしいサポートです。

例えば以下のような感じで、DependsOn プロパティ同様に自動的に PsDscRunAsCredential プロパティがサポートされました。

Configuration ChangeCmdBackGroundColor
{
    Node ("localhost")
    {
        Registry CmdPath
        {
            Key = "HKEY\_CURRENT\_USER\\\\Software\\Microsoft\\\\Command Processor"
            ValueName = "DefaultColor"
            ValueData = '1F'
            ValueType = "DWORD"
            Ensure = "Present"
            Force = $true
            Hex = $true
            PsDscRunAsCredential = get-credential
        }
    }
}

$configData = {
    AllNodes = (
    {
        NodeName="localhost";
        CertificateFile = "C:\publicKeys\targetNode.cer"
    })
}

ChangeCmdBackGroundColor -ConfigurationData $configData

DSCリソースのサイドバイサイドサポート

先述の通りです。同一コンフィグレーションで別バージョンのリソースを並列利用はできません。

標準リソースの追加

Windowsfeatureset

WindowsFeature のまとめて版ですね。中身はこれです。

Resource Name	Description
LocalConfigurationManager	DSCエンジンの実行にかかわる定義が可能になります。
PartialConfiguration	Partial configuration 設定です。
ConfigurationRepositoryWeb	Web-based configuration リポジトリの定義です。(HTTP/HTTPS ってことです)
ConfigurationRepositoryShare	File share-based configuration リポジトリの定義です。(SMBってことです)
ResourceRepositoryWeb	Web-based resource リポジトリの定義です。
ResourceRepositoryShare	File-based resource リポジトリの定義です。
ReportServerWeb	PULLシナリオにおける、Webベースでのレポートエンドポイントの定義です。

LCM Meta 設定	Meta Configuration の値	Meta Configuration適用後の値	pull発生頻度[mins]	Configuration の適用頻度 [mins]
ConfigurationModeFrequencyMins	70	70	40	70
RefreshFrequencyMins	40	40

Scenario	LCMState	Status	RebootRequested	ResourcesInDesiredState	ResourcesNotInDesiredState
Idle	Success	$false	S	$null
PendingConfiguration	Failure	$false	$null	F	S,F
PendingConfiguration	Failure	$false	S	F	F,S
PendingConfiguration	Failure	$false	S	F	S1, F, S2
PendingConfiguration	Failure	$false	S1, S2	F	F1, S, F2
PendingConfiguration	Failure	$false	S	F1, F2	S, r
PendingReboot	Success	$true	S	r	F, r
PendingReboot	Failure	$true	$null	F, r	r, S
PendingReboot	Success	$true	$null	r	r, F
PendingReboot	Success	$true	$null	r

2015/12/24 追記

本文

目次

リリースノート

サポートOS環境

WMF5.0 RTM のインストールが可能になった環境

WFM5.0 RTM をいれてはいけないソフトウェア環境

ダウンロード

インストール

Windows Server 2012 R2 と Windows Server 2012

バージョン

PSReadLine

アンインストール

既知の問題

初回のみPoweShell ショートカットが動作しない

DSC

破壊的変更 : 証明書による暗号化が失敗する

Start-DscConfiguration など一部 Cmdlet がエラー

WMF 5.0 Production Preview に上書きして WMF 5.0 RTM をインストール

Get-DscConfiguration -Debug するとLCM状態が不安定になる

Stop-DscConfiguration -Debug するとハング

DSCResource の Verbose メッセージがLCMをDebugModeにしていると見えない

Invoke-DscResource の実行がGet-DscConfigurationStatus cmdletで取得できない

Get-DscConfigurationStatus が Pull実行結果を Consistency として返す

Invoke-DscResource が呼び出し先のメッセージを返さない。

Invoke-DscResource を使うと DSC Resource がデバッグしにくい

一つのノードに対して様々な Partial Configuration を適用するとどのリソースなのか判別できない

Start-DscConfiguration –UseExisting が -Credential パラメータを受け付けない

ノード名に IPv6 Addresses

Class-Based DSC Resources のデバッグ

DSC Class-Based Resource で$scriptスコープで定義した変数が他のDSCResource で利用できない

PSDscRunAsCredential 使用時のデバッグ

DSC Composite Resources で PsDscRunAsCredential が利用できない

Get-DscResource -Syntax が PsDscRunAsCredential を正しく反映しない

Windows 7 で WindowsOptionalFeature がサポートされていない

Set-DscLocalConfigurationManager を WMF4.0 や WMF5.0 PP に実行しても失敗する

機能一覧

DSC の Configuration にかかわる更新

DSC の Resource にかかわる更新

DSC のLocal Configuration Manager (LCM) にかかわる更新

DSC の Cmdlet にかかわる更新

DSC の PULLにかかわる更新

PowerShell 監査

新Cmdlet と既存Cmdlet の更新

リリースノートにない機能

Remote-Copy

using namespace シンタックス

複数バージョン Module のサイドローディング

自己証明書 Cmdlet の強化

ゴミ箱のクリア

New-ScheduledTaskTrigger の -Weekly サポート

まとめ