Partilhar via

New-CimSessionOption

Módulo:
CimCmdlets Module

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

Sintaxe

ProtocolTypeSet (Predefinição) 

New-CimSessionOption
    [-Protocol] <ProtocolType>
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

WSManParameterSet 

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>]

DcomParameterSet 

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 para uma sessão CIM.

Este cmdlet tem dois conjuntos de parâmetros, um para opções WsMan e outro para opções DCOM (Distributed Component Object Model). Dependendo dos parâmetros usados, 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 é passado para o cmdlet New-CimSession. New-CimSession 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 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 da autoridade de certificação, ignorar a verificação CN e usar SSL.

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

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 este parâmetro usando um dos seguintes formatos:

  • Um nome de cultura em 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

Propriedades dos parâmetros

Tipo:CultureInfo
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 do serviço. Este tipo de ligação não é comum.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Encoding

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

Propriedades dos parâmetros

Tipo:PacketEncoding
Default value:None
Valores aceites:Default, Utf8, Utf16
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Uri
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Impersonation

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

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

  • Padrão: o DCOM pode escolher o nível de imitação usando o 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.
  • Fazer-se passar por: Permite que os objetos usem as credenciais do chamador.
  • Delegar: Permite que outros objetos usem as credenciais do chamador.

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

Propriedades dos parâmetros

Tipo:ImpersonationType
Default value:None
Valores aceites:Default, None, Identify, Impersonate, Delegate
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

DcomParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MaxEnvelopeSizeKB

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

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-NoEncryption

Especifica que a criptografia de dados está desativada.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PacketIntegrity

Especifica que a sessão DCOM criada para WMI utiliza a funcionalidade de integridade de pacotes (PacketIntegrity) do modelo de objetos componentes (COM) . Por padrão, todas as sessões CIM criadas usando DCOM têm o parâmetro PacketIntegrity definido como True.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

DcomParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PacketPrivacy

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 true.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

DcomParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Protocol

Especifica o protocolo a ser usado. Os valores aceitáveis para este parâmetro são: Dcom, Defaultou Wsman.

Propriedades dos parâmetros

Tipo:ProtocolType
Default value:None
Valores aceites:Dcom, Default, Wsman
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ProtocolTypeSet
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ProxyAuthentication

Especifica o método de autenticação a ser usado para resolução de proxy. Os valores aceitáveis para este parâmetro são: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomainou CredSsp.

Propriedades dos parâmetros

Tipo:PasswordAuthenticationMechanism
Default value:None
Valores aceites:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 (thumbprint) do certificado. Os certificados são usados na autenticação baseada em certificado de 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, utilize os cmdlets Get-Item ou Get-ChildItem na unidade Cert: do PowerShell.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ProxyCredential

Especifica as credenciais a serem usadas para autenticação de proxy. Insira uma das seguintes opções:

  • 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, não será possível especificar nenhuma credencial.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProxyType

Especifica o mecanismo de resolução de nome de host a ser usado. Os valores aceitáveis para este parâmetro são: Nenhum, WinHttp, Autoou Internet Explorer.

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

Propriedades dos parâmetros

Tipo:ProxyType
Default value:InternetExplorer
Valores aceites:None, WinHttp, Auto, InternetExplorer
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SkipCNCheck

Indica que o nome comum do certificado (CN) 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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-UICulture

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

  • Um nome de cultura em 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.

Propriedades dos parâmetros

Tipo:CultureInfo
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 encripta todo o conteúdo transmitido através da rede, mesmo quando utiliza HTTP.

Este 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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

WSManParameterSet
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

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 canalizar objetos para este cmdlet.

Saídas

CimSessionOptions

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