Set-SCOMLocation

Módulo:

OperationsManager

Associa computadores geridos por agentes, servidores de gestão ou piscinas de recursos com uma localização.

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

O Cmdlet Set-SCOMLocation associa um ou mais computadores geridos por agentes, servidores de gestão ou piscinas de recursos com uma localização. Este cmdlet remove uma associação atual, se existir. O Painel de Mapas de Monitorização da Disponibilidade de Aplicações Na Web apresenta informações do Estado para agentes, servidores de gestão e piscinas de recursos associadas a uma localização.

Pode remover uma associação utilizando o cmdlet Remove-SCOMLocation . Pode criar uma localização utilizando o cmdlet New-SCOMLocation .

Por predefinição, este cmdlet utiliza a ligação persistente ativa a um grupo de gestão. Utilize o parâmetro SCSession para especificar uma ligação persistente diferente. Pode criar uma ligação temporária a um grupo de gestão utilizando os parâmetros ComputerName e Credential . Para mais informações, insira Get-Help about_OpsMgr_Connections.

Exemplos

Exemplo 1: Associar um agente com uma localização

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

Este exemplo associa um computador gerido por agentes chamado Sever01.Contoso.com com a localização Seattle, WA. O primeiro comando obtém o objeto de localização que tem o nome de exibição de Seattle, WA, e depois armazena o objeto na variável $Location.

O segundo comando recebe o objeto do agente chamado Server01.Contoso.com, e depois armazena o objeto na variável $Agent.

O terceiro comando associa a localização armazenada na variável $Location com o computador gerido pelo agente armazenado na variável $Agent. Se anteriormente associasse este computador gerido pelo agente a uma localização, o comando remove essa associação.

Exemplo 2: Associar um servidor de gestão a uma localização

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

Este exemplo associa um servidor de gestão chamado MgmtServer01.Contoso.com com a localização de Nova Iorque, NY. O primeiro comando obtém o objeto de localização que tem o nome de exibição de Nova Iorque, NY, e depois armazena o objeto na variável $Location.

O segundo comando recebe o objeto do servidor de gestão chamado MgmtServer01.Contoso.com, e armazena o objeto na variável $MgmtServer.

O terceiro comando associa a localização armazenada na variável $Location com o servidor de gestão armazenado na variável $MgmtServer. Se anteriormente associasse este servidor de gestão a uma localização, o comando remove essa associação.

Exemplo 3: Associar um conjunto de recursos a um local

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

Este exemplo associa um conjunto de recursos chamado Notifications Resource Pool com a localização Paris, FR. O primeiro comando obtém o objeto de localização que tem o nome de exibição Paris, FR, e depois armazena o objeto na variável $Location.

O segundo comando recebe o conjunto de recursos denominado Conjunto de Recursos de Notificações e, em seguida, armazena o objeto na variável $Pool.

O terceiro comando associa a localização armazenada na variável $Location com o conjunto de recursos armazenado na variável $Pool. Se anteriormente associasse o conjunto de recursos a uma localização, o comando remove essa associação.

Parâmetros

-Agent

Especifica uma matriz de objetos AgentManagedComputer . Para obter um objeto AgentManagedComputer , utilize o cmdlet Get-SCOMAgent .

Type:	AgentManagedComputer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Especifica uma série de nomes de computadores. O cmdlet estabelece ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio totalmente qualificados (FQDNs). Para especificar o computador local, digite o nome do computador, local local ou um ponto (.).

O serviço de acesso a dados do Centro de Sistemas deve estar a funcionar no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Especifica um objeto PSCredential para a ligação do grupo de gestão. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Especifica uma localização como um objeto EnterpriseManagementObject . Para obter uma localização, utilize o cmdlet Get-SCOMLocation .

Type:	EnterpriseManagementObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagementServer

Especifica uma série de objetos do servidor de gestão. Para obter um objeto de servidor de gestão, utilize o cmdlet Get-SCOMManagementServer .

Type:	ManagementServer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar na tubagem. Por predefinição, este cmdlet não gera quaisquer dados.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Pool

Especifica uma variedade de objetos de piscina de recursos. Para obter um objeto de piscina de recursos, utilize o cmdlet Get-SCOMResourcePool .

Type:	ManagementServicePool[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Especifica uma matriz de objetos de ligação . Para obter um objeto de ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Ligações Relacionadas

• Get-SCOMAgent
• Get-SCOMManagementServer
• Get-SCOMResourcePool
• Get-SCOMLocation
• New-SCOMLocation
• Remove-SCOMLocation
• Update-SCOMLocation