共用方式為

Get-SCXAgent

  • 參考
模組:
OperationsManager

取得管理群組中的受控 UNIX 和 Linux 計算機清單。

語法

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

Description

Get-SCXAgent Cmdlet 會擷取符合所提供選取準則的 Managed UNIX 和 Linux 計算機。 如果未指定選取準則，則會傳回管理群組中的所有Managed UNIX 和Linux電腦。

結果會以Managed 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"

此命令會傳回 Managed 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 資料存取服務必須在電腦上使用中。 如果您未指定計算機，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

-ID

指定 Managed UNIX 或 Linux 計算機物件的識別碼。 只傳回唯一標識碼屬性符合此值的受管理計算機。 這個參數會從管線接受。

類型:Guid[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

指定一或多個受控 UNIX 和 Linux 電腦的完整域名清單。 只會傳回符合 Name 屬性的受管理電腦。

您可以包含通配符，在此情況下會傳回符合通配符的所有計算機。 如需使用通配符的相關信息，請輸入 Get-Help About_Wildcards。

這個參數會從管線接受。

類型:String[]
別名:DisplayName
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ResourcePool

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

如需如何取得 SCOMResourcePool 物件的相關信息，請輸入 Get-Help Get-SCOMResourcePool。

類型:ManagementServicePool
別名:RP
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-SCSession

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

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

類型:Connection[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸出

Microsoft.Unix.Computer[]

當 UNIX 和 Linux 電腦符合輸入準則時，此 Cmdlet 會傳回一或多個代表 Managed UNIX 和 Linux 計算機的 Computer 物件。