Get-CimSession
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
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 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 (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.
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 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.