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
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
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $soEsse conjunto de comandos 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
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSslEsse comando 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.
Exemplo 3: criar um objeto de opções de sessão CIM com a cultura especificada
New-CimSessionOption -Culture Fr-Fr -Protocol WsmanEsse comando 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:
Insira 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: Padrão, Utf8 ou Utf16.
| Tipo: | PacketEncoding |
| 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. Alterar 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 a WMI (Instrumentação de Gerenciamento do Windows) 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 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.
- Representação: permite que os objetos usem as credenciais do chamador.
- Delegado: permite que os objetos permitam que outros objetos usem as credenciais do chamador.
Se a representação não for especificada, o cmdlet New-CimSession usará o valor 3: Representar
| Tipo: | ImpersonationType |
| 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 Modelo de Objeto de Componente (COM). Para segurança aprimorada, por padrão, todas as sessões CIM criadas usando 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 PacotePrivacy COM. Para segurança aprimorada, por padrão, todas as sessões CIM criadas usando 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 ou WinRM.
| 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 |
| 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.
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 no PowerShell Cert: drive.
| 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 serem usadas 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 nomes de host a ser usado.
Os valores aceitáveis para esse parâmetro são: None, WinHttp, Auto ou InternetExplorer.
Por padrão, o valor desse parâmetro é InternetExplorer.
| Tipo: | ProxyType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-SkipCACheck
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.
| 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 somente para operações remotas que usam o protocolo HTTPS.
Observação: use este 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 |
-SkipRevocationCheck
Indica que a verificação de revogação de certificados de servidor é ignorada.
Observação: use este 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 de interface do usuário a ser usada para a sessão CIM. Especifique o valor desse parâmetro usando um dos seguintes formatos:
- Insira 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, o SSL não é usado.
O WsMan criptografa todo o conteúdo transmitido pela rede. 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
Esse cmdlet não aceita objetos de entrada.
Saídas
CIMSessionOption
Esse cmdlet retorna um objeto que contém informações de opções de sessão CIM.