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

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 para a conexão, a ID da sessão e a ID da instância.

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

New-CimSession

Esse comando 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.

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

New-CimSession -ComputerName Server01

Esse comando cria uma sessão CIM para o computador especificado por ComputerName. Por padrão, New-CimSession cria uma sessão do WsMan quando ComputerName é especificado.

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

New-CimSession -ComputerName Server01,Server02,Server03

Esse comando cria uma sessão CIM para cada um dos computadores especificados pelo ComputerName, na lista separada por vírgulas.

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

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

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

Esse comando 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.

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

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

Esse comando cria uma sessão CIM para o computador especificado por ComputerName, usando o objeto PSCredential especificado por de Credencial e o tipo de autenticação especificado por Authentication.

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

New-CimSession -ComputerName Server01 -Port 1234

Esse comando cria uma sessão CIM para o computador especificado pelo ComputerName usando a porta TCP especificada por Porta.

Exemplo 7: Criar uma sessão CIM usando DCOM

$SessionOption = New-CimSessionOption -Protocol DCOM

New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Esse comando cria uma sessão CIM usando o protocolo DCOM (Distributed COM) em vez do WSMan.

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. 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 (Provedor de Serviços de Segurança de Credencial), na qual as credenciais do usuário são passadas para um computador remoto a ser autenticado, 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
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 sobre como usar o provedor de Certificados do PowerShell, digite Get-Help Certificateou consulte do Provedor de Certificados.

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.

Você também pode passar um nome de computador (entre aspas) para New-CimSession usando o pipeline.

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 opção SkipTestConnection se o ponto de extremidade de WS-Management remoto não puder usar WS-Identifi ou se quiser 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

Esse cmdlet não aceita entradas.

Saídas

CimSession