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 コマンドレットを使用します。
Type: | AgentAssignment |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
コンピューターの名前の配列を指定します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。
System Center Data Access サービスがコンピューター上で実行されている必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-Credential
管理グループ接続の PSCredential オブジェクトを指定します。
PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細を表示するには「Get-Help Get-Credential
」を入力します。
ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
コンピューターの名前の配列を指定します。 Operations Manager は、指定したコンピューターをエージェントの割り当てから除外します。 OPERATIONS Manager は、LDAP クエリによってコンピューターが返された場合でも、これらのコンピューターを除外します。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LdapQuery
ターゲット エージェント コンピューターを選択するドメイン内の LDAP クエリを指定します。 このパラメーターを指定しない場合、コマンドレットは現在の LDAP クエリを使用します。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
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 |
-PrimaryServer
ManagementServer オブジェクトを指定します。 このパラメーターは、ターゲット エージェントで管理されるコンピューターのプライマリ管理サーバーを指定します。 ManagementServer オブジェクトを取得するには、Get-SCOMManagementServer コマンドレットを使用します。
Type: | ManagementServer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
Connection オブジェクトの配列を指定します。 Connection オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。
接続オブジェクトは、管理サーバーへの接続を表します。 既定値は現在の管理グループ接続です。
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |