通过

Set-SCOMLocation

  • 参考
模块:
OperationsManager

将代理管理的计算机、管理服务器或资源池与位置相关联。

语法

Set-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMLocation
   [-Pool] <ManagementServicePool[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-SCOMLocation cmdlet 将一个或多个代理管理的计算机、管理服务器或资源池与位置相关联。 如果存在，此 cmdlet 将删除当前关联。 Web 应用程序可用性监视摘要映射仪表板显示与某个位置关联的代理、管理服务器和资源池的状态信息。

可以使用 Remove-SCOMLocation cmdlet 删除关联。 可以使用 New-SCOMLocation cmdlet 创建位置。

默认情况下，此 cmdlet 使用与管理组的活动持久连接。 使用 SCSession 参数指定不同的持久连接。 可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。 有关详细信息，请键入 Get-Help about_OpsMgr_Connections。

示例

示例 1：将代理与位置相关联

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> $Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -Agent $Agent

本示例将名为 Sever01.Contoso.com 的代理管理的计算机与 Seattle， WA 的位置相关联。 第一个命令获取具有 Seattle、WA 的显示名称的位置对象，然后将该对象存储在$Location变量中。

第二个命令获取名为 Server01.Contoso.com 的代理对象，然后将该对象存储在$Agent变量中。

第三个命令将存储在 $Location 变量中的位置与存储在 $Agent 变量中的代理管理的计算机相关联。 如果以前将此代理管理的计算机与某个位置相关联，该命令将删除该关联。

示例 2：将管理服务器与位置相关联

PS C:\>$Location = Get-SCOMLocation -DisplayName "New York, NY"
PS C:\> $MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -ManagementServer $MgmtServer

此示例将名为 MgmtServer01.Contoso.com 的管理服务器与纽约纽约的位置相关联。 第一个命令获取具有纽约、NY 的显示名称的位置对象，然后将该对象存储在$Location变量中。

第二个命令获取名为 MgmtServer01.Contoso.com 的管理服务器对象，并将对象存储在$MgmtServer变量中。

第三个命令将存储在$Location变量中的位置与存储在$MgmtServer变量中的管理服务器相关联。 如果以前将此管理服务器与某个位置相关联，该命令将删除该关联。

示例 3：将资源池关联到位置

PS C:\>$Location = Get-SCOMLocation -DisplayName "Paris, FR"
PS C:\> $Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Set-SCOMLocation -Location $Location -Pool $Pool

此示例将名为 Notifications 资源池的资源池与巴黎、FR 的位置相关联。 第一个命令获取具有显示名称 Paris、FR 的位置对象，然后将该对象存储在$Location变量中。

第二个命令获取名为 Notifications 资源池的资源池，然后将对象存储在$Pool变量中。

第三个命令将存储在$Location变量中的位置与存储在$Pool变量中的资源池相关联。 如果以前将资源池与某个位置相关联，该命令将删除该关联。

参数

-Agent

指定 AgentManagedComputer 对象的数组。 若要获取 AgentManagedComputer 对象，请使用 Get-SCOMAgent cmdlet。

类型:AgentManagedComputer[]
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ComputerName

指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。

System Center Data Access 服务必须在计算机上运行。 如果未指定计算机，该 cmdlet 将使用计算机进行当前管理组连接。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Credential

为管理组连接指定 PSCredential 对象。 若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。 有关详细信息，请键入 Get-Help Get-Credential。

如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认值为当前用户。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Location

将位置指定为 EnterpriseManagementObject 对象。 若要获取位置，请使用 Get-SCOMLocation cmdlet。

类型:EnterpriseManagementObject
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ManagementServer

指定管理服务器对象的数组。 若要获取管理服务器对象，请使用 Get-SCOMManagementServer cmdlet。

类型:ManagementServer[]
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-PassThru

指示 cmdlet 创建或修改命令可以在管道中使用的对象。 默认情况下，此 cmdlet 不生成任何输出。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Pool

指定资源池对象的数组。 若要获取资源池对象，请使用 Get-SCOMResourcePool cmdlet。

类型:ManagementServicePool[]
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-SCSession

指定 连接 对象的数组。 若要获取 连接 对象，请使用 Get-SCOMManagementGroupConnection cmdlet。

类型:Connection[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False