Invoke-SCXDiscovery

模块:

OperationsManager

为 UNIX 和 Linux 计算机的指定配置调用发现操作。

语法

Invoke-SCXDiscovery
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      -Name <String[]>
      -ResourcePool <ManagementServicePool>
      [-SshPort <Int32>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [<CommonParameters>]

Invoke-SCXDiscovery
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      -ResourcePool <ManagementServicePool>
      -IPRange <IPAddress[]>
      [-SshPort <Int32>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [<CommonParameters>]

说明

Invoke-SCXDiscovery cmdlet 为 UNIX 和 Linux 计算机的指定配置调用发现操作。

该操作使用 SSH 凭据对象执行特权 SSH 安装操作，使用可选的 Windows PowerShell 凭据对象进行低特权 WS-Management 代理通信。 如果代理已在目标主机上手动安装，则只需要低特权 WS-Management 凭据。

此 cmdlet 的输出是 DiscoveryResult 对象的数组，表示尝试发现的每个目标计算机的发现结果。

示例

示例 1：发现 IP 地址范围内的 UNIX 和 Linux 计算机

PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key22.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool "pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredential

第一个命令使用 Get-Credential cmdlet 获取用户的凭据。 该命令会提示你进行身份验证，然后将结果存储在$WSCredential变量中。

第二个命令使用 Get-SCXSSHCredential cmdlet 为用户创建特权凭据。 该命令将结果存储在$SSHCredential变量中。

第三个命令使用 Get-SCOMResourcePool cmdlet 获取名为 pool01 的资源池，然后将其存储在 $Pool 01 变量中。

最后一个命令可在 IP 地址范围内发现 UNIX 和 Linux 计算机。

示例 2：使用非标准端口按名称发现 UNIX 和 Linux 计算机

PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key c:\keys\DavidChew.ppk -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -SSHPort 8022 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredential

第一个命令通过使用 Get-Credential获取用户的凭据。 该命令会提示你进行身份验证，然后将结果存储在$WSCredential变量中。

第二个命令使用 Get-SCXSSHCredential为用户创建特权凭据。 该命令将结果存储在$SSHCredential变量中。

第三个命令使用 Get-SCOMResourcePool获取名为 pool01 的资源池，然后将其存储在 $Pool 01 变量中。

最后一个命令使用资源池和指定非标准 SSH 端口按名称发现 UNIX 和 Linux 计算机。

示例 3：按名称发现 UNIX 和 Linux 计算机

PS C:\>$Pool = Get-SCOMResourcePool "RP1"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -ResourcePool $Pool -WSManCredential "DavidChew"

第一个命令使用 Get-SCOMResourcePool获取名为 RP1 的资源池，然后将其存储在$Pool变量中。

第二个命令按已安装管理代理的名称发现 UNIX 和 Linux 计算机。

参数

-ComputerName

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

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

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

-Credential

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

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

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

-IPRange

指定将用于发现的 IP 地址范围。 IPRange 必须包含两个 IP 地址（例如 192.168.0.1,192.168.0.254）。 必须指定 IPRange 或 名称 参数。

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

-Name

指定将用于发现的有效主机名、FQDN 或 IP 地址的列表（用逗号分隔）。 必须指定 IPRange 或 名称 参数。 此参数是从管道接受的。

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

-ResourcePool

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

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

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

-SCSession

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

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

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

-SshCredential

指定用于执行代理安装操作的特权 SSH 凭据。 如果未指定此参数，则发现将失败，除非已在目标计算机上安装代理。

有关如何获取 SSH 凭据对象的信息，请键入 Get-Help Get-SCXSSHCredential。

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

-SshPort

指定要用于与主机的 SSH 通信的端口。 如果未指定，则使用默认值 22。

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

-WsManCredential

指定用于通过 WS-Management 进行低特权代理通信的凭据。

键入用户名（如 User01）或输入 PSCredential 对象，例如 Get-Credential cmdlet 返回的用户名。 键入用户名时，系统会提示输入密码。 有关详细信息，请键入 Get-Help Get-Credential。

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

输出

DiscoveryResult

此 cmdlet 返回一个由 DiscoveryResult 对象构成的数组，这些对象表示计划发现的每个目标计算机的发现结果。

相关链接

• Get-SCOMResourcePool
• Get-SCXSSHCredential