Set-SCOMLocation
Associa computadores gerenciados por agente, servidores de gerenciamento ou pools de recursos a um local.
Sintaxe
FromAgent (Predefinição)
Set-SCOMLocation
[-Agent] <AgentManagedComputer[]>
-Location <EnterpriseManagementObject>
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromManagementServer
Set-SCOMLocation
[-ManagementServer] <ManagementServer[]>
-Location <EnterpriseManagementObject>
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromPool
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 gerenciados por agente, servidores de gerenciamento ou pools de recursos a um local. Este cmdlet remove uma associação atual, se existir. O Painel de Mapa de Resumo do Monitoramento de Disponibilidade de Aplicativos Web exibe informações de estado para agentes, servidores de gerenciamento e pools de recursos associados a um local.
Você pode remover uma associação usando o cmdlet Remove-SCOMLocation. Você pode criar um local usando o cmdlet New-SCOMLocation.
Por padrão, esse cmdlet usa a conexão persistente ativa com um grupo de gerenciamento.
Use o parâmetro SCSession para especificar uma conexão persistente diferente.
Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential.
Para obter mais informações, digite Get-Help about_OpsMgr_Connections.
Exemplos
Exemplo 1: Associar um agente a um local
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 gerenciado por agente chamado Sever01.Contoso.com ao local Seattle, WA. O primeiro comando obtém o objeto location que tem o nome de exibição de Seattle, WA e, em seguida, armazena o objeto na variável $Location.
O segundo comando obtém o objeto de agente chamado Server01.Contoso.com e, em seguida, armazena o objeto na variável $Agent.
O terceiro comando associa o local armazenado na variável $Location com o computador gerenciado pelo agente armazenado na variável $Agent. Se você associou anteriormente esse computador gerenciado por agente a um local, o comando removerá essa associação.
Exemplo 2: Associar um servidor de gerenciamento a um local
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 gerenciamento chamado MgmtServer01.Contoso.com ao local Nova York, NY. O primeiro comando obtém o objeto location que tem o nome de exibição de New York, NY e, em seguida, armazena o objeto na variável $Location.
O segundo comando obtém o objeto do servidor de gerenciamento chamado MgmtServer01.Contoso.com e armazena o objeto na variável $MgmtServer.
O terceiro comando associa o local armazenado na variável $Location com o servidor de gerenciamento armazenado na variável $MgmtServer. Se você associou anteriormente esse servidor de gerenciamento a um local, o comando removerá essa associação.
Exemplo 3: Associar um pool 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 pool de recursos chamado Pool de Recursos de Notificações ao local Paris, FR. O primeiro comando obtém o objeto location que tem o nome de exibição Paris, FR e, em seguida, armazena o objeto na variável $Location.
O segundo comando obtém o pool de recursos chamado Pool de Recursos de Notificações e armazena o objeto na variável $Pool.
O terceiro comando associa o local armazenado na variável $Location ao pool de recursos armazenado na variável $Pool. Se você associou anteriormente o pool de recursos a um local, o comando removerá essa associação.
Parâmetros
-Agent
Especifica uma matriz de objetos AgentManagedComputer.
Para obter um objeto
Propriedades dos parâmetros
| Tipo: | AgentManagedComputer[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromAgent
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ComputerName
Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).
O serviço de Acesso a Dados do System Center deve estar em execução no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão atual do grupo de gerenciamento.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica um objeto PSCredential Get-Help Get-Credential.
Se você especificar um computador no parâmetro
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Location
Especifica um local como um objeto
Propriedades dos parâmetros
| Tipo: | EnterpriseManagementObject |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ManagementServer
Especifica uma matriz de objetos do servidor de gerenciamento. Para obter um objeto de servidor de gerenciamento, use o cmdlet Get-SCOMManagementServer.
Propriedades dos parâmetros
| Tipo: | ManagementServer[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromManagementServer
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PassThru
Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, esse cmdlet não gera nenhuma saída.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Pool
Especifica uma matriz de objetos de pool de recursos. Para obter um objeto de pool de recursos, use o cmdlet Get-SCOMResourcePool.
Propriedades dos parâmetros
| Tipo: | ManagementServicePool[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromPool
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SCSession
Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCOMManagementGroupConnection.
Propriedades dos parâmetros
| Tipo: | Connection[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.