Get-SCOMAgent
获取管理组中的代理管理计算机。
语法
Empty （默认值）
Get-SCOMAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementServer
Get-SCOMAgent
[-ManagementServer] <ManagementServer>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentNames
Get-SCOMAgent
[-DNSHostName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
说明
Get-SCOMAgent cmdlet 获取管理组中的代理管理的计算机。 可以指定 DNSHostName 参数来获取域名系统 （DNS） 主机上的代理管理的计算机，也可以指定 ManagementServer 参数，以获取主管理服务器的所有子代理管理计算机。
示例
示例 1：获取管理组中的所有代理
PS C:\>Get-SCOMAgent -ComputerName "Server01.Contoso.Com"
此命令与名为 Server01 的计算机建立临时连接，并获取管理组中的所有代理。
示例 2：获取管理服务器管理的代理
PS C:\>$MgmtServer = Get-SCOMManagementServer "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMAgent -ManagementServer $MgmtServer
此示例获取由管理服务器管理的代理管理的计算机。
第一个命令获取名为 MgmtServer01.Contoso.com 的管理服务器对象，并将该对象存储在$MgmtServer变量中。
第二个命令获取由存储在$MgmtServer的管理服务器管理的代理。
示例 3：使用代理名称获取管理组中的代理
PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com", "Server02*", "*.Contoso.com"
此命令获取名为 server01.contoso.com 的代理，该代理的名称以 Server02 开头，并且位于 Contoso.com 域中。
示例 4：获取域中的所有代理
PS C:\>Get-SCOMAgent -DNSHostName "*.Contoso.com" -ComputerName "Server01.Contoso.com"
此命令与名为 Server01.Contoso.com 的计算机建立临时连接，并获取 Contoso.com 域中的所有代理。
参数
-ComputerName
指定计算机名称数组。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。
System Center Data Access 服务必须在计算机上运行。 如果未指定计算机，该 cmdlet 将使用计算机进行当前管理组连接。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(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 |
-DNSHostName
指定代理托管计算机的域名系统（DNS）主机的名称。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 名称 |
参数集
FromAgentNames
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ManagementServer
指定 ManagementServer 对象。 此参数指定从中检索所有子代理的主管理服务器。 若要获取 ManagementServer 对象，请使用 Get-SCOMManagementServer cmdlet。
参数属性
| 类型: | ManagementServer |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 女士 |
参数集
FromManagementServer
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SCSession
指定 连接 对象的数组。 若要获取 连接 对象，请使用 Get-SCOMManagementGroupConnection cmdlet。
连接对象表示与管理服务器的连接。 默认值为当前管理组连接。
参数属性
| 类型: | Connection[] |
| 默认值: | None |
| 支持通配符: | 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。