Compartilhar via

Get-CimSession

Módulo:
CimCmdlets Module

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

Sintaxe

ComputerNameSet (Padrão) 

Get-CimSession
    [[-ComputerName] <String[]>]
    [<CommonParameters>]

SessionIdSet 

Get-CimSession
    [-Id] <UInt32[]>
    [<CommonParameters>]

InstanceIdSet 

Get-CimSession
    -InstanceId <Guid[]>
    [<CommonParameters>]

NameSet 

Get-CimSession
    -Name <String[]>
    [<CommonParameters>]

Description

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 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 de CIM, confira 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 então 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 formatar a lista

Este exemplo obtém todas as sessões DE 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 possui um Id igual a 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 são conectadas. Caracteres curinga são permitidos.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False
Aliases:China, Nome do Servidor

Conjuntos de parâmetros

ComputerNameSet
Cargo:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Id

Especifica o identificador da sessão CIM a ser obtido. Para várias IDs, use vírgulas para separar as IDs ou use o operador de intervalo (..) para especificar um intervalo de IDs. Um identificador é um número inteiro que identifica de forma exclusiva a sessão CIM dentro da sessão atual do PowerShell.

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

Propriedades do parâmetro

Tipo:

UInt32[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SessionIdSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-InstanceId

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

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

A InstanceID é armazenada na propriedade InstanceID do objeto que representa uma sessão CIM.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

InstanceIdSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

NameSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Não é possível transferir objetos para esse cmdlet.

Saídas

CimSession

Esse cmdlet retorna um objeto de sessão CIM.