Compartilhar 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 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 só obtém 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

Esse comando primeiro cria sessões CIM usando new-cimSessione, 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

Esse comando obtém as sessões CIM conectadas ao computador chamado Server02.

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

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

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

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

Exemplo 4: Obter todas as sessões cim que têm 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

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

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

Esse comando obtém a sessão CIM que tem uma ID 2.

Parâmetros

-ComputerName

Especifica o nome do computador ao qual as sessões CIM sã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 (ID) da sessão CIM a ser obtido. 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 inteiro que identifica exclusivamente a sessão CIM na sessão atual do PowerShell. É mais fácil de lembrar e digitar do que InstanceId, mas é exclusivo apenas 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 obtido.

InstanceId é um GUID que identifica exclusivamente uma sessão CIM. A InstanceId é exclusiva, mesmo quando você tem várias sessões em execução no PowerShell.

A InstanceId é armazenada 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

Saídas

CimSession