Get-CimSession

  • Referência
Módulo:
CimCmdlets

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

Syntax

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 você pode identificar 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 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, em seguida, formatar a lista

Este exemplo obtém todas as sessões CIM na sessão atual do PowerShell e exibe uma tabela contendo 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 um 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.

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Id

Especifica o identificador da sessão CIM a ser obtida. Para várias IDs, use vírgulas para separar as IDs ou use o operador range (..) para especificar um intervalo de IDs. Um Id é um 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.

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

-InstanceId

Especifica os IDs de instância da sessão CIM a serem obtidas.

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.

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

-Name

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

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

Entradas

None

Não é possível 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.