Update-SCOMADAgentAssignment
更改 AD DS 代理分配的设置。
语法
Default （默认值）
Update-SCOMADAgentAssignment
-AgentAssignment <AgentAssignment>
-PrimaryServer <ManagementServer>
[[-LdapQuery] <String>]
[-Exclude <String[]>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Update-SCOMADAgentAssignment cmdlet 更改 Active Directory 域服务 （AD DS） 代理分配的设置。 可以使用此 cmdlet 更改代理分配的 LDAP 查询和排除列表设置。 要更改代理分配的其他设置，请删除代理分配并重新创建它。
示例
示例 1：更改代理分配的 LDAP 查询
PS C:\>Get-SCOMADAgentAssignment -Domain "contoso.com" | Update-SCOMADAgentAssignment -LdapQuery "(&(sAMAccountType=805306369)(name=SQLSERVER*))"
此命令获取域的 AD DS 代理分配。 该命令使用 Get-SCOMADAgentAssignment cmdlet 获取名为 contoso.com 的 AD DS 代理分配，并使用管道运算符将结果传递给 Update-SCOMADAgentAssignment cmdlet。 该命令更改名为 contoso.com 的域的代理分配的 LDAP 查询，以仅返回名称与 SQLSERVER 匹配的计算机。
参数
-AgentAssignment
指定 AgentAssignment 对象。 若要获取 AgentAssignment 对象，请使用 Get-SCOMADAgentAssignment cmdlet。
参数属性
| 类型: | AgentAssignment |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ComputerName
指定一个包含计算机名称的数组。 您可以使用 NetBIOS 名称、IP 地址或完全限定域名 （FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。
System Center 数据访问服务必须在计算机上运行。 如果未指定计算机，则 cmdlet 将使用该计算机进行当前管理组连接。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Credential
为管理组连接指定 PSCredential 对象。
若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。
要了解详情，请键入 Get-Help Get-Credential。
如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认值为当前用户。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Exclude
指定一个包含计算机名称的数组。 Operations Manager 从代理分配中排除指定的计算机。 即使 LDAP 查询返回计算机，Operations Manager 也会排除这些计算机。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-LdapQuery
在选择目标代理计算机的域中指定 LDAP 查询。 如果未指定此参数，则 cmdlet 将使用当前 LDAP 查询。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 3 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PassThru
指示 cmdlet 创建或修改命令可在管道中使用的对象。 默认情况下，此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PrimaryServer
指定 ManagementServer 对象。 此参数指定目标代理管理的计算机的主管理服务器。 若要获取 ManagementServer 对象，请使用 Get-SCOMManagementServer cmdlet。
参数属性
| 类型: | ManagementServer |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-SCSession
指定 Connection 对象的数组。 若要获取 Connection 对象，请使用 Get-SCOMManagementGroupConnection cmdlet。
连接对象表示与管理服务器的连接。 默认值为当前管理组连接。
参数属性
| 类型: | Connection[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。