Partilhar via

Get-SCOMLocation

  • Referência
Módulo:
OperationsManager

Obtém localizações.

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 localizações. Especifique as localizações para obter pelo nome de exibição ou ID, ou especificando agentes associados, servidores de gestão ou piscinas de recursos.

Pode criar uma localização utilizando o cmdlet New-SCOMLocation .

Por predefinição, este cmdlet utiliza a ligação persistente ativa a um grupo de gestão. Utilize o parâmetro SCSession para especificar uma ligação persistente diferente. Pode criar uma ligação temporária a um grupo de gestão utilizando os parâmetros ComputerName e Credential . Para mais informações, insira Get-Help about_OpsMgr_Connections.

Exemplos

Exemplo 1: Obtenha uma localização pelo nome de exibição

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

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

Exemplo 2: Obtenha a localização de um computador gerido por um agente

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

Este exemplo obtém uma localização para um computador gerido por um agente. O primeiro comando obtém o objeto do agente para um computador gerido por um agente chamado Server01.Contoso.com e, em seguida, armazena o objeto na variável $Agent.

O segundo comando obtém a localização do objeto do agente armazenado na variável $Agent.

Exemplo 3: Obtenha a localização de um servidor de gestão

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

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

O segundo comando obtém a localização do objeto do servidor de gestão armazenado na variável $MgmtSvr.

Exemplo 4: Obtenha a localização de uma piscina de recursos

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

Este exemplo obtém uma localização para o conjunto de recursos chamado Pool01. O primeiro comando obtém o objeto de piscina de recursos para o conjunto de recursos chamado Pool01 e armazena o objeto na variável $Pool.

O segundo comando obtém a localização da piscina armazenada na variável $Pool.

Parâmetros

-Agent

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

Type:AgentManagedComputer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica uma série de nomes de computadores. O cmdlet estabelece ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio totalmente qualificados (FQDNs). Para especificar o computador local, digite o nome do computador, local local ou um ponto (.).

O serviço de acesso a dados do Centro de Sistemas deve estar a funcionar no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão 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 ligação do grupo de gestão. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica uma série de nomes de exibição. Os valores para este parâmetro dependem dos pacotes de gestão localizados que importa e da localidade do utilizador que executa Windows PowerShell.

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Id

Especifica uma variedade de IDs únicos de locais.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementServer

Especifica uma série de objetos do servidor de gestão. Para obter um objeto de servidor de gestão, utilize o cmdlet Get-SCOMManagementServer .

Type:ManagementServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pool

Especifica uma variedade de objetos de piscina de recursos. Para obter um objeto de piscina de recursos, utilize 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 de ligação . Para obter um objeto de ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False