Compartilhar via


New-CimSessionOption

Especifica opções avançadas para o cmdlet New-CimSession.

Sintaxe

New-CimSessionOption
   [-Protocol] <ProtocolType>
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]
New-CimSessionOption
   [-NoEncryption]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-EncodePortInServicePrincipalName]
   [-Encoding <PacketEncoding>]
   [-HttpPrefix <Uri>]
   [-MaxEnvelopeSizeKB <UInt32>]
   [-ProxyAuthentication <PasswordAuthenticationMechanism>]
   [-ProxyCertificateThumbprint <String>]
   [-ProxyCredential <PSCredential>]
   [-ProxyType <ProxyType>]
   [-UseSsl]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]
New-CimSessionOption
   [-Impersonation <ImpersonationType>]
   [-PacketIntegrity]
   [-PacketPrivacy]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

O New-CimSessionOption cmdlet cria uma instância de um objeto de opções de sessão CIM. Você usa um objeto de opções de sessão CIM como entrada para o New-CimSession cmdlet para especificar as opções para uma sessão CIM.

Esse cmdlet tem dois conjuntos de parâmetros, um para opções WsMan e outro para opções DCOM (Distributed Component Object Model). 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 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. O conteúdo da variável é então passado para o New-CimSession cmdlet. New-CimSession em seguida, cria uma nova sessão CIM com o servidor remoto chamado Server01, usando as opções definidas na variável.

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

Exemplo 2: Criar um objeto de opções de sessão CIM para o 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 do Kerberos especificado pelo parâmetro ProxyAuthentication, as credenciais especificadas pelo parâmetro ProxyCredential e especifica que o comando deve ignorar a verificação de CA, ignorar a verificação de CN e usar SSL.

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

Exemplo 3: Criar um objeto de opções de sessão CIM com a cultura especificada

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

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 da interface do usuário a ser usada para a sessão CIM. Especifique o valor para esse parâmetro usando um dos seguintes formatos:

  • Um nome de cultura em <languagecode2>-<country/regioncode2> formato como "EN-US".
  • Uma variável que contém um objeto CultureInfo .
  • Um comando que obtém um objeto CultureInfo , como Get-Culture
Tipo:CultureInfo
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EncodePortInServicePrincipalName

Indica que a conexão Kerberos está se conectando a um serviço cujo SPN (nome da entidade de serviço) inclui o número da porta de serviço. Esse tipo de conexão não é comum.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Encoding

Especifica a codificação usada para o protocolo WsMan. Os valores aceitáveis para esse parâmetro são: Default, Utf8 ou Utf16.

Tipo:PacketEncoding
Valores aceitos:Default, Utf8, Utf16
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HttpPrefix

Especifica a parte da URL HTTP após o nome do computador e o número da porta. Mudar isso não é comum. Por padrão, o valor desse parâmetro é /wsman.

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Impersonation

Cria uma sessão DCOM para o WMI (Instrumentação de Gerenciamento do Windows) usando representação.

Os valores válidos desse parâmetro são:

  • Padrão: o DCOM pode escolher o nível de representação usando seu algoritmo de negociação de segurança normal.
  • 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 os objetos permitam que outros objetos usem as credenciais do chamador.

Se Impersonation não for especificado, o New-CimSession cmdlet usará o valor de Impersonate.

Tipo:ImpersonationType
Valores aceitos:Default, None, Identify, Impersonate, Delegate
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxEnvelopeSizeKB

Especifica o limite de tamanho das mensagens XML do WsMan para qualquer direção.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoEncryption

Especifica que a criptografia de dados está desativada.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PacketIntegrity

Especifica que a sessão DCOM criada para WMI usa a funcionalidade PacketIntegrity do COM (Component Object Model). Por padrão, todas as sessões CIM criadas usando o DCOM têm o parâmetro PacketIntegrity definido como True.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PacketPrivacy

Cria uma sessão DCOM para WMI usando o COM PacketPrivacy. Por padrão, todas as sessões CIM criadas usando o DCOM têm o parâmetro PacketPrivacy definido como true.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Protocol

Especifica o protocolo a ser usado. Os valores aceitáveis para esse parâmetro são: DCOM, Padrão ou Wsman.

Tipo:ProtocolType
Valores aceitos:Dcom, Default, Wsman
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ProxyAuthentication

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.

Tipo:PasswordAuthenticationMechanism
Valores aceitos:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ProxyCertificateThumbprint

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. Certificados digitais são empregados na autenticação de clientes baseada em certificados. 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 Get-Item cmdlets ou Get-ChildItem na unidade Cert: do PowerShell.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ProxyCredential

Especifica as credenciais a usar para autenticação de proxy. Insira um dos seguintes:

  • Uma variável que contém um objeto PSCredential.
  • Um comando que obtém um objeto PSCredential, como Get-Credential

Se essa opção não estiver definida, você não poderá especificar nenhuma credencial.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProxyType

Especifica o mecanismo de resolução de nome de host a ser usado. Os valores aceitáveis para esse parâmetro são: None, WinHttp, Auto ou InternetExplorer.

O valor padrão desse parâmetro é InternetExplorer.

Tipo:ProxyType
Valores aceitos:None, WinHttp, Auto, InternetExplorer
Cargo:Named
Valor padrão:InternetExplorer
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SkipCACheck

Indica que, ao se conectar por HTTPS, o cliente não valida se o certificado do servidor está assinado por uma autoridade de certificação (CA) confiável.

Use esse parâmetro somente quando o computador remoto for confiável usando outro mecanismo, como quando o computador remoto fizer parte de uma rede fisicamente segura e isolada ou quando o computador remoto estiver listado como um host confiável em uma configuração do WinRM.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SkipCNCheck

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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SkipRevocationCheck

Indica que a verificação de revogação de certificados de servidor foi ignorada. Use esse parâmetro somente para computadores confiáveis.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UICulture

Especifica a cultura da interface do usuário a ser usada para a sessão CIM. Especifique o valor para esse parâmetro usando um dos seguintes formatos:

  • Um nome de cultura em <languagecode2>-<country/regioncode2> formato como "EN-US".
  • Uma variável que contém um objeto CultureInfo.
  • Um comando que obtém um objeto CultureInfo, como Get-Culture.
Tipo:CultureInfo
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UseSsl

Indica que o SSL deve ser usado para estabelecer uma conexão com o computador remoto. Por padrão, SSL não é usado. O WsMan criptografa todo o conteúdo transmitido pela rede, mesmo quando se usa 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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

CimSessionOptions

Esse cmdlet retorna um objeto que contém informações de opções de sessão CIM.

Observações

O PowerShell inclui os seguintes aliases para New-CimSessionOption:

  • Windows:
    • ncso

Esse cmdlet só está disponível em plataformas Windows.