Partager via

Set-CMClientPushInstallation

  • Référence
Module:
ConfigurationManager

Configurez les paramètres pour l’installation push du client.

Syntaxe

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

Utilisez cette applet de commande pour modifier la configuration du site pour l’installation push du client. La méthode d’installation push du client installe le client Configuration Manager sur les ordinateurs découverts par le site.

Vous pouvez également démarrer une installation push du client en exécutant l’Assistant Installation push du client pour un regroupement ou une ressource spécifique au sein d’un regroupement.

Pour plus d’informations, consultez Guide pratique pour installer des clients sur des ordinateurs Windows dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Modifier les paramètres d’une installation push du client

Cette commande effectue les configurations suivantes :

  • Utilisez automatiquement l’envoi (push) du client pour les ordinateurs découverts.
  • Envoyer (push) le client aux serveurs de système de site
  • Le site utilise le compte nommé contoso\svc_smspush pour se connecter à l’ordinateur et installer le logiciel client.

Le paramètre InstallationProperty définit la valeur cm1 de la propriété SMSSITECODE pour le package Windows Installer. Ce paramètre affecte le client au site qui a le code de site CM1.

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

Paramètres

-AddAccount

Spécifiez un tableau de chaînes pour un ou plusieurs comptes pouvant installer le client. Les comptes doivent être un administrateur local sur l’ordinateur de destination. Pour chaque compte, utilisez le format domain\username.

Pour plus d’informations, consultez Compte d’installation push du client.

Type:String[]
Alias:AddAccounts
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllownNTLMFallback

Lorsque ce paramètre est $true, si le site ne peut pas authentifier le client à l’aide de Kerberos, il tente de nouveau la connexion à l’aide de NTLM. La configuration recommandée pour améliorer la sécurité consiste à définir ce paramètre sur $false, ce qui nécessite Kerberos sans secours NTLM.

Remarque

Lorsqu’il utilise l’envoi (push) du client pour installer le client Configuration Manager, le serveur de site crée une connexion à distance au client. Le site peut exiger une authentification mutuelle Kerberos en n’autorisant pas le secours à NTLM avant d’établir la connexion. Ce comportement permet de sécuriser la communication entre le serveur et le client.

Selon vos stratégies de sécurité, votre environnement peut déjà préférer ou exiger Kerberos par rapport à l’ancienne authentification NTLM. Pour plus d’informations sur les considérations de sécurité de ces protocoles d’authentification, consultez le paramètre de stratégie de sécurité Windows pour restreindre NTLM.

Pour utiliser cette fonctionnalité, les clients doivent se trouver dans une forêt Active Directory approuvée. Kerberos dans Windows s’appuie sur Active Directory pour l’authentification mutuelle.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ChosenAccount

Spécifiez un tableau de chaînes pour un ou plusieurs comptes déjà ajoutés à Configuration Manager.

Type:String[]
Alias:ChosenAccounts
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClearAccount

Ajoutez ce paramètre pour supprimer tous les comptes actuellement spécifiés pour l’envoi (push) du client sur le site. Pour supprimer un seul compte, utilisez le paramètre RemoveAccount .

Type:SwitchParameter
Alias:ClearAccounts
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableAutomaticClientPushInstallation

Définissez ce paramètre sur $true pour installer le client Configuration Manager sur les ressources d’ordinateur nouvellement découvertes. Il permet également l’installation sur les ressources d’ordinateur existantes qui n’ont pas le client installé.

Si vous définissez ce paramètre sur $false, vous pouvez toujours utiliser l’action Installer le client sur un regroupement ou un appareil.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableSystemTypeConfigurationManager

Définissez ce paramètre sur $true pour installer le client Configuration Manager sur les serveurs de système de site.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableSystemTypeServer

Définissez ce paramètre sur $true pour installer le client Configuration Manager sur les serveurs.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableSystemTypeWorkstation

Définissez ce paramètre sur $true pour installer le client Configuration Manager sur les stations de travail.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet d’installation push du client. Pour obtenir cet objet, utilisez l’applet de commande Get-CMClientPushInstallation .

Type:IResultObject
Alias:ClientPushComponent
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InstallationProperty

Spécifiez les propriétés d’installation à utiliser lors de l’installation du client Configuration Manager.

Par exemple :

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

Pour plus d’informations, consultez À propos des paramètres et des propriétés d’installation du client dans Configuration Manager.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InstallClientToDomainController

Définissez ce paramètre pour spécifier s’il faut installer le client Configuration Manager sur les contrôleurs de domaine :

  • $true : installez toujours le client sur les contrôleurs de domaine.
  • $false : n’installez jamais le client sur les contrôleurs de domaine, sauf si cela est spécifié dans l’Assistant Installation push du client.
Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un nom pour l’installation push du client.

Type:String
Alias:SiteName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveAccount

Spécifiez un tableau de chaînes de comptes d’installation push du client à supprimer. Pour supprimer tous les comptes, utilisez le paramètre ClearAccount .

Type:String[]
Alias:RemoveAccounts
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SiteCode

Spécifiez le code de site à trois caractères. Par exemple : XYZ.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject