Set-SCOMRunAsProfile
実行アカウントを実行プロファイルに追加するか、実行プロファイルから削除します。
構文
Set-SCOMRunAsProfile
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMRunAsProfile
[-Class] <ManagementPackClass[]>
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMRunAsProfile
[-Instance] <MonitoringObject[]>
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SCOMRunAsProfile
[-Group] <MonitoringObject[]>
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-SCOMRunAsProfile コマンドレットは、実行プロファイルに実行アカウントを追加するか、実行プロファイルから実行アカウントを削除します。
例
例 1: アカウント名を指定して実行プロファイルに実行アカウントを追加する
PS C:\>$Profile = Get-RunAsProfile -DisplayName "Privileged Monitoring Account"
PS C:\> $Account = Get-SCOMRunAsAccount -Name "High Privileged Account"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account
次の使用例は、アカウント名を指定して実行プロファイルに実行アカウントを追加します。
最初のコマンドは、表示名 Privileged Monitoring Account を持つ実行プロファイルを取得し、$Profile変数に格納します。
2 番目のコマンドは、High Privileged Account という名前の実行アカウントを取得し、$Account変数に格納します。
3 番目のコマンドは、$Account変数に格納されているアカウントを、$Profile変数に格納されている実行プロファイルに追加し、実行アカウントを構成します。 このコマンドはクラス、グループ、またはオブジェクトを指定しないため、対象となるすべてのオブジェクトを管理するように実行アカウントを構成します。
例 2: パスを指定して実行プロファイルに実行アカウントを追加する
PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group
次の使用例は、パス名を指定して実行プロファイルに実行アカウントを追加します。
最初のコマンドは、SQL Server 監視アカウントという名前の実行プロファイルを取得し、$Profile変数に格納します。
2 番目のコマンドは、Contoso\SQLAuth という名前の実行アカウントを取得し、$Account変数に格納します。
3 番目のコマンドは、Contoso financial SQL Server という名前のグループを取得し、$Group変数に格納します。
4 番目のコマンドは、$Account変数に格納されているアカウントを $Profile 変数に格納されている実行プロファイルに追加し、$Group変数に格納されているグループを管理するように実行アカウントを構成します。
例 3: オブジェクトを指定して実行プロファイルに実行アカウントを追加する
PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group
次の使用例は、アカウント オブジェクトを指定して実行プロファイルに実行アカウントを追加します。
最初のコマンドは、SQL Server 監視アカウントの表示名を持つ実行プロファイル オブジェクトを取得し、そのオブジェクトを $Profile 変数に格納します。
2 番目のコマンドは、Contoso\SQLAuth という名前の実行アカウント オブジェクトを取得し、そのオブジェクトを $Account 変数に格納します。
3 番目のコマンドは、Contoso 財務 SQL Server という表示名を持つグループ オブジェクトを取得し、そのオブジェクトを $Group 変数に格納します。
最後のコマンドは、$Accountおよび$Groupに格納されているアカウントとグループを、$Profile変数に格納されているプロファイル SQL Server 監視アカウントに追加します。
パラメーター
-Account
実行アカウント 表す Microsoft.EnterpriseManagement.Security.SecureData オブジェクトの配列を指定します。 SecureData オブジェクトを取得するには、Get-SCOMRunAsAccount コマンドレットを使用します。
型: | SecureData[] |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Action
実行プロファイルを更新するために実行するアクションを指定します。 このパラメーターに使用できる値は、Add または Remove です。
型: | RunAsProfileAccountsAction |
配置: | 4 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Class
実行アカウントで管理できるクラスを表す ManagementPackClass オブジェクトの配列を指定します。 クラスを格納する変数を指定するか、クラスを取得 Get-SCOMClass などのコマンドレットを使用します。
型: | ManagementPackClass[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Group
実行アカウントで管理できるグループを表す監視オブジェクトの配列を指定します。 グループを格納する変数を指定するか、グループを取得 Get-SCOMGroup などのコマンドレットを使用します。
型: | MonitoringObject[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Instance
実行アカウントで管理できるクラス インスタンスを表す監視オブジェクトの配列を指定します。 クラス インスタンスを格納する変数を指定するか、クラス インスタンスを取得 Get-SCOMClassInstance などのコマンドレットを使用します。 このパラメーターは、グループ オブジェクトも受け入れます。 グループ オブジェクトを取得するには、Get-SCOMGroup コマンドレットを使用します。
型: | MonitoringObject[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PassThru
コマンドレットが、パイプラインでコマンドで使用できるオブジェクトを作成または変更することを示します。 既定では、このコマンドレットは出力を生成しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
更新する実行プロファイルを指定します。 実行プロファイルを格納する変数を指定するか、プロファイルを取得 Get-SCOMRunAsProfile などのコマンドレットを使用します。
型: | ManagementPackSecureReference |
配置: | 3 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |