Freigeben über


Set-CMClientPushInstallation

Konfigurieren Sie Einstellungen für die Clientpushinstallation.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um die Standortkonfiguration für die Clientpushinstallation zu ändern. Die Clientpushinstallationsmethode installiert den Configuration Manager-Client auf Computern, die vom Standort ermittelt werden.

Sie können eine Clientpushinstallation auch starten, indem Sie den Clientpushinstallations-Assistenten für eine bestimmte Sammlung oder Ressource in einer Sammlung ausführen.

Weitere Informationen finden Sie unter Installieren von Clients auf Windows-basierten Computern in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Ändern der Einstellungen einer Clientpushinstallation

Dieser Befehl nimmt die folgenden Konfigurationen vor:

  • Automatisches Verwenden von Clientpush für ermittelte Computer.
  • Pushen des Clients an Standortsystemserver
  • Der Standort verwendet das Konto contoso\svc_smspush , um eine Verbindung mit dem Computer herzustellen, um die Clientsoftware zu installieren.

Der Parameter InstallationProperty legt den Wert der SMSSITECODE-Eigenschaft für das Windows Installer-Paket auf CM1 fest. Diese Einstellung weist den Client dem Standort zu, der über den Standortcode CM1 verfügt.

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

Parameter

-AddAccount

Geben Sie ein Zeichenfolgenarray für ein oder mehrere Konten an, die den Client installieren können. Die Konten müssen ein lokaler Administrator auf dem Zielcomputer sein. Verwenden Sie für jedes Konto das Format domain\username.

Weitere Informationen finden Sie unter Clientpushinstallationskonto.

Typ:String[]
Aliase:AddAccounts
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllownNTLMFallback

Wenn dieser Parameter $true ist und der Standort den Client nicht mithilfe von Kerberos authentifizieren kann, wird die Verbindung mithilfe von NTLM wiederholt. Die empfohlene Konfiguration für eine verbesserte Sicherheit besteht darin, diesen Parameter auf $false festzulegen, was Kerberos ohne NTLM-Fallback erfordert.

Hinweis

Wenn der Configuration Manager-Client mithilfe von Clientpush installiert wird, erstellt der Standortserver eine Remoteverbindung mit dem Client. Der Standort kann die gegenseitige Kerberos-Authentifizierung erfordern, indem vor dem Herstellen der Verbindung kein Fallback auf NTLM zugelassen wird. Dieses Verhalten trägt dazu bei, die Kommunikation zwischen dem Server und dem Client zu schützen.

Abhängig von Ihren Sicherheitsrichtlinien kann Ihre Umgebung Kerberos der älteren NTLM-Authentifizierung vorziehen oder erfordern. Weitere Informationen zu den Sicherheitsüberlegungen dieser Authentifizierungsprotokolle finden Sie unter Windows-Sicherheitsrichtlinieneinstellung zum Einschränken von NTLM.

Um dieses Feature verwenden zu können, müssen sich Clients in einer vertrauenswürdigen Active Directory-Gesamtstruktur befinden. Kerberos in Windows basiert auf Active Directory für die gegenseitige Authentifizierung.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ChosenAccount

Geben Sie ein Zeichenfolgenarray für ein oder mehrere Konten an, die bereits Configuration Manager hinzugefügt wurden.

Typ:String[]
Aliase:ChosenAccounts
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClearAccount

Fügen Sie diesen Parameter hinzu, um alle Konten zu entfernen, die derzeit für Clientpush am Standort angegeben sind. Um ein einzelnes Konto zu entfernen, verwenden Sie den RemoveAccount-Parameter .

Typ:SwitchParameter
Aliase:ClearAccounts
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAutomaticClientPushInstallation

Legen Sie diesen Parameter auf $true fest, um den Configuration Manager-Client auf neu ermittelten Computerressourcen zu installieren. Es ermöglicht auch die Installation auf vorhandenen Computerressourcen, auf denen der Client nicht installiert ist.

Wenn Sie diesen Parameter auf $false festlegen, können Sie weiterhin die Aktion Client installieren für eine Sammlung oder ein Gerät verwenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableSystemTypeConfigurationManager

Legen Sie diesen Parameter auf $true fest, um den Configuration Manager-Client auf Standortsystemservern zu installieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableSystemTypeServer

Legen Sie diesen Parameter auf $true fest, um den Configuration Manager-Client auf Servern zu installieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableSystemTypeWorkstation

Legen Sie diesen Parameter auf $true fest, um den Configuration Manager-Client auf Arbeitsstationen zu installieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein Clientpushinstallationsobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMClientPushInstallation .

Typ:IResultObject
Aliase:ClientPushComponent
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InstallationProperty

Geben Sie alle Installationseigenschaften an, die bei der Installation des Configuration Manager-Clients verwendet werden sollen.

Zum Beispiel:

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

Weitere Informationen finden Sie unter Informationen zu Clientinstallationsparametern und -eigenschaften in Configuration Manager.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstallClientToDomainController

Legen Sie diesen Parameter fest, um anzugeben, ob der Configuration Manager-Client auf Domänencontrollern installiert werden soll:

  • $true: Installieren Sie den Client immer auf Domänencontrollern.
  • $false: Installieren Sie den Client niemals auf Domänencontrollern, es sei denn, dies ist im Clientpushinstallations-Assistenten angegeben.
Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für die Clientpushinstallation an.

Typ:String
Aliase:SiteName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveAccount

Geben Sie ein Zeichenfolgenarray der zu entfernenden Clientpushinstallationskonten an. Um alle Konten zu entfernen, verwenden Sie den ClearAccount-Parameter .

Typ:String[]
Aliase:RemoveAccounts
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SiteCode

Geben Sie den aus drei Zeichen bestehenden Standortcode an. Beispiel: XYZ.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject