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

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

O cmdlet New-CimSession 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 do 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 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 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 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 por de Credencial 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 cmdlet Get-Credential.

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 por 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 este parâmetro são:

  • Inadimplência
  • Digerir
  • Negociar
  • Básico
  • Kerberos
  • NtlmDomain
  • CredSsp

Você não pode usar o tipo de autenticação NtlmDomain para conexão com o computador local. autenticação de credSSP está disponível apenas no Windows Vista, Windows Server 2008 e 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 passadas para ele poderão 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.

Os certificados são usados na autenticação baseada em certificado do cliente. Eles podem ser mapeados apenas 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 cmdlets Get-Item ou 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 uma vírgula.

Se ComputerName não for especificado, uma sessão CIM para o computador local será criada. Você pode especificar o valor do 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 essa ação. Se de Credencial não for especificado, a conta de usuário atual será usada.

Especifique o valor para de 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 cmdlet Get-Credential.

Quando você digita um nome de usuário, você é solicitado a obter uma senha.

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. O nome não é necessário para ser exclusivo para o computador ou a sessão atual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 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, 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 essa conexão. Para se conectar a um computador remoto, o computador remoto deve estar escutando na porta que a conexão usa. As portas padrão são 5985 (a porta WinRM para HTTP) e 5986 (a porta WinRM para HTTPS).

Antes de usar uma porta alternativa, você deve configurar o ouvinte do WinRM no computador remoto para escutar nessa 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 nas quais o comando é 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 cmdlet New-CimSessionOption.

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 cmdlet New-CimSession 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 Porta 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 alternância 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.

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 redirecionar objetos para este 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.