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