共用方式為

Invoke-SCXDiscovery

  • 參考
模組:
OperationsManager

針對 UNIX 和 Linux 電腦的指定組態叫用探索作業。

Syntax

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>]

Description

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 資料存取服務必須在電腦上使用中。 如果您未指定電腦，Cmdlet 會使用電腦進行目前的管理群組連線。

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

-Credential

指定管理群組連接執行所在的使用者帳戶。 針對此參數指定 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

-IPRange

指定將用於探索的 IP 位址範圍。 IPRange必須包含兩個 IP 位址 (，例如 192.168.0.1，192.168.0.254) 。 必須指定 IPRange 或 Name 參數。

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

-Name

指定將用於探索之逗號) 分隔的有效主機名稱、FQDN 或 IP 位址清單 (。 必須指定 IPRange 或 Name 參數。 此參數可從管線接受。

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

-ResourcePool

指定伺服器的資源集區，其中一個指派為目前管理伺服器，而其他伺服器則作為備份管理伺服器。 此參數需要資源集區物件，而且只會傳回該資源集區中的受管理電腦。

如需如何取得資源集區物件的詳細資訊，請輸入 Get-Help Get-SCOMResourcePool 。

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

-SCSession

指定 Connection 物件的陣列。 若要取得 Connection 物件，請使用 Get-SCOMManagementGroupConnection Cmdlet。

如果未指定此參數，Cmdlet 會使用管理群組的使用中持續性連線。 使用 SCSession 參數來指定不同的持續性連線。 您可以使用 ComputerName 和 Credential 參數，建立管理群組的暫時連線。 如需詳細資訊，請鍵入 Get-Help about_OpsMgr_Connections。

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

-SshCredential

指定用來執行代理程式安裝動作的特殊許可權 SSH 認證。 如果未指定此參數，除非已在目的電腦上安裝代理程式，否則探索會失敗。

如需如何取得 SSH 認證物件的資訊，請輸入 Get-Help Get-SCXSSHCredential 。

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

-SshPort

指定要用於與主機進行 SSH 通訊的埠。 如果未指定，則會使用預設值 22。

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

-WsManCredential

指定透過 WS-Management 用於低許可權代理程式通訊的認證。

輸入使用者名稱，例如 User01 或輸入 PSCredential 物件，例如 Get-Credential Cmdlet 所傳回的使用者名稱。 當您輸入使用者名稱時，會提示您輸入密碼。 如需詳細資訊，請鍵入 Get-Help Get-Credential。

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

輸出

DiscoveryResult

此 Cmdlet 會傳回 DiscoveryResult 物件的陣列，代表計畫探索之每個目的電腦的探索結果。