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 financial SQL Server という表示名を持つグループ オブジェクトを取得し、そのオブジェクトを $Group 変数に格納します。
最後のコマンドは、$Accountおよび$Groupに格納されているアカウントとグループを、$Profile変数に格納されている監視アカウントSQL Serverプロファイルに追加します。
パラメーター
-Account
実行アカウントを表す Microsoft.EnterpriseManagement.Security.SecureData オブジェクトの配列を指定します。 SecureData オブジェクトを取得するには、Get-SCOMRunAsAccount コマンドレットを使用します。
| Type: | SecureData[] |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Action
実行プロファイルを更新するために実行するアクションを指定します。 このパラメーターで使用できる値は、Add または Remove です。
| Type: | RunAsProfileAccountsAction |
| Position: | 4 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Class
実行アカウントで管理できるクラスを表す ManagementPackClass オブジェクトの配列を指定します。 クラスを格納する変数を指定するか、クラスを取得する Get-SCOMClass などのコマンドレットを使用します。
| Type: | ManagementPackClass[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Group
実行アカウントで管理できるグループを表す監視オブジェクトの配列を指定します。 グループを格納する変数を指定するか、グループを取得する Get-SCOMGroup などのコマンドレットを使用します。
| Type: | MonitoringObject[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Instance
実行アカウントで管理できるクラス インスタンスを表す監視オブジェクトの配列を指定します。 クラス インスタンスを格納する変数を指定するか、クラス インスタンスを取得する Get-SCOMClassInstance などのコマンドレットを使用します。 このパラメーターは、グループ オブジェクトも受け入れます。 グループ オブジェクトを取得するには、 Get-SCOMGroup コマンドレットを使用します。
| Type: | MonitoringObject[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
パイプラインでコマンドが使用できるオブジェクトをコマンドレットで作成または変更することを示します。 既定では、このコマンドレットによる出力はありません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
更新する実行プロファイルを指定します。 実行プロファイルを格納する変数を指定するか、プロファイルを取得 する Get-SCOMRunAsProfile などのコマンドレットを使用します。
| Type: | ManagementPackSecureReference |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |