Partilhar via

Get-SCOMLocation

Módulo:
OperationsManager Module

Obtém localizações.

Sintaxe

Empty (Predefinição) 

Get-SCOMLocation
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAgent 

Get-SCOMLocation
    [-Agent] <AgentManagedComputer[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementServer 

Get-SCOMLocation
    [-ManagementServer] <ManagementServer[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromPool 

Get-SCOMLocation
    [-Pool] <ManagementServicePool[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromDisplayName 

Get-SCOMLocation
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromEMOIdParameterSetName 

Get-SCOMLocation
    -Id <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

O cmdlet Get-SCOMLocation obtém locais. Especifique os locais a serem obtidos por nome de exibição ou ID ou especificando agentes associados, servidores de gerenciamento ou pools de recursos.

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: Obter um local por nome de exibição

PS C:\>Get-SCOMLocation -DisplayName "Seattle, WA"

Este comando obtém o local que tem o nome de exibição Seattle, WA.

Exemplo 2: Obter o local de um computador gerenciado por agente

PS C:\>$Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Get-SCOMLocation -Agent $Agent

Este exemplo obtém um local para um computador gerenciado por agente. O primeiro comando obtém o objeto agent para um computador gerenciado por agente chamado Server01.Contoso.com e, em seguida, armazena o objeto na variável $Agent.

O segundo comando obtém o local para o objeto do agente armazenado na variável $Agent.

Exemplo 3: Obter o local de um servidor de gerenciamento

PS C:\>$MgmtSvr = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMLocation -ManagementServer $MgmtSvr

Este exemplo obtém o local de um servidor de gerenciamento chamado MgmtServer01.Contoso.com. O primeiro comando obtém o objeto do servidor de gerenciamento para o servidor de gerenciamento chamado MgmtServer01.Contoso.com e, em seguida, armazena o objeto na variável $MgmtSvr.

O segundo comando obtém o local do objeto do servidor de gerenciamento armazenado na variável $MgmtSvr.

Exemplo 4: Obter o local de um pool de recursos

PS C:\>$Pool = Get-SCOMResourcePool -Name "Pool01"
PS C:\> Get-SCOMLocation -Pool $Pool

Este exemplo obtém um local para o pool de recursos chamado Pool01. O primeiro comando obtém o objeto do pool de recursos para o pool de recursos chamado Pool01 e armazena o objeto na variável $Pool.

O segundo comando obtém o local do pool armazenado na variável $Pool.

Parâmetros

-Agent

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

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

-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 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

-DisplayName

Especifica uma matriz de nomes para exibição. Os valores para esse parâmetro dependem de quais pacotes de gerenciamento localizados você importa e da localidade do usuário que executa o Windows PowerShell.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromDisplayName
Position:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Id

Especifica uma matriz de IDs exclusivos de locais.

Propriedades dos parâmetros

Tipo:

Guid[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromEMOIdParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:True
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

-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

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.