New-CimSession

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.

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.

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.

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.

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.

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.

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.

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

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.