次の方法で共有

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

管理グループ接続 PSCredential オブジェクトを指定します。 PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細については、「Get-Help Get-Credential」と入力します。

ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DNSHostName

エージェントで管理されるコンピューターのドメイン ネーム システム (DNS) ホストの名前を指定します。

型:String[]
Aliases:Name
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ManagementServer

ManagementServer オブジェクトを指定します。 このパラメーターは、すべての子エージェントの取得元となるプライマリ管理サーバーを指定します。 ManagementServer オブジェクトを取得するには、Get-SCOMManagementServer コマンドレットを使用します。

型:ManagementServer
Aliases:MS
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SCSession

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

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

型:Connection[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer