Get-SCOMAgent

获取管理组中的代理管理计算机。

语法

Get-SCOMAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-ManagementServer] <ManagementServer>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
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[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Credential

为管理组连接指定 PSCredential 对象。 若要获取 PSCredential 对象,请使用 Get-Credential cmdlet。 有关详细信息,请键入 Get-Help Get-Credential

如果在 ComputerName 参数中指定计算机,请使用有权访问该计算机的帐户。 默认值为当前用户。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DNSHostName

指定代理托管计算机的域名系统(DNS)主机的名称。

类型:String[]
别名:Name
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ManagementServer

指定 ManagementServer 对象。 此参数指定从中检索所有子代理的主管理服务器。 若要获取 ManagementServer 对象,请使用 Get-SCOMManagementServer cmdlet。

类型:ManagementServer
别名:MS
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SCSession

指定 连接 对象的数组。 若要获取 连接 对象,请使用 Get-SCOMManagementGroupConnection cmdlet。

连接对象表示与管理服务器的连接。 默认值为当前管理组连接。

类型:Connection[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer