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 将使用计算机进行当前管理组连接。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定管理组连接的 PSCredential 对象。 若要获取 PSCredential 对象,请使用 Get-Credential cmdlet。 要了解详情,请键入 Get-Help Get-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DNSHostName

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

Type:String[]
Aliases:Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementServer

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

Type:ManagementServer
Aliases:MS
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

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

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

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输出

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer