Get-SCOMLocation
Obtém locais.
Sintaxe
Empty (Padrã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, servidores de gerenciamento ou pools de recursos associados.
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"
Esse 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 do agente 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 do 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 a localização 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 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 atual do grupo de gerenciamento.
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 |
-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 |
-DisplayName
Especifica uma matriz de nomes de exibição. Os valores desse parâmetro dependem de quais pacotes de gerenciamento localizados você importa e da localidade do usuário que executa o Windows PowerShell.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromDisplayName
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Id
Especifica uma matriz de IDs exclusivos de locais.
Propriedades do parâmetro
| Tipo: | Guid[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromEMOIdParameterSetName
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| 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 |
-Pool
Especifica uma matriz de objetos do pool de recursos. Para obter um objeto do 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 |
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.