Invoke-PolicyEvaluation

構文

Invoke-PolicyEvaluation
      [-Policy] <PSObject>
      [-AdHocPolicyEvaluationMode <AdHocPolicyEvaluationMode>]
      -TargetServerName <PSObject>
      [-TargetExpression <String>]
      [-OutputXml]
      [-ProgressAction <ActionPreference>]
      [<CommonParameters>]

Invoke-PolicyEvaluation
      [-Policy] <PSObject>
      [-AdHocPolicyEvaluationMode <AdHocPolicyEvaluationMode>]
      -TargetObjects <PSObject[]>
      [-OutputXml]
      [-ProgressAction <ActionPreference>]
      [<CommonParameters>]

説明

Invoke-PolicyEvaluation コマンドレットは、1 つ以上のポリシー ベースの管理ポリシーを、ターゲット セットで指定された一連の SQL Server オブジェクトに対して評価します。

ポリシーでは、データベース名や照合順序のサイト標準の確立など、SQL Server オブジェクトに関連付けられているさまざまなプロパティに使用できる値を指定します。

このコマンドレットをチェック モードで実行すると、ターゲット セット内のオブジェクトの現在のプロパティがポリシー定義の規則に準拠しているかどうかを報告します。

プロパティがポリシーに準拠していない場合、ターゲット セット内のオブジェクトは再構成されません。

構成モードでは、このコマンドレットは、ポリシー定義に準拠していないターゲット セット内のすべてのオブジェクトを再構成します。

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

例

例 1: コンピューターの既定のインスタンスでポリシーを評価する

PS C:\> Set-Location "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Policies\DatabaseEngine\1033"
PS C:\> Invoke-PolicyEvaluation -Policy "Trustworthy Database.xml" -TargetServer "MYCOMPUTER"

このコマンドは、指定されたコンピューターの既定のインスタンスでポリシーを評価します。 ポリシーは XML ファイルから読み取られ、接続は Windows 認証を使用して認証されます。

例 2: XML ファイルからポリシーを評価する

PS C:\> Set-Location "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Policies\DatabaseEngine\1033"
PS C:\> Get-ChildItem "Database Status.xml", "Trustworthy Database.xml" | Invoke-PolicyEvaluation -TargetServer "MYCOMPUTER"

このコマンドは、フォルダー内の XML ファイルから 2 つのポリシーを読み取り、パイプライン演算子を使用して Invoke-PolicyEvaluation に渡します。

例 3: ポリシーを評価し、SMLIF スキーマに従って出力を書式設定する

PS C:\> Set-Location "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Policies\DatabaseEngine\1033"
PS C:\> Invoke-PolicyEvaluation -Policy "Database Status.xml" -TargetServer "MYCOMPUTER" -OutputXML > C:\MyReportFolder\MyReport.xml

このコマンドは、サービス モデリング言語交換形式 (SML-IF) スキーマを使用して、ポリシーを評価し、出力を書式設定します。 出力はファイルにリダイレクトされます。

例 4: フィルター処理された一連のポリシーを評価する

PS C:\> Set-Location "SQLSERVER:\SQLPolicy\MYCOMPUTER\DEFAULT\Policies"
PS C:\> Get-ChildItem | Where-Object { $_.PolicyCategory -eq "Microsoft Best Practices: Maintenance" } | Invoke-PolicyEvaluation -TargetServer 'MYCOMPUTER'

最初のコマンドは、SQL Server ポリシー ストアへの現在のパスを設定します。

2 番目のコマンドでは、Get-ChildItem を使用してすべてのポリシーを読み取り、Where-Object を使用して、PolicyCategory プロパティが "Microsoft ベスト プラクティス: メンテナンス" に設定されているポリシーの一覧をフィルター処理します。

出力は、パイプライン演算子を使用して Invoke-PolicyEvaluation に送信されます。

例 5: SqlStoreConnection オブジェクトを使用して XML ファイルからポリシーを評価する

PS C:\> Set-Location "C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Policies\DatabaseEngine\1033"
PS C:\> $Connection = New-Object Microsoft.SqlServer.Management.Sdk.Sfc.SqlStoreConnection("server='MYCOMPUTER';Trusted_Connection=True")
PS C:\> Invoke-PolicyEvaluation -Policy "Database Status.xml" -TargetServer $Connection

最初のコマンドは、現在の場所を、XML ファイル内のポリシー回避を含むローカル フォルダーに設定します。

2 番目のコマンドでは、New-Object を使用して SqlStoreConnection オブジェクトを作成します。

3 番目のコマンドは、SQLStoreConnection オブジェクトによって定義されたサーバーに対して XML ファイルからポリシーを評価します。

例 6: 手動で読み込まれたアセンブリを使用してポリシーを評価する

PS C:\> Set-Location "C:\Program Files (x86)\Microsoft SQL Server\140\ tools\Policies\analysisservices\1033"
PS C:\> [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.AnalysisServices")
PS C:\> $SSASsvr = New-Object Microsoft.AnalysisServices.Server
PS C:\> $SSASsvr.Connect("Data Source=localhost")
PS C:\> Invoke-PolicyEvaluation "Surface Area Configuration for Analysis Services Features.xml" -TargetObject $SSASsvr

最初のコマンドは、現在のフォルダーの場所を設定します。

2 番目のコマンドは、SQL Server Analysis Services アセンブリのインスタンスを読み込みます。

3 番目のコマンドは、Microsoft.AnalysisServices オブジェクトを作成します。

4 番目のコマンドでは、新しい AnalysisServices オブジェクトを使用して、ローカル コンピューター上の既定のサーバー インスタンスへの接続を開きます。

5 番目のコマンドは、Analysis Services のサーフェス領域構成ポリシーを評価します。

例 7: フィルター処理された一連のポリシーを評価する

PS C:\> Set-Location "C:\Program Files (x86)\Microsoft SQL Server\120\Tools\Policies\DatabaseEngine\1033"
PS C:\> Invoke-PolicyEvaluation "Database Status.xml" -TargetServer "MYCOMPUTER" -TargetExpression "Server[@Name='MYCOMPUTER']/Database[@Name='AdventureWorks2014']"

このコマンドでは、TargetExpression パラメーターを使用して、AdventureWorks2014 サンプル データベースに対して評価されるデータベース状態ポリシーをフィルター処理し、評価を実行するクエリ式を指定します。

例 8: レポート サービスの領域構成ポリシーを評価する

PS C:\> Set-Location "C:\Program Files (x86)\Microsoft SQL Server\120\Tools\Policies\ReportingServices\1033"
PS C:\> [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Dmf.Adapters")
PS C:\> $SSRSsvr = New-Object Microsoft.SqlServer.Management.Adapters.RSContainer('MyComputer')
PS C:\> Invoke-PolicyEvaluation -Policy "Surface Area Configuration for Reporting Services 2008 Features.xml" -TargetObject $SSRSsvr

このコマンドは、SQL Server Reporting Services アセンブリを読み込み、ローカル コンピューター上の既定のサーバー インスタンスへの接続を作成し、Reporting Services の領域構成ポリシーを実行します。

パラメーター

-AdHocPolicyEvaluationMode

-OutputXml

-Policy

-ProgressAction

-TargetExpression

-TargetObjects

-TargetServerName

入力

System.Management.Automation.PSObject

関連リンク

• SQLServer_Cmdlets