共用方式為


Get-SCOMAgent

取得管理群組中的代理程式管理電腦。

Syntax

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 會使用電腦進行目前的管理群組連線。

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

-Credential

指定管理群組連接的 PSCredential 物件。 若要取得 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

-DNSHostName

指定代理程式管理電腦的網域名稱系統 (DNS) 主機的名稱。

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

-ManagementServer

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

Type:ManagementServer
Aliases:MS
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

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

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

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

輸出

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer