次の方法で共有

Get-SCXAgent

  • リファレンス
モジュール:
OperationsManager

管理グループ内の管理対象 UNIX および Linux コンピューターの一覧を取得します。

構文

Get-SCXAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ID <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ResourcePool <ManagementServicePool>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

説明

Get-SCXAgent コマンドレットは、指定された選択条件に一致する管理対象 UNIX および Linux コンピューターを取得します。 選択条件が指定されていない場合は、管理グループ内のすべての管理対象 UNIX および Linux コンピューターが返されます。

結果は、マネージド UNIX および Linux コンピューター オブジェクトの配列として返されます。

例

例 1: 管理対象 UNIX および Linux コンピューターを返す

PS C:\>Get-SCXAgent

このコマンドは、リソース プール内のすべての管理対象 UNIX および Linux コンピューターを返します。

例 2: リソース プールから管理対象 UNIX および Linux コンピューターを返す

PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePool

最初のコマンドは、Get-SCOMResourcePool コマンドレットを使用してリソース プールを取得し、$ResourcePool変数に格納します。

2 番目のコマンドは、$ResourcePool内のリソース プールのすべての管理対象 UNIX および Linux コンピューターを返します。

例 3: 名前を使用して管理対象 UNIX および Linux コンピューターを返す

PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"

このコマンドは、指定された文字列の一覧に一致する名前を持つ管理対象 UNIX および Linux コンピューターを返します。

例 4: パイプラインを使用してマネージド UNIX および Linux コンピューターを返す

PS C:\>"server1", "server2", "server3" | Get-SCXAgent

このコマンドは、パイプラインを介して Name パラメーターを提供します。

例 5: リソース プールに接続し、名前でマネージド コンピューターを取得する

PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"

このコマンドは、現在のユーザーの資格情報を使用して、一時的な接続を使用してリソース プールに接続し、 Name プロパティに一致するマネージド コンピューターのみを返します。

パラメーター

-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

管理グループ接続を実行するユーザー アカウントを指定します。 このパラメーターに対して、Get-Credential コマンドレットから返される PSCredential オブジェクト (例: PSCredential オブジェクト) を指定します。 資格情報オブジェクトの詳細については、「.」と入力します Get-Help Get-Credential。

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ID

管理対象 UNIX または Linux コンピューター オブジェクトの ID を指定します。 この値に一致する ID プロパティを持つ唯一のマネージド コンピューターのみを返します。 このパラメーターはパイプラインから受け入れられます。

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

-Name

1 つ以上の管理対象 UNIX および Linux コンピューターの完全修飾ドメイン名の一覧を指定します。 Name プロパティと一致するマネージド コンピューターのみを返します。

ワイルドカードを含めることができます。この場合、ワイルドカードに一致するすべてのコンピューターが返されます。 ワイルドカードの使用については、「.」と入力します Get-Help About_Wildcards。

このパラメーターはパイプラインから受け入れられます。

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

-ResourcePool

サーバーのリソース プールを指定します。そのうちの 1 つは現在の管理サーバーに割り当てられ、もう 1 つはバックアップ管理サーバーとして機能します。 このパラメーターにはリソース プール オブジェクトが必要であり、そのリソース プール内のマネージド コンピューターのみが返されます。

SCOMResourcePool オブジェクトを取得する方法については、「.」と入力しますGet-Help Get-SCOMResourcePool。

Type:ManagementServicePool
Aliases:RP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

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

このパラメーターを指定しない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。 SCSession パラメーターを使用して、別の永続的な接続を指定します。 ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。 詳細を表示するには「Get-Help about_OpsMgr_Connections」を入力します。

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

出力

Microsoft.Unix.Computer[]

このコマンドレットは、UNIX コンピューターと Linux コンピューターが入力条件に一致する場合に、管理対象の UNIX および Linux コンピューターを表す 1 つ以上の Computer オブジェクトを返します。