通过

Get-SCXAgent

模块:
OperationsManager Module

获取管理组中托管的 UNIX 和 Linux 计算机的列表。

语法

Empty （默认值） 

Get-SCXAgent
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAgentNamesParameterSetName 

Get-SCXAgent
    [-Name] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAgentGuidsParameterSetName 

Get-SCXAgent
    -ID <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromResourcePoolParameterSetName 

Get-SCXAgent
    -ResourcePool <ManagementServicePool>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

说明

Get-SCXAgent cmdlet 检索与提供的选择条件匹配的托管 UNIX 和 Linux 计算机。 如果未指定选择条件，则返回管理组中的所有托管 UNIX 和 Linux 计算机。

结果作为托管 UNIX 和 Linux 计算机对象的数组返回。

示例

示例 1：返回托管的 UNIX 和 Linux 计算机

PS C:\>Get-SCXAgent

此命令返回资源池中的所有托管 UNIX 和 Linux 计算机。

示例 2：从资源池返回托管 UNIX 和 Linux 计算机

PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePool

第一个命令使用 Get-SCOMResourcePool cmdlet 获取资源池，并将其存储在$ResourcePool变量中。

第二个命令返回$ResourcePool中资源池的所有托管 UNIX 和 Linux 计算机。

示例 3：使用名称返回托管 UNIX 和 Linux 计算机

PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"

此命令返回与提供的字符串列表匹配的名称的托管 UNIX 和 Linux 计算机。

示例 4：使用管道返回托管 UNIX 和 Linux 计算机

PS C:\>"server1", "server2", "server3" | Get-SCXAgent

此命令通过管道提供 Name 参数。

示例 5：连接到资源池并按名称获取托管计算机

PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"

此命令使用当前用户的凭据连接到具有临时连接的资源池，并仅返回与 Name 属性匹配的托管计算机。

参数

-ComputerName

指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。

System Center Data Access 服务必须在计算机上处于活动状态。 如果未指定计算机，该 cmdlet 将使用计算机进行当前管理组连接。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Credential

指定运行管理组连接的用户帐户。 为此参数指定 PSCredential 对象，例如 Get-Credential cmdlet 返回的对象。 有关凭据对象的详细信息，请键入 Get-Help Get-Credential。

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

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ID

指定托管 UNIX 或 Linux 计算机对象的 ID。 仅返回与此值匹配的 ID 属性的唯一托管计算机。 此参数是从管道接受的。

参数属性

类型:

Guid[]

默认值:None
支持通配符:False
不显示:False

参数集

FromAgentGuidsParameterSetName
Position:Named
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Name

指定一个或多个托管 UNIX 和 Linux 计算机的完全限定域名列表。 仅返回与 Name 属性匹配的托管计算机。

可以包括通配符，在这种情况下，返回与通配符匹配的所有计算机。 有关使用通配符的信息，请键入 Get-Help About_Wildcards。

此参数是从管道接受的。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False
别名:显示名称

参数集

FromAgentNamesParameterSetName
Position:1
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ResourcePool

指定一个服务器资源池，其中一个被分配给当前管理服务器，另一个充当备份管理服务器。 此参数需要资源池对象，并且仅返回该资源池中的托管计算机。

有关如何获取 SCOMResourcePool 对象的信息，请键入 Get-Help Get-SCOMResourcePool。

参数属性

类型:ManagementServicePool
默认值:None
支持通配符:False
不显示:False
别名:RP

参数集

FromResourcePoolParameterSetName
Position:Named
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SCSession

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

如果未指定此参数，cmdlet 将使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。 有关详细信息，请键入 Get-Help about_OpsMgr_Connections。

参数属性

类型:

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。

输出

Microsoft.Unix.Computer

当 UNIX 和 Linux 计算机与输入条件匹配时，此 cmdlet 返回一个或多个表示托管 UNIX 和 Linux 计算机的计算机对象。