共用方式為

Get-SCOMAgent

  • 參考
模組:
OperationsManager

取得管理群組中的代理程式管理計算機。

語法

Get-SCOMAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-ManagementServer] <ManagementServer>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-DNSHostName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

Get-SCOMAgent Cmdlet 會取得管理群組中的代理程式管理計算機。 您可以指定 DNSHostName 參數，以取得域名系統 （DNS） 主機上的代理程式管理計算機，也可以指定 ManagementServer 參數，以取得主要管理伺服器的所有子代理程式管理計算機。

範例

範例 1：取得管理群組中的所有代理程式

PS C:\>Get-SCOMAgent -ComputerName "Server01.Contoso.Com"

此命令會與名為 Server01 的電腦建立暫時連線，並取得管理群組中的所有代理程式。

範例 2：取得管理伺服器所管理的代理程式

PS C:\>$MgmtServer = Get-SCOMManagementServer "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMAgent -ManagementServer $MgmtServer

此範例會取得由管理伺服器管理的代理程式管理計算機。

第一個命令會取得名為 MgmtServer01.Contoso.com 的管理伺服器物件，並將物件儲存在$MgmtServer變數中。

第二個命令會取得由儲存在 $MgmtServer 之管理伺服器的代理程式。

範例 3：使用代理程式名稱取得管理群組中的代理程式

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com", "Server02*", "*.Contoso.com"

此命令會取得名為 server01.contoso.com 的代理程式，其名稱開頭為 Server02，且位於 Contoso.com 網域中。

範例 4：取得網域中的所有代理程式

PS C:\>Get-SCOMAgent -DNSHostName "*.Contoso.com" -ComputerName "Server01.Contoso.com"

此命令會與名為 Server01.Contoso.com 的計算機建立暫時連線，並取得 Contoso.com 網域中的所有代理程式。

參數

-ComputerName

指定計算機名稱的陣列。 您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱 （FQDN）。 若要指定本機計算機，請輸入計算機名稱、localhost 或點 （.）。

System Center 資料存取服務必須在電腦上執行。 如果您未指定計算機，Cmdlet 會使用計算機進行目前的管理群組連線。

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

-Credential

指定管理群組連線 PSCredential 物件。 若要取得 PSCredential 物件，請使用 get-Credential Cmdlet 。 如需詳細資訊，請輸入 Get-Help Get-Credential。

如果您在 ComputerName 參數中指定電腦，請使用可存取該電腦的帳戶。 預設值為目前的使用者。

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

-DNSHostName

指定代理程式管理計算機的功能變數名稱系統 （DNS） 主機名稱。

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

-ManagementServer

指定 ManagementServer 物件。 此參數會指定要從中擷取所有子代理程式的主要管理伺服器。 若要取得 ManagementServer 物件，請使用 Get-SCOMManagementServer Cmdlet。

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

-SCSession

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

連接物件代表與管理伺服器的連接。 預設值為目前的管理群組連線。

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

輸出

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer