Compartilhar via

Set-SCOMLocation

Módulo:
OperationsManager Module

Associa computadores gerenciados por agente, servidores de gerenciamento ou pools de recursos a um local.

Sintaxe

FromAgent (Padrã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. Esse cmdlet remove uma associação atual, se houver uma. O Painel de Mapa de Resumo de Monitoramento de Disponibilidade do Aplicativo 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 de local que tem o nome de exibição de Seattle, WA e armazena o objeto na variável $Location.

O segundo comando obtém o objeto de agente chamado Server01.Contoso.com e armazena o objeto na variável $Agent.

O terceiro comando associa o local armazenado na variável $Location ao 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 à localização nova-iorquina, NY. O primeiro comando obtém o objeto de localização que tem o nome de exibição de Nova York, NY e 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 ao 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 de localização que tem o nome de exibição Paris, FR e 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 AgentManagedComputer, use o cmdlet Get-SCOMAgent.

Propriedades do parâmetro

Tipo:

AgentManagedComputer[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromAgent
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do grupo de gerenciamento atual.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Location

Especifica um local como um objeto EnterpriseManagementObject . Para obter um local, use o cmdlet Get-SCOMLocation.

Propriedades do parâmetro

Tipo:EnterpriseManagementObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:

ManagementServer[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromManagementServer
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Pool

Especifica uma matriz de objetos do pool de recursos. Para obter um objeto de pool de recursos, use o cmdlet Get-SCOMResourcePool .

Propriedades do parâmetro

Tipo:

ManagementServicePool[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromPool
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SCSession

Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCOMManagementGroupConnection .

Propriedades do parâmetro

Tipo:

Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.