Get-SCXAgent
管理グループ内の管理対象 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 オブジェクトを返します。