Set-SCOMLocation
將代理程式管理的電腦、管理伺服器或資源集區與位置產生關聯。
Syntax
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>]Description
Set-SCOMLocation Cmdlet 會將一或多個代理程式管理的電腦、管理伺服器或資源集區與位置產生關聯。 如果存在此 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 的位置產生關聯。 第一個命令會取得位置物件，該物件具有西雅圖、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 的位置產生關聯。 第一個命令會取得位置物件，該物件具有顯示名稱巴黎、FR，然後將物件儲存在$Location變數中。
第二個命令會取得名為 Notifications Resource Pool 的資源集區，然後將物件儲存在$Pool變數中。
第三個命令會將儲存在 $Location 變數中的位置與儲存在 $Pool 變數中的資源集區產生關聯。 如果您先前將資源集區與位置相關聯，命令會移除該關聯。
參數
-Agent
指定 AgentManagedComputer 物件的陣列。 若要取得 AgentManagedComputer 物件，請使用 Get-SCOMAgent Cmdlet。
| Type: | AgentManagedComputer[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
指定電腦名稱的陣列。 Cmdlet 會為這些電腦建立與管理群組的暫時連線。 您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱， (FQDN) 。 若要指定本機電腦，請輸入電腦名稱、localhost 或句點 (.)。
System Center 資料存取服務必須在電腦上執行。 如果您未指定電腦，Cmdlet 會使用電腦進行目前的管理群組連線。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定管理群組連線的 PSCredential 物件。
若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。
如需詳細資訊，請鍵入 Get-Help Get-Credential。
如果您在 ComputerName 參數中指定電腦，請使用可存取該電腦的帳戶。 預設為目前使用者。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
指定位置做為 EnterpriseManagementObject 物件。 若要取得位置，請使用 Get-SCOMLocation Cmdlet。
| Type: | EnterpriseManagementObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementServer
指定管理伺服器物件的陣列。 若要取得管理伺服器物件，請使用 Get-SCOMManagementServer Cmdlet。
| Type: | ManagementServer[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
表示 Cmdlet 會建立或修改命令可以在管線中使用的物件。 根據預設，此 Cmdlet 不會產生任何輸出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Pool
指定資源集區物件的陣列。 若要取得資源集區物件，請使用 Get-SCOMResourcePool Cmdlet。
| Type: | ManagementServicePool[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
指定 Connection 物件的陣列。 若要取得 Connection 物件，請使用 Get-SCOMManagementGroupConnection Cmdlet。
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |