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 參數來指定不同的持續性連線。
您可以使用 ComputerName 和 Credential 參數,建立管理群組的暫時連線。
如需詳細資訊,請鍵入 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 物件。