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

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 pelo 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 pelo ComputerName, na lista separada por vírgulas.

New-CimSession -ComputerName Server01,Server02,Server03

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

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

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

Você pode usar o nome amigável de uma sessão CIM para fazer referência à 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 pelo ComputerName, usando o objeto PSCredential especificado pela Credencial e o tipo de autenticação especificado pela Autenticação.

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 pelo ComputerName usando a porta TCP especificada pela Porta.

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 COM distribuído (DCOM) em vez do 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, no Windows Server 2008 e nas versões posteriores do Windows.

Cuidado

A autenticação credSSP (Provedor de Serviços de Segurança de Credencial) 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 do certificado, use os Get-Item cmdlets ou Get-ChildItem os cmdlets 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 uma 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 a credencial não for especificada, a conta de usuário atual será usada.

Especifique o valor da Credencial 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 de entidade 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 Get-CimSession cmdlet. 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 para a 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 do 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 poderão ser recuperadas, pois a operação no servidor atinge o tempo limite 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 de WS-Management remoto por dois motivos: verificar se o servidor remoto está escutando o número da porta especificado usando o parâmetro Port e verificar as credenciais de conta especificadas. A verificação é realizada usando uma operação de WS-Identity padrão. Você pode adicionar o parâmetro de opção SkipTestConnection se o ponto de extremidade de WS-Management remoto não puder usar o WS-Identifi, ou 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

Esse cmdlet não aceita entradas.

Saídas

CimSession