O cmdlet New-CimSessionOption cria uma instância de um objeto de opções de sessão CIM. Use um objeto de opções de sessão CIM como entrada para o cmdlet New-CimSession para especificar as opções de uma sessão CIM.
Esse cmdlet tem dois conjuntos de parâmetros, um para opções do WsMan e outro para opções de DCOM (Modelo de Objeto de Componente Distribuído). Dependendo de quais parâmetros você usa, o cmdlet retorna uma instância de opções de sessão DCOM ou retorna opções de sessão do WsMan.
Exemplos
Exemplo 1: Criar um objeto de opções de sessão CIM para DCOM
Este exemplo cria um objeto de opções de sessão CIM para o protocolo DCOM e o armazena em uma variável chamada $so. Em seguida, o conteúdo da variável é passado para o cmdlet New-CimSession.
New-CimSession cria uma nova sessão CIM com o servidor remoto denominado Server01, usando as opções definidas na variável.
Exemplo 2: Criar um objeto de opções de sessão CIM para WsMan
Este exemplo cria um objeto de opções de sessão CIM para o protocolo WsMan. O objeto contém a configuração para o modo de autenticação de Kerberos especificado pelo parâmetro ProxyAuthentication, as credenciais especificadas pelo parâmetro ProxyCredential e especifica que o comando é ignorar a verificação de AC, ignorar a verificação CN e usar SSL.
Este exemplo especifica a cultura usada para a sessão CIM. Por padrão, a cultura do cliente é usada ao executar operações. No entanto, a cultura padrão pode ser substituída usando o parâmetro Culture.
Parâmetros
-Culture
Especifica a cultura de interface do usuário a ser usada para a sessão CIM. Especifique o valor desse parâmetro usando um dos seguintes formatos:
Um nome de cultura no formato <languagecode2>-<country/regioncode2>, como "en-US".
Uma variável que contém um objeto CultureInfo .
Um comando que obtém um objeto CultureInfo, como get-culture
Indica que a conexão Kerberos está se conectando a um serviço cujo nome principal do serviço (SPN) inclui o número da porta do serviço. Esse tipo de conexão não é comum.
Cria uma sessão DCOM para a Instrumentação de Gerenciamento do Windows (WMI) usando representação.
Os valores válidos para este parâmetro são:
Padrão: o DCOM pode escolher o nível de representação usando seu algoritmo normal de negociação de segurança.
Nenhum: o cliente é anônimo para o servidor. O processo do servidor pode representar o cliente, mas o token de representação não contém nenhuma informação e não pode ser usado.
Identificar: permite que os objetos consultem as credenciais do chamador.
Representar: permite que os objetos usem as credenciais do chamador.
Delegar: Permite que objetos autorizem outros objetos a usarem as credenciais do chamador.
Se a Representação não for especificado, o cmdlet New-CimSession usará o valor de Representar.
Especifica que a sessão DCOM criada para WMI usa a funcionalidade PacketIntegrity do Modelo de Objeto de Componente (COM). Por padrão, todas as sessões CIM criadas usando DCOM têm o parâmetro PacketIntegrity definido como True.
Cria uma sessão DCOM para WMI usando o COM PacketPrivacy. Por padrão, todas as sessões CIM criadas usando DCOM têm o parâmetro PacketPrivacy definido como verdadeiro.
Especifica o método de autenticação a ser usado para resolução de proxy. Os valores aceitáveis para esse parâmetro são: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain ou CredSsp.
Especifica o certificado de chave pública digital (x.509) de uma conta de usuário para autenticação de proxy.
Insira a impressão digital do certificado. Os certificados são usados na autenticação baseada em certificado do cliente. Eles só podem ser mapeados para contas de usuário locais e não funcionam com contas de domínio.
Para obter uma impressão digital do certificado, use os cmdlets Get-Item ou Get-ChildItem na unidade Cert: do PowerShell.
Especifica o mecanismo de resolução de nomes de host a ser usado. Os valores aceitáveis para esse parâmetro são: None, WinHttp, Autoou InternetExplorer.
O valor padrão desse parâmetro é InternetExplorer.
Indica que, ao se conectar via HTTPS, o cliente não valida se o certificado do servidor é assinado por uma AC (autoridade de certificação) confiável.
Use esse parâmetro somente quando o computador remoto for confiável usando outro mecanismo, como quando o computador remoto faz parte de uma rede fisicamente segura e isolada, ou quando o computador remoto é listado como um host confiável em uma configuração do WinRM.
Indica que o CN (nome comum do certificado) do servidor não precisa corresponder ao nome do host do servidor. Use esse parâmetro para operações remotas somente com computadores confiáveis que usam o protocolo HTTPS.
Indica que o SSL deve ser usado para estabelecer uma conexão com o computador remoto. Por padrão, o SSL não é usado. O WsMan criptografa todo o conteúdo transmitido pela rede, mesmo ao usar HTTP.
Esse parâmetro permite especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta usada para a conexão e você especificar esse parâmetro, o comando falhará.
É recomendável que você use esse parâmetro somente quando o parâmetro PacketPrivacy não for especificado.
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível transferir objetos para esse cmdlet.
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
