次の方法で共有

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>]

説明

Get-SCOMAgent コマンドレットは、管理グループ内のエージェントで管理されるコンピューターを取得します。 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変数にオブジェクトを格納します。

2 番目のコマンドは、$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 Data Access サービスがコンピューター上で実行されている必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。

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

-Credential

管理グループ接続の PSCredential オブジェクトを指定します。 PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細を表示するには「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 コマンドレットを使用します。

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

-SCSession

Connection オブジェクトの配列を指定します。 Connection オブジェクトを取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。

接続オブジェクトは、管理サーバーへの接続を表します。 既定値は現在の管理グループ接続です。

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

出力

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer