New-CimSessionOption
Especifica opciones avanzadas para el cmdlet New-CimSession.
Syntax
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
Este cmdlet solo está disponible en la plataforma Windows.
El New-CimSessionOption cmdlet crea una instancia de un objeto de opciones de sesión CIM. Use un objeto de opciones de sesión CIM como entrada para el New-CimSession cmdlet para especificar las opciones de una sesión CIM.
Este cmdlet tiene dos conjuntos de parámetros, uno para las opciones de WsMan y otro para las opciones del modelo de objetos de componente distribuido (DCOM). En función de los parámetros que use, el cmdlet devuelve una instancia de las opciones de sesión DCOM o devuelve las opciones de sesión de WsMan.
Ejemplos
Ejemplo 1: Crear un objeto de opciones de sesión CIM para DCOM
En este ejemplo se crea un objeto de opciones de sesión CIM para el protocolo DCOM y se almacena en una variable denominada $so. A continuación, el contenido de la variable se pasa al New-CimSession cmdlet .
New-CimSession a continuación, crea una nueva sesión CIM con el servidor remoto denominado Server01, con las opciones definidas en la variable .
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $soEjemplo 2: Crear un objeto de opciones de sesión CIM para WsMan
En este ejemplo se crea un objeto de opciones de sesión CIM para el protocolo WsMan. El objeto contiene la configuración del modo de autenticación de Kerberos especificado por el parámetro ProxyAuthentication , las credenciales especificadas por el parámetro ProxyCredential y especifica que el comando es omitir la comprobación de CA, omitir la comprobación de CN y usar SSL.
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSslEjemplo 3: Crear un objeto de opciones de sesión CIM con la referencia cultural especificada
New-CimSessionOption -Culture Fr-Fr -Protocol WsmanEn este ejemplo se especifica la referencia cultural que se usa para la sesión CIM. De forma predeterminada, la referencia cultural del cliente se usa al realizar operaciones. Sin embargo, la referencia cultural predeterminada se puede invalidar mediante el parámetro Culture .
Parámetros
-Culture
Especifica la referencia cultural de la interfaz de usuario que se va a usar para la sesión CIM. Especifique el valor de este parámetro mediante uno de los siguientes formatos:
- Nombre de referencia cultural en
<languagecode2>-<country/regioncode2>formato como "EN-US". - Variable que contiene un objeto CultureInfo .
- Comando que obtiene un objeto CultureInfo , como Get-Culture
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EncodePortInServicePrincipalName
Indica que la conexión Kerberos se conecta a un servicio cuyo nombre de entidad de seguridad de servicio (SPN) incluye el número de puerto de servicio. Este tipo de conexión no es común.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
Especifica la codificación utilizada para el protocolo WsMan. Los valores aceptables para este parámetro son: Default, Utf8 o Utf16.
| Type: | PacketEncoding |
| Accepted values: | Default, Utf8, Utf16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HttpPrefix
Especifica la parte de la dirección URL HTTP después del nombre del equipo y el número de puerto. Cambiar esto no es habitual. De forma predeterminada, el valor de este parámetro es /wsman.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Impersonation
Crea una sesión DCOM en Instrumental de administración de Windows (WMI) mediante la suplantación.
Los valores válidos para este parámetro son:
- Valor predeterminado: DCOM puede elegir el nivel de suplantación mediante su algoritmo de negociación de seguridad normal.
- Ninguno: el cliente es anónimo para el servidor. El proceso de servidor puede suplantar al cliente, pero el token de suplantación no contiene ninguna información y no se puede usar.
- Identificar: permite a los objetos consultar las credenciales del autor de la llamada.
- Suplantación: permite que los objetos usen las credenciales del autor de la llamada.
- Delegado: permite a los objetos permitir que otros objetos usen las credenciales del autor de la llamada.
Si no se especifica Suplantación , el New-CimSession cmdlet usa el valor de Impersonate.
| Type: | ImpersonationType |
| Accepted values: | Default, None, Identify, Impersonate, Delegate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
Especifica el límite de tamaño de los mensajes XML de WsMan para cualquier dirección.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoEncryption
Especifica que el cifrado de datos está desactivado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketIntegrity
Especifica que la sesión DCOM creada en WMI usa la funcionalidad PacketIntegrity del modelo de objetos componentes (COM). De forma predeterminada, todas las sesiones CIM creadas con DCOM tienen el parámetro PacketIntegrity establecido en True.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketPrivacy
Crea una sesión DCOM en WMI mediante PacketPrivacy COM. De forma predeterminada, todas las sesiones CIM creadas con DCOM tienen el parámetro PacketPrivacy establecido en true.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Especifica el protocolo que se va a usar. Los valores aceptables para este parámetro son: DCOM, Default o Wsman.
| Type: | ProtocolType |
| Accepted values: | Dcom, Default, Wsman |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyAuthentication
Especifica el método de autenticación que se va a usar para la resolución de proxy. Los valores aceptables para este parámetro son: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain o CredSsp.
| Type: | PasswordAuthenticationMechanism |
| Accepted values: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCertificateThumbprint
Especifica el certificado de clave pública digital (x.509) de una cuenta de usuario para la autenticación de proxy. Escriba la huella digital del certificado. Los certificados se usan para la autenticación basada en certificados de cliente. Solo se pueden asignar a cuentas de usuario locales y no funcionan con cuentas de dominio.
Para obtener una huella digital de certificado, use los Get-Item cmdlets o Get-ChildItem en la unidad Cert: de PowerShell.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Especifica las credenciales que se usarán para la autenticación de proxy. Escriba uno de los datos siguientes:
- Variable que contiene un objeto PSCredential.
- Comando que obtiene un objeto PSCredential, como
Get-Credential
Si esta opción no está establecida, no puede especificar ninguna credencial.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyType
Especifica el mecanismo de resolución de nombres de host que se va a usar. Los valores aceptables para este parámetro son: None, WinHttp, Auto o InternetExplorer.
El valor predeterminado de este parámetro es InternetExplorer.
| Type: | ProxyType |
| Accepted values: | None, WinHttp, Auto, InternetExplorer |
| Position: | Named |
| Default value: | InternetExplorer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCACheck
Indica que al conectarse a través de HTTPS, el cliente no valida que el certificado de servidor esté firmado por una entidad de certificación (CA) de confianza.
Use este parámetro solo cuando el equipo remoto sea de confianza mediante otro mecanismo, como cuando el equipo remoto forma parte de una red que está físicamente segura y aislada, o cuando el equipo remoto aparece como un host de confianza en una configuración de WinRM.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCNCheck
Indica que el nombre común (CN) del certificado del servidor no necesita coincidir con el nombre de host del servidor. Use este parámetro solo para las operaciones remotas con equipos de confianza que usen el protocolo HTTPS.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipRevocationCheck
Indica que se omite la comprobación de revocación de los certificados de servidor. Use este parámetro solo para equipos de confianza.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UICulture
Especifica la referencia cultural de la interfaz de usuario que se va a usar para la sesión CIM. Especifique el valor de este parámetro mediante uno de los siguientes formatos:
- Nombre de referencia cultural en
<languagecode2>-<country/regioncode2>formato como "EN-US". - Variable que contiene un objeto CultureInfo.
- Comando que obtiene un objeto CultureInfo, como
Get-Culture.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UseSsl
Indica que se debe usar SSL para establecer una conexión al equipo remoto. De forma predeterminada, no se usa SSL. WsMan cifra todo el contenido que se transmite a través de la red, incluso cuando se usa HTTP.
Este parámetro le permite especificar la protección adicional de HTTPS en lugar de HTTP. Si SSL no está disponible en el puerto usado para la conexión y especifica este parámetro, se produce un error en el comando.
Se recomienda usar este parámetro solo cuando no se especifica el parámetro PacketPrivacy .
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Entradas
None
No se pueden canalizar objetos a este cmdlet.
Salidas
Este cmdlet devuelve un objeto que contiene información de opciones de sesión CIM.
Notas
PowerShell incluye los siguientes alias para New-CimSessionOption:
- Windows:
ncso
Este cmdlet solo está disponible en plataformas Windows.
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de