New-CimSession

Sintaxe

CredentialParameterSet (Predefinição)

New-CimSession
    [[-Credential] <PSCredential>]
    [[-ComputerName] <String[]>]
    [-Authentication <PasswordAuthenticationMechanism>]
    [-Name <String>]
    [-OperationTimeoutSec <UInt32>]
    [-SkipTestConnection]
    [-Port <UInt32>]
    [-SessionOption <CimSessionOptions>]
    [<CommonParameters>]

CertificateParameterSet

New-CimSession
    [[-ComputerName] <String[]>]
    [-CertificateThumbprint <String>]
    [-Name <String>]
    [-OperationTimeoutSec <UInt32>]
    [-SkipTestConnection]
    [-Port <UInt32>]
    [-SessionOption <CimSessionOptions>]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Criar uma sessão CIM com opções padrão

New-CimSession

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

New-CimSession -ComputerName Server01

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

New-CimSession -ComputerName Server01,Server02,Server03

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

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

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

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

Exemplo 6: Criar uma sessão CIM para um computador usando uma porta específica

New-CimSession -ComputerName Server01 -Port 1234

Exemplo 7: Criar uma sessão CIM usando DCOM

$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:

• Predefinido
• 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 (thumbprint) 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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, será criada uma sessão CIM para o computador local.

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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Credential

Especifica uma conta de usuário que tem permissão para executar essa ação. Se a credencial não for especificada, a conta de utilizador 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-OperationTimeoutSec

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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 a escutar na porta à qual a ligação é feita. 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-SessionOption

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-SkipTestConnection

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.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

None

Saídas

CimSession

Ligações Relacionadas

• Get-ChildItem
• Get-Credential
• Get-Item
• Get-CimSession
• Remove-CimSession
• New-CimSessionOption
• acerca_de_CimSession