New-CimSession

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
• Resumo
• Negociar
• Básico
• Kerberos
• NtlmDomínio
• CredSsp

Não é possível 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), na qual as credenciais do usuário são passadas para um computador remoto para ser autenticado, foi projetada para comandos que exigem autenticação em mais de um recurso, como acessar um compartilhamento de rede remoto. Este mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, as credenciais que são passadas para ele podem ser usadas para controlar a sessão de rede.

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 de cliente. Eles podem ser mapeados apenas para contas de usuário locais; eles não funcionam com contas de domínio.

Para obter uma impressão digital de 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 Certificado do PowerShell, digite Get-Help Certificateou consulte Provedor de Certificados.

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.

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

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

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

Quando introduz um nome de utilizador, é-lhe solicitada uma palavra-passe.

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 seja exclusivo do computador ou da sessão atual.

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 inferior ao 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.

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 ouvir 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 de porta no comando se aplica a todos os computadores ou sessões nos quais o comando é executado. Uma configuração de porta alternativa pode impedir que o comando seja executado em todos os computadores.

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

Por padrão, o cmdlet New-CimSession estabelece uma conexão com um ponto de extremidade de WS-Management remoto 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 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-Identify ou se quiser reduzir algum tempo de transmissão de dados.