Get-SCOMLocation
場所を取得します。
構文
Get-SCOMLocation
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
説明
Get-SCOMLocation コマンドレットは場所を取得します。 表示名または ID、または関連付けられているエージェント、管理サーバー、またはリソース プールを指定して取得する場所を指定します。
New-SCOMLocation コマンドレットを使用して場所を作成できます。
既定では、このコマンドレットは、管理グループへのアクティブな永続的な接続を使用します。
SCSession パラメーターを使用して、別の永続的な接続を指定します。
ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。
詳細については、「Get-Help about_OpsMgr_Connections
」と入力します。
例
例 1: 表示名で場所を取得する
PS C:\>Get-SCOMLocation -DisplayName "Seattle, WA"
このコマンドは、表示名 Seattle (WA) を持つ場所を取得します。
例 2: エージェントで管理されているコンピューターの場所を取得する
PS C:\>$Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Get-SCOMLocation -Agent $Agent
この例では、エージェントで管理されるコンピューターの場所を取得します。 最初のコマンドは、Server01.Contoso.com という名前のエージェントで管理されるコンピューターのエージェント オブジェクトを取得し、そのオブジェクトを $Agent 変数に格納します。
2 番目のコマンドは、$Agent変数に格納されているエージェント オブジェクトの場所を取得します。
例 3: 管理サーバーの場所を取得する
PS C:\>$MgmtSvr = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMLocation -ManagementServer $MgmtSvr
この例では、MgmtServer01.Contoso.com という名前の管理サーバーの場所を取得します。 最初のコマンドは、MgmtServer01.Contoso.com という名前の管理サーバーの管理サーバー オブジェクトを取得し、そのオブジェクトを $MgmtSvr 変数に格納します。
2 番目のコマンドは、$MgmtSvr変数に格納されている管理サーバー オブジェクトの場所を取得します。
例 4: リソース プールの場所を取得する
PS C:\>$Pool = Get-SCOMResourcePool -Name "Pool01"
PS C:\> Get-SCOMLocation -Pool $Pool
この例では、Pool01 という名前のリソース プールの場所を取得します。 最初のコマンドは、Pool01 という名前のリソース プールのリソース プール オブジェクトを取得し、そのオブジェクトを $Pool 変数に格納します。
2 番目のコマンドは、$Pool変数に格納されているプールの場所を取得します。
パラメーター
-Agent
AgentManagedComputer オブジェクト
型: | AgentManagedComputer[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-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 |
-DisplayName
表示名の配列を指定します。 このパラメーターの値は、インポートするローカライズされた管理パックと、Windows PowerShell を実行するユーザーのロケールによって異なります。
型: | String[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Id
場所の一意の ID の配列を指定します。
型: | Guid[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ManagementServer
管理サーバー オブジェクトの配列を指定します。 管理サーバー オブジェクトを取得するには、Get-SCOMManagementServer コマンドレットを使用します。
型: | ManagementServer[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Pool
リソース プール オブジェクトの配列を指定します。 リソース プール オブジェクトを取得するには、Get-SCOMResourcePool コマンドレットを使用します。
型: | ManagementServicePool[] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SCSession
Connection オブジェクトの配列
型: | Connection[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |