Compartilhar via

New-CimSession

  • Referência
Módulo:
CimCmdlets

Cria uma sessão CIM.

Sintaxe

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 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í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 CIM remota para cada um dos computadores especificados por ComputerName, na lista separada por vírgulas, 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 em 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 em 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 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
  • NtlmDomínio
  • 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 do Provedor de Serviços de Segurança de Credenciais (CredSSP) 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.

Tipo:PasswordAuthenticationMechanism
Valores aceitos:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Certificados digitais são empregados na autenticação de clientes baseada em certificados. 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 or Get-ChildItem no Provedor de Certificados do PowerShell.

Para obter mais informações, consulte about_Certificate_Provider.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:String[]
Aliases:CN, ServerName
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:PSCredential
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

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

Você pode usar o nome para se referir à 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 robusta de 3 minutos, as falhas de rede que duram mais do que o valor do parâmetro OperationTimeoutSec não serão recuperáveis, pois a operação no servidor atinge o tempo limite antes que o cliente possa se reconectar.

Tipo:UInt32
Aliases:OT
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:CimSessionOptions
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Você não pode 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.