共用方式為


Get-SCXAgent

取得管理群組中受管理的 UNIX 和 Linux 電腦清單。

Syntax

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 電腦。 如果未指定選取準則,則會傳回管理群組中的所有受管理 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 會使用電腦進行目前的管理群組連線。

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

-ID

指定 Managed UNIX 或 Linux 電腦物件的識別碼。 只傳回識別碼屬性符合此值的唯一受管理電腦。 此參數可從管線接受。

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

-Name

指定一或多部受控 UNIX 和 Linux 電腦的完整功能變數名稱清單。 只傳回符合 Name 屬性的受管理電腦。

您可以包含萬用字元,在此情況下會傳回符合萬用字元的所有電腦。 如需使用萬用字元的資訊,請輸入 Get-Help About_Wildcards

此參數可從管線接受。

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

-ResourcePool

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

如需如何取得 SCOMResourcePool 物件的資訊,請輸入 Get-Help Get-SCOMResourcePool

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

-SCSession

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

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

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

輸出

Microsoft.Unix.Computer[]

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