Partilhar via

Get-CimSession

  • Referência
Módulo:
CimCmdlets

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

O cmdlet Get-CimSession obtém os objetos de sessão CIM criados na sessão atual do PowerShell.

Se usado sem parâmetros, 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, IDs ou IDs de instância.

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

Exemplos

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

Por padrão, Get-CimSession obtém apenas informações sobre as sessões CIM existentes na sessão atual do PowerShell. 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.

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

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

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

Get-CimSession -ComputerName Server02

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

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

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

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

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

Este comando obtém todas as sessões CIM na sessão atual do PowerShell e, em seguida, formata a lista em uma tabela contendo apenas as propriedades ComputerName e InstanceID.

Exemplo 4: Obter todas as sessões CIM com nomes específicos

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

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

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

Get-CimSession -ID 2

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

Este comando obtém a sessão CIM que tem um ID de 2.

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
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Id

Especifica o identificador (ID) da sessão CIM a ser obtida. Para uma ou mais IDs, use vírgulas para separar as 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 na sessão atual do PowerShell. É mais fácil lembrar e digitar do que InstanceId, mas é exclusivo apenas na sessão atual do PowerShell.

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

Tipo:UInt32[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-InstanceId

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

InstanceId é um 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[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

Entradas

None

Saídas

CimSession