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:

• Predefinido
• Resumo
• Negociar
• Básica
• 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.

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 Get-Item cmdlets ou 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 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.

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

Especifique o valor para 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 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 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, 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 New-CimSessionOption cmdlet.

Por padrão, o New-CimSession cmdlet estabelece uma conexão com um ponto de extremidade 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 WS-Identity padrão. Você pode adicionar o parâmetro de opção SkipTestConnection se o ponto de extremidade remoto WS-Management não puder usar WS-Identify, ou para reduzir algum tempo de transmissão de dados.