Get-CimSession
Obtém os objetos de sessão CIM da sessão atual.
Sintaxe
ComputerNameSet (Default)
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>]
SessionIdSet
Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>]
InstanceIdSet
Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>]
NameSet
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.
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 (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 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 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.
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.