Get-SCOMLocation
Obtém locais.
Syntax
Get-SCOMLocation
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMLocation
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
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"
Esse comando obtém o local que tem o nome de exibição Seattle, WA.
Exemplo 2: Obter a localização 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 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 a localização 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 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 a localização 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 .
Type: | AgentManagedComputer[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Especifica uma matriz de nomes de 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 Windows PowerShell.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
Especifica uma matriz de IDs exclusivas de locais.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ManagementServer
Especifica uma matriz de objetos do servidor de gerenciamento. Para obter um objeto de servidor de gerenciamento, use o cmdlet Get-SCOMManagementServer .
Type: | ManagementServer[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Pool
Especifica uma matriz de objetos do pool de recursos. Para obter um objeto de pool de recursos, use 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 Connection . Para obter um objeto Connection , use o cmdlet Get-SCOMManagementGroupConnection .
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |