Get-SCOMLocation
获取位置。
语法
Empty (默认值)
Get-SCOMLocation
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgent
Get-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementServer
Get-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromPool
Get-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromDisplayName
Get-SCOMLocation
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMOIdParameterSetName
Get-SCOMLocation
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
说明
Get-SCOMLocation cmdlet 获取位置。 指定要通过显示名称或 ID 获取的位置,或者通过指定关联的代理、管理服务器或资源池获取的位置。
可以使用 New-SCOMLocation cmdlet 创建位置。
默认情况下,此 cmdlet 使用与管理组的活动持久连接。
使用 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变量中。
第二个命令获取存储在$Agent变量中的代理对象的位置。
示例 3:获取管理服务器的位置
PS C:\>$MgmtSvr = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMLocation -ManagementServer $MgmtSvr
此示例获取名为 MgmtServer01.Contoso.com 的管理服务器的位置。 第一个命令获取名为 MgmtServer01.Contoso.com 的管理服务器的管理服务器对象,然后将该对象存储在$MgmtSvr变量中。
第二个命令获取存储在$MgmtSvr变量中的管理服务器对象的位置。
示例 4:获取资源池的位置
PS C:\>$Pool = Get-SCOMResourcePool -Name "Pool01"
PS C:\> Get-SCOMLocation -Pool $Pool
此示例获取名为 Pool01 的资源池的位置。 第一个命令获取名为 Pool01 的资源池的资源池对象,并将该对象存储在$Pool变量中。
第二个命令获取存储在$Pool变量中的池的位置。
参数
-Agent
指定 AgentManagedComputer 对象的数组。 若要获取 AgentManagedComputer 对象,请使用 Get-SCOMAgent cmdlet。
参数属性
| 类型: | AgentManagedComputer[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromAgent
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ComputerName
指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名(FQDN)。 若要指定本地计算机,请键入计算机名称、localhost 或点(.)。
System Center Data Access 服务必须在计算机上运行。 如果未指定计算机,该 cmdlet 将使用计算机进行当前管理组连接。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Credential
为管理组连接指定 PSCredential 对象。
若要获取 PSCredential 对象,请使用 Get-Credential cmdlet。
有关详细信息,请键入 Get-Help Get-Credential。
如果在 ComputerName 参数中指定计算机,请使用有权访问该计算机的帐户。 默认值为当前用户。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DisplayName
指定显示名称数组。 此参数的值取决于导入的本地化管理包以及运行 Windows PowerShell 的用户的区域设置。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromDisplayName
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Id
指定位置的唯一 ID 数组。
参数属性
| 类型: | Guid[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromEMOIdParameterSetName
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ManagementServer
指定管理服务器对象的数组。 若要获取管理服务器对象,请使用 Get-SCOMManagementServer cmdlet。
参数属性
| 类型: | ManagementServer[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromManagementServer
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Pool
指定资源池对象的数组。 若要获取资源池对象,请使用 Get-SCOMResourcePool cmdlet。
参数属性
| 类型: | ManagementServicePool[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
FromPool
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SCSession
指定 连接 对象的数组。 若要获取 连接 对象,请使用 Get-SCOMManagementGroupConnection cmdlet。
参数属性
| 类型: | Connection[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。