Compartilhar via


Get-CimSession

Obtém os objetos de sessão CIM da sessão atual.

Sintaxe

Get-CimSession
   [[-ComputerName] <String[]>]
   [<CommonParameters>]
Get-CimSession
   [-Id] <UInt32[]>
   [<CommonParameters>]
Get-CimSession
   -InstanceId <Guid[]>
   [<CommonParameters>]
Get-CimSession
   -Name <String[]>
   [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

Por padrão, o cmdlet obtém todas as sessões CIM criadas na sessão atual do PowerShell. Você pode usar os parâmetros de Get-CimSession para obter as sessões que são para computadores específicos ou pode identificar as sessões por seus nomes ou outros identificadores. Get-CimSession não obtém sessões CIM que foram criadas em outras sessões do PowerShell ou que foram criadas em outros computadores.

Para obter mais informações sobre sessões CIM, consulte about_CimSession.

Exemplos

Exemplo 1: Obter sessões CIM da sessão atual do PowerShell

Este exemplo cria sessões CIM usando New-CimSession e, em seguida, obtém as sessões CIM usando Get-CimSession.

New-CimSession -ComputerName Server01,Server02
Get-CimSession

Id           : 1
Name         : CimSession1
InstanceId   : d1413bc3-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol     : WSMAN

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Exemplo 2: Obter as sessões CIM para um computador específico

Este exemplo obtém as sessões CIM que estão conectadas ao computador chamado Server02.

Get-CimSession -ComputerName Server02

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Exemplo 3: Obter uma lista de sessões CIM e formatar a lista

Este exemplo obtém todas as sessões CIM na sessão atual do PowerShell e exibe uma tabela que contém apenas as propriedades ComputerName e InstanceID .

Get-CimSession | Format-Table -Property ComputerName,InstanceId

ComputerName InstanceId
------------ ----------
Server01     d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02     c0095981-52c5-4e7f-a5bb-c4c680541710

Exemplo 4: Obter todas as sessões CIM que têm nomes específicos

Este exemplo obtém todas as sessões CIM que têm nomes que começam com serv.

Get-CimSession -ComputerName Serv*

Id           : 1
Name         : CimSession1
InstanceId   : d1413bc-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol     : WSMAN

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Exemplo 5: Obter uma sessão CIM específica

Este exemplo obtém a sessão CIM que tem uma ID de 2.

Get-CimSession -ID 2

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Parâmetros

-ComputerName

Especifica o nome do computador ao qual as sessões CIM serão conectadas. Caracteres curinga são permitidos.

Tipo:String[]
Aliases:CN, ServerName
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Id

Especifica o identificador da sessão CIM a ser obtida. Para vários IDs, use vírgulas para separar os IDs ou use o operador de intervalo (..) para especificar um intervalo de IDs. Uma ID é um número inteiro que identifica exclusivamente a sessão CIM dentro da sessão atual do PowerShell.

Para obter mais informações sobre o operador de intervalo, consulte about_Operators.

Tipo:UInt32[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InstanceId

Especifica as IDs de instância da sessão CIM a ser obtida.

InstanceId é um identificador global exclusivo (GUID) que identifica exclusivamente uma sessão CIM. O InstanceId é exclusivo, mesmo quando você tem várias sessões em execução no PowerShell.

O InstanceId é armazenado na propriedade InstanceId do objeto que representa uma sessão CIM.

Tipo:Guid[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Obtém uma ou mais sessões CIM que contêm os nomes amigáveis especificados. Caracteres curinga são permitidos.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

CimSession

Esse cmdlet retorna um objeto de sessão CIM.

Observações

O PowerShell inclui os seguintes aliases para Get-CimSession:

  • Windows:
    • gcms

Esse cmdlet só está disponível em plataformas Windows.