New-CimSession

  • Referência
Módulo:
CimCmdlets

Cria uma sessão CIM.

Syntax

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

O New-CimSession cmdlet cria uma sessão CIM. Uma sessão CIM é um objeto do lado do cliente que representa uma conexão com um computador local ou um computador remoto. A sessão CIM contém informações sobre a conexão, como ComputerName, o protocolo usado ou vários identificadores.

Esse cmdlet retorna um objeto de sessão CIM que pode ser usado por todos os outros cmdlets CIM.

Exemplos

Exemplo 1: Criar uma sessão CIM com opções padrão

Este exemplo cria uma sessão CIM local com opções padrão. Se ComputerName não for especificado, New-CimSession criará uma sessão DCOM para o computador local.

New-CimSession

Exemplo 2: Criar uma sessão CIM para um computador específico

Este exemplo cria uma sessão CIM para o computador especificado por ComputerName. Por padrão, New-CimSession cria uma sessão WSMan quando ComputerName é especificado.

New-CimSession -ComputerName Server01

Exemplo 3: Criar uma sessão CIM para vários computadores

Este exemplo cria uma sessão CIM para cada um dos computadores especificados por ComputerName, na lista separada por vírgula.

New-CimSession -ComputerName Server01,Server02,Server03

Exemplo 4: Criar uma sessão CIM com um nome amigável

Este exemplo cria uma sessão CIM remota para cada um dos computadores especificados por ComputerName, na lista separada por vírgula, e atribui um nome amigável às novas sessões, especificando Name.

New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*

Você pode usar o nome amigável de uma sessão CIM para se referir à sessão em outros cmdlets CIM, por exemplo, Get-CimSession.

Exemplo 5: Criar uma sessão CIM para um computador usando um objeto PSCredential

Este exemplo cria uma sessão CIM para o computador especificado por ComputerName, usando o objeto PSCredential especificado por Credential e o tipo de autenticação especificado por Authentication.

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

Você pode criar um objeto PSCredential usando o Get-Credential cmdlet.

Exemplo 6: Criar uma sessão CIM para um computador usando uma porta específica

Este exemplo cria uma sessão CIM para o computador especificado por ComputerName usando a porta TCP especificada por Port.

New-CimSession -ComputerName Server01 -Port 1234

Exemplo 7: Criar uma sessão CIM usando DCOM

Este exemplo cria uma sessão CIM usando o protocolo DCOM (Distributed COM) em vez de WSMan.

$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Parâmetros

-Authentication

Especifica o tipo de autenticação usado para as credenciais do usuário. Os valores aceitáveis para esse parâmetro são:

  • Padrão
  • Digest
  • Negotiate
  • Basic
  • Kerberos
  • NtlmDomain
  • CredSsp

Você não pode usar o tipo de autenticação NtlmDomain para conexão com o computador local. A autenticação CredSSP está disponível apenas no Windows Vista, Windows Server 2008 e versões posteriores do Windows.

Cuidado

A autenticação CredSSP (Credential Security Service Provider) foi projetada para comandos que exigem autenticação em mais de um recurso, como acessar um compartilhamento de rede remoto. Esse mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, as credenciais que são passadas a ele podem ser usadas para controlar a sessão de rede.

Type:PasswordAuthenticationMechanism
Accepted values:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificateThumbprint

Especifica o certificado de chave pública digital (X.509) de uma conta de usuário que tem permissão para executar essa ação. Insira a impressão digital do certificado.

Os certificados são utilizados na autenticação baseada em certificado do cliente. Eles podem ser mapeados somente para contas de usuário local; eles não funcionam com contas de domínio.

Para obter uma impressão digital de certificado, use os Get-Item cmdlets or Get-ChildItem no Provedor de Certificados do PowerShell.

Para obter mais informações, consulte about_Certificate_Provider.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica o nome do computador para o qual criar a sessão CIM. Especifique um único nome de computador ou vários nomes de computador separados por vírgula.

Se ComputerName não for especificado, uma sessão CIM para o computador local será criada. Você pode especificar o valor para o nome do computador em um dos seguintes formatos:

  • Um ou mais nomes NetBIOS
  • Um ou mais endereços IP
  • Um ou mais nomes de domínio totalmente qualificados.

Se o computador estiver em um domínio diferente do usuário, você deverá especificar o nome de domínio totalmente qualificado.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Especifica uma conta de usuário que tem permissão para executar esta ação. Se Credential não for especificado, a conta de usuário atual será usada.

Especifique o valor de Credential usando um dos seguintes formatos:

  • Um nome de usuário: "User01"
  • Um nome de domínio e um nome de usuário: "Domain01\User01"
  • Um nome principal de usuário: "User@Domain.com"
  • Um objeto PSCredential, como um retornado pelo Get-Credential cmdlet.

Quando você digitar um nome de usuário, uma senha será solicitada.

Type:PSCredential
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica um nome amigável para a sessão CIM.

Você pode usar o nome para fazer referência à sessão CIM ao usar outros cmdlets, como o cmdlet Get-CimSession . Não é necessário que o nome do computador ou da sessão atual seja exclusivo.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Duração pela qual o cmdlet aguarda uma resposta do servidor.

Por padrão, o valor desse parâmetro é 0, o que significa que o cmdlet usa o valor de tempo limite padrão para o servidor.

Se o parâmetro OperationTimeoutSec for definido como um valor menor que o tempo limite de repetição de conexão robusto de 3 minutos, as falhas de rede que duram mais do que o valor do parâmetro OperationTimeoutSec não serão recuperáveis, porque a operação no servidor expira antes que o cliente possa se reconectar.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Port

Especifica a porta de rede no computador remoto que é usada para esta conexão. Para se conectar a um computador remoto, este deve estar escutando na porta usada pela conexão. As portas padrão são 5985 (a porta de WinRM para HTTP) e 5986 (a porta de WinRM para HTTPS).

Antes de usar uma porta alternativa, você deve configurar o ouvinte de WinRM no computador remoto para escutar na porta. Use os seguintes comandos para configurar o ouvinte:

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

Não use o parâmetro Port, a menos que seja necessário. A configuração da porta no comando se aplica a todos os computadores ou sessões em que o comando for executado. Uma configuração de porta alternativa pode impedir que o comando seja executado em todos os computadores.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SessionOption

Define opções avançadas para a nova sessão CIM. Insira o nome de um objeto CimSessionOption criado usando o New-CimSessionOption cmdlet.

Type:CimSessionOptions
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipTestConnection

Por padrão, o New-CimSession cmdlet estabelece uma conexão com um ponto de extremidade remoto do WS-Management por dois motivos: para verificar se o servidor remoto está escutando o número da porta especificado usando o parâmetro Port e para verificar as credenciais de conta especificadas. A verificação é realizada usando uma operação WS-Identity padrão. Você pode adicionar o parâmetro de opção SkipTestConnection se o ponto de extremidade remoto do WS-Management não puder usar o WS-Identify ou para reduzir algum tempo de transmissão de dados.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

None

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

Saídas

CimSession

Esse cmdlet retorna um objeto de sessão CIM.

Observações

O PowerShell inclui os seguintes aliases para New-CimSession:

  • Windows:
    • ncms

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