Compartir a través de

Set-CMClientPushInstallation

  • Referencia
Módulo:
ConfigurationManager

Configure los valores para la instalación de inserción de cliente.

Sintaxis

Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   -InputObject <IResultObject>
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   [-RemoveAccount <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   -InputObject <IResultObject>
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   [-RemoveAccount <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   -Name <String>
   [-RemoveAccount <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientPushInstallation
   [-AddAccount <String[]>]
   [-AllownNTLMFallback <Boolean>]
   [-ChosenAccount <String[]>]
   [-ClearAccount]
   [-EnableAutomaticClientPushInstallation <Boolean>]
   [-EnableSystemTypeConfigurationManager <Boolean>]
   [-EnableSystemTypeServer <Boolean>]
   [-EnableSystemTypeWorkstation <Boolean>]
   [-InstallationProperty <String>]
   [-InstallClientToDomainController <Boolean>]
   [-RemoveAccount <String[]>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para cambiar la configuración del sitio para la instalación de inserción de cliente. El método de instalación de inserción de cliente instala el cliente de Configuration Manager en los equipos que detecta el sitio.

También puede iniciar una instalación de inserción de cliente ejecutando el Asistente para instalación de inserción de cliente para una colección o recurso específico dentro de una colección.

Para obtener más información, consulte Instalación de clientes en equipos basados en Windows en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Cambiar la configuración de una instalación de inserción de cliente

Este comando realiza las siguientes configuraciones:

  • Use automáticamente la inserción de cliente para los equipos detectados.
  • Inserción del cliente en servidores de sistema de sitio
  • El sitio usa la cuenta denominada contoso\svc_smspush para conectarse al equipo para instalar el software cliente.

El parámetro InstallationProperty establece el valor de la propiedad SMSSITECODE para el paquete de Windows Installer en CM1. Esta configuración asigna el cliente al sitio que tiene el código de sitio CM1.

Set-CMClientPushInstallation -SiteCode "CM1" -EnableAutomaticClientPushInstallation $True -EnableSystemTypeConfiguationManager $True -ChosenAccount "contoso\svc_smspush" -InstallationProperty "SMSSITECODE=CM1"

Parámetros

-AddAccount

Especifique una matriz de cadenas para una o varias cuentas que puedan instalar el cliente. Las cuentas deben ser un administrador local en el equipo de destino. Para cada cuenta, use el formato domain\username.

Para obtener más información, consulte Cuenta de instalación de inserción de cliente.

Tipo:String[]
Alias:AddAccounts
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllownNTLMFallback

Cuando se $true este parámetro, si el sitio no puede autenticar el cliente mediante Kerberos, vuelve a intentar la conexión mediante NTLM. La configuración recomendada para mejorar la seguridad es establecer este parámetro en $false, lo que requiere Kerberos sin reserva NTLM.

Nota:

Cuando usa la inserción de cliente para instalar el cliente de Configuration Manager, el servidor de sitio crea una conexión remota al cliente. El sitio puede requerir la autenticación mutua kerberos al no permitir la reserva a NTLM antes de establecer la conexión. Este comportamiento ayuda a proteger la comunicación entre el servidor y el cliente.

En función de las directivas de seguridad, es posible que el entorno ya prefiera o requiera Kerberos sobre la autenticación NTLM anterior. Para obtener más información sobre las consideraciones de seguridad de estos protocolos de autenticación, lea la configuración de directiva de seguridad de Windows para restringir NTLM.

Para usar esta característica, los clientes deben estar en un bosque de Active Directory de confianza. Kerberos en Windows se basa en Active Directory para la autenticación mutua.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ChosenAccount

Especifique una matriz de cadenas para una o varias cuentas ya agregadas a Configuration Manager.

Tipo:String[]
Alias:ChosenAccounts
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ClearAccount

Agregue este parámetro para quitar todas las cuentas que se especifican actualmente para la inserción de cliente en el sitio. Para quitar una sola cuenta, use el parámetro RemoveAccount .

Tipo:SwitchParameter
Alias:ClearAccounts
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableAutomaticClientPushInstallation

Establezca este parámetro en $true para instalar el cliente de Configuration Manager en los recursos del equipo recién detectados. También permite la instalación en recursos de equipo existentes que no tienen instalado el cliente.

Si establece este parámetro en $false, puede seguir usando la acción Instalar cliente en una colección o dispositivo.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableSystemTypeConfigurationManager

Establezca este parámetro en $true para instalar el cliente de Configuration Manager en los servidores del sistema de sitio.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableSystemTypeServer

Establezca este parámetro en $true para instalar el cliente de Configuration Manager en los servidores.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableSystemTypeWorkstation

Establezca este parámetro en $true para instalar el cliente de Configuration Manager en estaciones de trabajo.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifique un objeto de instalación de inserción de cliente. Para obtener este objeto, use el cmdlet Get-CMClientPushInstallation .

Tipo:IResultObject
Alias:ClientPushComponent
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InstallationProperty

Especifique las propiedades de instalación que se usarán al instalar el cliente de Configuration Manager.

Por ejemplo:

/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSSITECODE="XYZ" SMSMP=mp01.contoso.com

Para obtener más información, consulte Acerca de los parámetros y propiedades de instalación de cliente en Configuration Manager.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstallClientToDomainController

Establezca este parámetro para especificar si se va a instalar el cliente de Configuration Manager en controladores de dominio:

  • $true: instale siempre el cliente en los controladores de dominio.
  • $false: nunca instale el cliente en controladores de dominio, a menos que se especifique en el Asistente para instalación de inserción de cliente.
Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica un nombre para la instalación de inserción de cliente.

Tipo:String
Alias:SiteName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveAccount

Especifique una matriz de cadenas de cuentas de instalación de inserción de cliente que se van a quitar. Para quitar todas las cuentas, use el parámetro ClearAccount .

Tipo:String[]
Alias:RemoveAccounts
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SiteCode

Especifique el código de sitio de tres caracteres. Por ejemplo, XYZ.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject