Set-CMClientPushInstallation

SYNOPSIS

Configurar as definições para a instalação de push do cliente.

SYNTAX

SearchByValueMandatory (Padrão)

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

SearchByComponentValueMandatory

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

PesquisaByNameMandatory

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

SearchBySiteCodeMandatory

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

Utilize este cmdlet para alterar a configuração do site para a instalação de push do cliente. O método de instalação push do cliente instala o cliente Gestor de Configuração em computadores que o site descobre.

Também pode iniciar uma instalação de push do cliente executando o Assistente de Instalação de Impulso do Cliente para uma coleção ou recurso específico dentro de uma coleção.

Para obter mais informações, consulte Como instalar clientes em computadores baseados em Windows no Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Alterar as definições de uma instalação push do cliente

Este comando faz as seguintes configurações:

  • Utilize automaticamente o impulso do cliente para computadores descobertos.
  • Empurre o cliente para servidores do sistema de site
  • O site utiliza a conta chamada contoso\svc_smspush ligar-se ao computador para instalar o software do cliente.

O parâmetro instalaçãoProperty define o valor da propriedade SMSSITECODE para o pacote Windows Instalador para CM1. Esta definição atribui o cliente ao site que tem o código do site CM1.

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

PARAMETERS

-Adicionar Contagem

Especifique um conjunto de cordas para uma ou mais contas que possam instalar o cliente. As contas têm de ser um administrador local no computador de destino. Para cada conta, utilize o formato domain\username .

Para obter mais informações, consulte a conta de instalação push cliente.

Type: String[]
Parameter Sets: (All)
Aliases: AddAccounts

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllownNTLMFallback

Quando este parâmetro é $true, se o site não conseguir autenticar o cliente utilizando Kerberos, ele retriu a ligação utilizando a NTLM. A configuração recomendada para uma melhor segurança é definir este parâmetro para $false, que requer Kerberos sem recuo NTLM.

Nota

Quando utiliza o impulso do cliente para instalar o cliente Gestor de Configuração, o servidor do site cria uma ligação remota ao cliente. O site pode exigir a autenticação mútua de Kerberos, não permitindo o retorno à NTLM antes de estabelecer a ligação. Este comportamento ajuda a garantir a comunicação entre o servidor e o cliente.

Dependendo das suas políticas de segurança, o seu ambiente pode já preferir ou exigir Kerberos em vez da autenticação NTLM mais antiga. Para obter mais informações sobre as considerações de segurança destes protocolos de autenticação, leia sobre a definição de política de segurança Windows para restringir a NTLM.

Para utilizar esta funcionalidade, os clientes devem estar numa floresta de diretório ativo de confiança. Kerberos em Windows conta com o Ative Directory para a autenticação mútua.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Contagem escolhida

Especifique um conjunto de cordas para uma ou mais contas já adicionadas ao Gestor de Configuração.

Type: String[]
Parameter Sets: (All)
Aliases: ChosenAccounts

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClearAccount

Adicione este parâmetro para remover todas as contas que estão atualmente especificadas para a pressão do cliente no site. Para remover uma única conta, utilize o parâmetro RemoveAccount.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearAccounts

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableAutomaticClientPushInstallation

Desa esta definição deste parâmetro para $true instalar o cliente Gestor de Configuração em recursos informáticos recém-descobertos. Também permite a instalação de recursos informáticos existentes que não tenham o cliente instalado.

Se definir este parâmetro para $false, ainda pode utilizar a ação do cliente Instalar numa coleção ou dispositivo.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableSystemTypeConfigurationManager

Desa esta definição deste parâmetro para $true instalar o cliente Do Gestor de Configuração nos servidores do sistema de site.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableSystemTypeServer

Desa esta definição deste parâmetro para $true instalar o cliente Gestor de Configuração nos servidores.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableSystemTypeWorkstation

Desa esta definição deste parâmetro para $true instalar o cliente Gestor de Configuração em estações de trabalho.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Especifique um objeto de instalação de impulso do cliente. Para obter este objeto, utilize o cmdlet de instalação Get-CMClientPushInstall.

Type: IResultObject
Parameter Sets: SearchByValueMandatory, SearchByComponentValueMandatory
Aliases: ClientPushComponent

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Instalar o Controlador DeDomínio de IentSe

Desa esta definição deste parâmetro para especificar se deve instalar o cliente Gestor de Configuração nos controladores de domínio:

  • $true: Instale sempre o cliente nos controladores de domínio.
  • $false: Nunca instale o cliente em controladores de domínio, a não ser que esteja especificado no Assistente de Instalação de Impulso do Cliente.
Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InstalaçãoProperitação

Especifique quaisquer propriedades de instalação a utilizar ao instalar o cliente Gestor de Configuração.

Por exemplo:

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

Para obter mais informações, consulte sobre os parâmetros e propriedades de instalação do cliente no Gestor de Configuração.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Especifica um nome para a instalação de push do cliente.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: SiteName

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Remover Contas

Especifique um conjunto de cadeias de contas de instalação de impulso do cliente para remover. Para remover todas as contas, utilize o parâmetro ClearAccount.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveAccounts

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- SiteCode

Especifique o código do site de três caracteres. Por exemplo, XYZ.

Type: String
Parameter Sets: SearchBySiteCodeMandatory
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

NOTAS

Instalação Get-CMClientPushInstall

Como instalar clientes em computadores baseados em Windows no Gestor de Configuração