Partilhar via

Get-CimSession

Módulo:
CimCmdlets Module

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

Sintaxe

ComputerNameSet (Predefiniçã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

Este 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 depois 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 com 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 com o valor de 2 em .

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 coringa são permitidos.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False
Aliases:China, Nome do servidor

Conjuntos de parâmetros

ComputerNameSet
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Id

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

Propriedades dos parâmetros

Tipo:

UInt32[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SessionIdSet
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-InstanceId

Especifica os identificadores de instância da sessão CIM que deve obter.

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.

Propriedades dos parâmetros

Tipo:

Guid[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InstanceIdSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

NameSet
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 canalizar objetos para este cmdlet.

Saídas

CimSession

Este cmdlet retorna um objeto de sessão CIM.

Notas

O PowerShell inclui os seguintes aliases para Get-CimSession:

  • Windows:
    • gcms

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