Update-SCOMADAgentAssignment
AD DS エージェントの割り当ての設定を変更します。
構文
Update-SCOMADAgentAssignment
-AgentAssignment <AgentAssignment>
-PrimaryServer <ManagementServer>
[[-LdapQuery] <String>]
[-Exclude <String[]>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Update-SCOMADAgentAssignment コマンドレットは、Active Directory Domain Services (AD DS) エージェントの割り当ての設定を変更します。 このコマンドレットを使用して、エージェント割り当ての LDAP クエリと除外リストの設定を変更できます。 エージェント割り当ての他の設定を変更するには、エージェントの割り当てを削除して再作成します。
例
例 1: エージェント割り当ての LDAP クエリを変更する
PS C:\>Get-SCOMADAgentAssignment -Domain "contoso.com" | Update-SCOMADAgentAssignment -LdapQuery "(&(sAMAccountType=805306369)(name=SQLSERVER*))"このコマンドは、ドメインの AD DS エージェントの割り当てを取得します。 このコマンドは、Get-SCOMADAgentAssignment コマンドレットを使用して contoso.com という名前の AD DS エージェントの割り当てを取得し、パイプライン演算子を使用して結果を Update-SCOMADAgentAssignment コマンドレットに渡します。 このコマンドは、contoso.com という名前のドメインに対するエージェント割り当ての LDAP クエリを変更して、SQLSERVER と一致する名前のコンピューターのみを返します。
パラメーター
-AgentAssignment
AgentAssignment オブジェクトを指定します。 AgentAssignment オブジェクトを取得するには、Get-SCOMADAgentAssignment コマンドレットを使用します。
| 型: | AgentAssignment |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ComputerName
コンピューターの名前の配列を指定します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
System Center Data Access サービスがコンピューター上で実行されている必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続 PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細については、「Get-Help Get-Credential」と入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Exclude
コンピューターの名前の配列を指定します。 Operations Manager は、指定したコンピューターをエージェントの割り当てから除外します。 LDAP クエリによってコンピューターが返された場合でも、Operations Manager はこれらのコンピューターを除外します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LdapQuery
ターゲット エージェント コンピューターを選択するドメイン内の LDAP クエリを指定します。 このパラメーターを指定しない場合、コマンドレットは現在の LDAP クエリを使用します。
| 型: | String |
| 配置: | 3 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
コマンドレットが、パイプラインでコマンドで使用できるオブジェクトを作成または変更することを示します。 既定では、このコマンドレットは出力を生成しません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrimaryServer
ManagementServer オブジェクトを指定します。 このパラメーターは、ターゲット エージェントで管理されるコンピューターのプライマリ管理サーバーを指定します。 ManagementServer オブジェクトを取得するには、Get-SCOMManagementServer コマンドレットを使用します。
| 型: | ManagementServer |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
接続オブジェクトは、管理サーバーへの接続を表します。 既定値は、現在の管理グループ接続です。
| 型: | Connection[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |