Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Konfigurations-Manager (Current Branch)
Verwenden Sie den Befehl CCMSetup.exe, um den Konfigurations-Manager Client zu installieren. Wenn Sie Clientinstallationsparameter in der Befehlszeile angeben, ändern sie das Installationsverhalten. Wenn Sie Clientinstallationseigenschaften in der Befehlszeile angeben, ändern diese die anfängliche Konfiguration des installierten Client-Agents.
Über CCMSetup.exe
Der Befehl CCMSetup.exe lädt die erforderlichen Dateien herunter, um den Client von einem Verwaltungspunkt oder einem Quellspeicherort zu installieren. Diese Dateien können Folgendes enthalten:
Das Windows Installer-Paket client.msi, mit dem die Clientsoftware installiert wird
Voraussetzungen für Clients
Updates und Patches für den Konfigurations-Manager-Client
Hinweis
Sie können client.msi nicht direkt installieren.
CCMSetup.exe stellt Befehlszeilenparameter zum Anpassen der Installation bereit. Parametern wird ein Schrägstrich (/) vorangestellt und sie sind in der Regel klein geschrieben. Sie geben den Wert eines Parameters bei Bedarf mit einem Doppelpunkt (:) unmittelbar gefolgt vom Wert an. Weitere Informationen finden Sie unter CCMSetup.exe Befehlszeilenparametern.
Sie können Eigenschaften auch über die CCMSetup.exe Befehlszeile angeben, um das Verhalten client.msi zu ändern. Eigenschaften werden konventionell in Großbuchstaben geschrieben. Sie geben einen Wert für eine Eigenschaft mit einem Gleichheitszeichen (=) unmittelbar gefolgt von dem Wert an. Weitere Informationen finden Sie unter Client.msi Eigenschaften.
Wichtig
Geben Sie CCMSetup-Parameter an, bevor Sie Eigenschaften für client.msi angeben.
CCMSetup.exe und die unterstützenden Dateien befinden sich auf dem Standortserver im Ordner Client des Installationsordners Konfigurations-Manager. Der Konfigurations-Manager gibt diesen Ordner für das Netzwerk unter der Standortfreigabe frei. Beispiel: \\SiteServer\SMS_ABC\Client.
An der Eingabeaufforderung verwendet der Befehl CCMSetup.exe das folgende Format:
CCMSetup.exe [<Ccmsetup parameters>] [<client.msi setup properties>]
Zum Beispiel:
CCMSetup.exe /mp:SMSMP01 /logon SMSSITECODE=S01 FSP=SMSFSP01
In diesem Beispiel werden folgende Aktionen ausgeführt:
Gibt den Verwaltungspunkt mit dem Namen SMSMP01 an, um eine Liste von Verteilungspunkten zum Herunterladen der Clientinstallationsdateien anzufordern.
Gibt an, dass die Installation beendet werden soll, wenn eine Version des Clients bereits auf dem Computer vorhanden ist.
Weist client.msi an, den Client dem Standortcode S01 zuzuweisen.
Weist client.msi an, den Fallback status Punkt mit dem Namen SMSFP01 zu verwenden.
Tipp
Wenn ein Parameterwert Leerzeichen enthält, schließen Sie ihn in Anführungszeichen ein.
Wenn Sie das Active Directory-Schema für Konfigurations-Manager erweitern, veröffentlicht der Standort viele Clientinstallationseigenschaften in Active Directory Domain Services. Der Konfigurations-Manager Client liest diese Eigenschaften automatisch. Weitere Informationen finden Sie unter Informationen zu Clientinstallationseigenschaften, die in Active Directory Domain Services veröffentlicht wurden
CCMSetup.exe Befehlszeilenparametern
/?
Zeigt die verfügbaren Befehlszeilenparameter für ccmsetup.exe an.
Beispiel: ccmsetup.exe /?
/AllowMetered
Verwenden Sie diesen Parameter, um das Verhalten des Clients in einem getakteten Netzwerk zu steuern. Dieser Parameter akzeptiert keine Werte. Wenn Sie die Clientkommunikation in einem getakteten Netzwerk für ccmsetup zulassen, wird der Inhalt heruntergeladen, bei der Website registriert und die ursprüngliche Richtlinie heruntergeladen. Jede weitere Clientkommunikation folgt der Konfiguration der Clienteinstellung aus dieser Richtlinie. Weitere Informationen finden Sie unter Informationen zu Clienteinstellungen.
Wenn Sie den Client auf einem vorhandenen Gerät neu installieren, wird die folgende Priorität zur Ermittlung der Konfiguration verwendet:
- Vorhandene lokale Clientrichtlinie
- Die letzte in der Windows-Registrierung gespeicherte Befehlszeile
- Parameter in der ccmsetup-Befehlszeile
/AlwaysExcludeUpgrade
Dieser Parameter gibt an, ob ein Client automatisch aktualisiert wird, wenn Sie das automatische Clientupgrade aktivieren.
Unterstützte Werte:
-
TRUE: Der Client wird nicht automatisch aktualisiert -
FALSE: Der Client aktualisiert automatisch (Standard)
Zum Beispiel:
CCMSetup.exe /AlwaysExcludeUpgrade:TRUE
Weitere Informationen finden Sie unter Erweiterte Interoperabilität des Clients.
Hinweis
Wenn der /AlwaysExcludeUpgrade Parameter verwendet wird, wird das automatische Upgrade weiterhin ausgeführt. Wenn CCMSetup jedoch ausgeführt wird, um das Upgrade durchzuführen, wird festgestellt, dass /AlwaysExcludeUpgrade der Parameter festgelegt wurde, und die folgende Zeile im ccmsetup.log protokolliert:
Client is stamped with /alwaysexcludeupgrade. Stop proceeding.
CCMSetup wird dann sofort beendet und das Upgrade nicht ausgeführt.
/BITSPriority
Wenn das Gerät Clientinstallationsdateien über eine HTTP-Verbindung herunterlädt, verwenden Sie diesen Parameter, um die Downloadpriorität anzugeben. Geben Sie einen der folgenden möglichen Werte an:
FOREGROUNDHIGHNORMAL(Standard)LOW
Beispiel: ccmsetup.exe /BITSPriority:HIGH
/config
Dieser Parameter gibt eine Textdatei an, in der die Eigenschaften der Clientinstallation aufgeführt sind.
Wenn CCMSetup als Dienst ausgeführt wird, legen Sie diese Datei im Systemordner CCMSetup ab:
%Windir%\Ccmsetup.Wenn Sie den
/noserviceParameter angeben, legen Sie diese Datei in demselben Ordner wie CCMSetup.exe ab.
Beispiel: CCMSetup.exe /config:"configuration file name.txt"
Verwenden Sie zum Bereitstellen des richtigen Dateiformats die Datei mobileclienttemplate.tcf im \bin\<platform> Ordner im Installationsverzeichnis von Konfigurations-Manager auf dem Standortserver. Diese Datei enthält Kommentare zu den Abschnitten und deren Verwendung. Geben Sie die Eigenschaften der Clientinstallation in dem [Client Install] Abschnitt nach dem folgenden Text an: Install=INSTALL=ALL.
Beispiel [Client Install] für einen Abschnittseintrag: Install=INSTALL=ALL SMSSITECODE=ABC SMSCACHESIZE=100
/downloadtimeout
Wenn CCMSetup die Clientinstallationsdateien nicht herunterladen kann, gibt dieser Parameter die maximale Zeitüberschreitung in Minuten an. Nach dieser Zeitüberschreitung versucht CCMSetup nicht mehr, die Installationsdateien herunterzuladen. Der Standardwert ist 1440 Minuten (ein Tag).
Verwenden Sie den /retry Parameter, um das Intervall zwischen Wiederholungsversuchen anzugeben.
Beispiel: ccmsetup.exe /downloadtimeout:100
/ExcludeFeatures
Dieser Parameter gibt an, dass CCMSetup.exe das angegebene Feature nicht installiert.
Beispiel: CCMSetup.exe /ExcludeFeatures:ClientUI Installiert Software Center nicht auf dem Client.
Hinweis
ClientUI ist der einzige Wert, den der /ExcludeFeatures Parameter unterstützt.
/forceinstall
Geben Sie an, dass CCMSetup.exe alle vorhandenen Clients deinstalliert und einen neuen Client installiert.
/forcereboot
Verwenden Sie diesen Parameter, um ggf. einen Neustart des Computers zu erzwingen, um die Installation abzuschließen. Wenn Sie diesen Parameter nicht angeben, wird CCMSetup beendet, wenn ein Neustart erforderlich ist. Nach dem nächsten manuellen Neustart wird es dann fortgesetzt.
Beispiel: CCMSetup.exe /forcereboot
/logon
Wenn eine Version des Clients bereits installiert ist, gibt dieser Parameter an, dass die Clientinstallation beendet werden soll.
Beispiel: ccmsetup.exe /logon
/mp
Gibt einen Verwaltungspunkt an, den Clients zum Suchen des nächstgelegenen Verteilungspunkts für die Clientinstallationsdateien verwenden sollen. Wenn es keine Verteilungspunkte gibt oder Computer die Dateien nach vier Stunden nicht von den Verteilungspunkten herunterladen können, laden sie die Dateien vom angegebenen Verwaltungspunkt herunter.
Weitere Informationen dazu, wie ccmsetup Inhalte herunterlädt, finden Sie unter Begrenzungsgruppen – Clientinstallation. Dieser Artikel enthält auch Details zum ccmsetup-Verhalten, wenn Sie sowohl als auch /mp/source die Parameter verwenden.
Wichtig
Dieser Parameter gibt einen anfänglichen Verwaltungspunkt an, über den Computer eine Downloadquelle suchen können. Dabei kann es sich um einen beliebigen Verwaltungspunkt an einem beliebigen Standort handeln. Der Client wird nicht dem angegebenen Verwaltungspunkt zugewiesen .
Computer laden die Dateien über eine HTTP- oder HTTPS-Verbindung herunter, je nach der Konfiguration der Standort-Systemrolle für Clientverbindungen. Der Download kann auch die BITS-Drosselung verwenden, wenn Sie ihn konfigurieren. Wenn Sie alle Verteilungspunkte und Verwaltungspunkte nur für HTTPS-Clientverbindungen konfigurieren, stellen Sie sicher, dass der Clientcomputer über ein gültiges Clientzertifikat verfügt.
Sie können den /mp Befehlszeilenparameter verwenden, um mehrere Verwaltungspunkte anzugeben. Wenn der Computer keine Verbindung mit dem ersten herstellen kann, versucht er den nächsten in der angegebenen Liste. Wenn Sie mehrere Verwaltungspunkte angeben, trennen Sie die Werte durch Semikolons.
Wenn der Client über HTTPS eine Verbindung mit einem Verwaltungspunkt herstellt, geben Sie den FQDN und nicht den Computernamen an. Der Wert muss mit dem Antragsteller oder dem alternativen Antragstellernamen des Verwaltungspunkt-PKI-Zertifikats übereinstimmen. Obwohl Konfigurations-Manager die Verwendung eines Computernamens im Zertifikat für Verbindungen im Intranet unterstützt, wird die Verwendung eines FQDN empfohlen.
Beispiel mit dem Computernamen: ccmsetup.exe /mp:SMSMP01
Beispiel mit dem FQDN: ccmsetup.exe /mp:smsmp01.contoso.com
Dieser Parameter kann auch die URL eines Cloudverwaltungsgateways (Cloud Management Gateway, CMG) angeben. Verwenden Sie diese URL, um den Client auf einem internetbasierten Gerät zu installieren. Führen Sie die folgenden Schritte aus, um den Wert für diesen Parameter abzurufen:
Erstellen einer CMG. Weitere Informationen finden Sie unter Einrichten einer CMG.
Öffnen Sie auf einem aktiven Client eine Windows PowerShell-Eingabeaufforderung als Administrator.
Führen Sie den folgenden Befehl aus:
(Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MPFügen Sie das Präfix an, das
https://mit dem/mpParameter verwendet werden soll.
Beispiel für die Verwendung der URL des Cloudverwaltungsgateways: ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100
Wichtig
Wenn Sie die URL eines Cloudverwaltungsgateways für den /mp Parameter angeben, muss sie mit https://beginnen.
Hinweis
Der Befehlszeilenparameter /mp gibt den Verwaltungspunkt, der vom Konfigurations-Manager-Client nach der Installation verwendet wird, nicht an. Verwenden Sie die SMSMP-Eigenschaft client.msi, um den anfänglichen Verwaltungspunkt anzugeben, der vom Konfigurations-Manager Client nach der Installation verwendet wird. Um eine Liste der Verwaltungspunkte anzugeben, die der Konfigurations-Manager-Client nach der Installation verwenden soll, verwenden Sie die SMSMPLIST-Eigenschaft client.msi.
/NoCRLCheck
Gibt an, dass ein Client die Zertifikatsperrliste (Certificate Revocation List, CRL) nicht überprüfen sollte, wenn er über HTTPS mit einem PKI-Zertifikat kommuniziert. Wenn Sie diesen Parameter nicht angeben, überprüft der Client die CRL, bevor er eine HTTPS-Verbindung herstellt. Weitere Informationen zur Client-CRL-Überprüfung finden Sie unter Planen der Sperrung von PKI-Zertifikaten.
Beispiel: CCMSetup.exe /UsePKICert /NoCRLCheck
/noservice
Dieser Parameter verhindert, dass CCMSetup als Dienst ausgeführt wird, was standardmäßig der Fall ist. Wenn CCMSetup als Dienst ausgeführt wird, wird es im Kontext des lokalen Systemkontos des Computers ausgeführt. Dieses Konto verfügt möglicherweise nicht über ausreichende Rechte, um auf die für die Installation erforderlichen Netzwerkressourcen zuzugreifen. Mit /noservicewird CCMSetup.exe im Kontext des Benutzerkontos ausgeführt, das Sie zum Starten der Installation verwenden.
Beispiel: ccmsetup.exe /noservice
/regtoken
Verwenden Sie diesen Parameter, um ein Massenregistrierungstoken bereitzustellen. Ein internetbasiertes Gerät verwendet dieses Token im Registrierungsprozess über ein Cloudverwaltungsgateway (Cloud Management Gateway, CMG). Weitere Informationen finden Sie unter Tokenbasierte Authentifizierung für CMG.
Wenn Sie diesen Parameter verwenden, schließen Sie auch die folgenden Parameter und Eigenschaften ein:
Die folgende Beispielbefehlszeile enthält die anderen erforderlichen Setupparameter und Eigenschaften:
ccmsetup.exe /mp:https://CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72186325152220500 SMSSITECODE=ABC SMSMP=https://mp1.contoso.com /regtoken:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Ik9Tbzh2Tmd5VldRUjlDYVh5T2lacHFlMDlXNCJ9.eyJTQ0NNVG9rZW5DYXRlZ29yeSI6IlN7Q01QcmVBdXRoVG9rZW4iLCJBdXRob3JpdHkiOiJTQ0NNIiwiTGljZW5zZSI6IlNDQ00iLCJUeXBlIjoiQnVsa1JlZ2lzdHJhdGlvbiIsIlRlbmFudElkIjoiQ0RDQzVFOTEtMEFERi00QTI0LTgyRDAtMTk2NjY3RjFDMDgxIiwiVW5pcXVlSWQiOiJkYjU5MWUzMy1wNmZkLTRjNWItODJmMy1iZjY3M2U1YmQwYTIiLCJpc3MiOiJ1cm46c2NjbTpvYXV0aDI6Y2RjYzVlOTEtMGFkZi00YTI0LTgyZDAtMTk2NjY3ZjFjMDgxIiwiYXVkIjoidXJuOnNjY206c2VydmljZSIsImV4cCI6MTU4MDQxNbUwNSwibmJmIjoxNTgwMTU2MzA1fQ.ZUJkxCX6lxHUZhMH_WhYXFm_tbXenEdpgnbIqI1h8hYIJw7xDk3wv625SCfNfsqxhAwRwJByfkXdVGgIpAcFshzArXUVPPvmiUGaxlbB83etUTQjrLIk-gvQQZiE5NSgJ63LCp5KtqFCZe8vlZxnOloErFIrebjFikxqAgwOO4i5ukJdl3KQ07YPRhwpuXmwxRf1vsiawXBvTMhy40SOeZ3mAyCRypQpQNa7NM3adCBwUtYKwHqiX3r1jQU0y57LvU_brBfLUL6JUpk3ri-LSpwPFarRXzZPJUu4-mQFIgrMmKCYbFk3AaEvvrJienfWSvFYLpIYA7lg-6EVYRcCAA
Tipp
Wenn CCMSetup den Fehler 0x87d0027e zurückgibt, versuchen Sie, den /mp Parameter aus der Befehlszeile zu entfernen.
/retry
Wenn CCMSetup.exe Installationsdateien nicht herunterladen können, verwenden Sie diesen Parameter, um das Wiederholungsintervall in Minuten anzugeben. CCMSetup versucht es so lange erneut, bis die im /downloadtimeout Parameter angegebene Grenze erreicht ist.
Beispiel: ccmsetup.exe /retry:20
/service
Gibt an, dass CCMSetup als Dienst ausgeführt werden soll, der das lokale Systemkonto verwendet.
Tipp
Wenn Sie ein Skript verwenden, um CCMSetup.exe mit dem /service Parameter auszuführen, wird CCMSetup.exe nach dem Starten des Diensts beendet. Möglicherweise werden Installationsdetails nicht ordnungsgemäß an das Skript gemeldet.
Beispiel: ccmsetup.exe /service
/skipprereq
Dieser Parameter gibt an, dass CCMSetup.exe die angegebene Voraussetzung nicht installiert. Sie können mehr als einen Wert eingeben. Trennen Sie die einzelnen Werte durch ein Semikolon (;).
Beispiele:
CCMSetup.exe /skipprereq:filename.exeCCMSetup.exe /skipprereq:filename1.exe;filename2.exe
Weitere Informationen zu den Clientvoraussetzungen finden Sie unter Voraussetzungen für Windows-Clients.
/source
Gibt den Speicherort für den Dateidownload an. Verwenden Sie einen lokalen oder UNC-Pfad. Das Gerät lädt Dateien über das SMB-Protokoll (Server Message Block) herunter. Um zu verwenden /source, benötigt das Windows-Benutzerkonto für die Clientinstallation Leseberechtigungen für den Speicherort.
Weitere Informationen dazu, wie ccmsetup Inhalte herunterlädt, finden Sie unter Begrenzungsgruppen – Clientinstallation. Dieser Artikel enthält auch Details zum ccmsetup-Verhalten, wenn Sie sowohl als auch /mp/source die Parameter verwenden.
Tipp
Sie können den /source Parameter mehrmals in einer Befehlszeile verwenden, um alternative Downloadspeicherorte anzugeben.
Beispiel: ccmsetup.exe /source:"\\server\share"
/uninstall
Verwenden Sie diesen Parameter, um den Konfigurations-Manager-Client zu deinstallieren. Weitere Informationen finden Sie unter Deinstallieren des Clients.
Beispiel: ccmsetup.exe /uninstall
Hinweis
Ab Version 2111 wird beim Deinstallieren des Clients auch der Client-Bootstrap entfernt, ccmsetup.msi, sofern vorhanden.
/UsePKICert
Geben Sie diesen Parameter für den Client an, um ein PKI-Clientauthentifizierungszertifikat zu verwenden. Wenn Sie diesen Parameter nicht einschließen oder wenn der Client kein gültiges Zertifikat finden kann, filtert er alle HTTPS-Verwaltungspunkte heraus, einschließlich Cloud-Verwaltungsgateways (CMG). Der Client verwendet eine HTTP-Verbindung mit einem selbstsignierten Zertifikat.
Beispiel: CCMSetup.exe /UsePKICert
Wenn ein Gerät Microsoft Entra ID für die Clientauthentifizierung verwendet und außerdem über ein PKI-basiertes Clientauthentifizierungszertifikat verfügt, kann der Client keine Microsoft Entra-Onboardinginformationen von einem Cloud Management Gateway (CMG) abrufen, wenn Sie diesen Parameter einschließen. Geben Sie für einen Client, der die Microsoft Entra-Authentifizierung verwendet, diesen Parameter nicht an, sondern schließen Sie die Eigenschaften AADRESOURCEURI und AADCLIENTAPPID ein.
Hinweis
In einigen Szenarien müssen Sie diesen Parameter nicht angeben, aber dennoch ein Clientzertifikat verwenden. Beispiel: Clientpush und Softwareupdate-basierte Clientinstallation. Verwenden Sie diesen Parameter, wenn Sie einen Client manuell installieren und den /mp Parameter mit einem HTTPS-fähigen Verwaltungspunkt verwenden.
Geben Sie diesen Parameter auch an, wenn Sie einen Client für die reine Internetkommunikation installieren. Wird zusammen mit den Eigenschaften für den internetbasierten Verwaltungspunkt (CCMHOSTNAME) und den Standortcode (SMSSITECODE) verwendetCCMALWAYSINF=1. Weitere Informationen zur internetbasierten Clientverwaltung finden Sie unter Überlegungen zur Clientkommunikation über das Internet oder eine nicht vertrauenswürdige Gesamtstruktur.
/IgnoreSkipUpgrade
Geben Sie diesen Parameter an, um einen ausgeschlossenen Client manuell zu aktualisieren. Weitere Informationen finden Sie unter Ausschließen von Clients vom Upgrade.
CCMSetup.exe Rückgabecodes
Der Befehl CCMSetup.exe stellt die folgenden Rückgabecodes bereit. Überprüfen Sie %WinDir%\ccmsetup\Logs\ccmsetup.log zur Problembehandlung den Client, um den Kontext und zusätzliche Details zu Rückgabecodes zu erhalten.
| Rückgabecode | Bedeutung |
|---|---|
| 0 | Erfolgreich |
| 6 | Fehler |
| 7 | Neustart erforderlich |
| 8 | Setup wird bereits ausgeführt |
| 9 | Auswertung der vorausgesetzten Voraussetzungen fehlgeschlagen |
| 10 | Fehler bei der Hashvalidierung des Setupmanifests |
Ccmsetup.msi Eigenschaften
Die folgenden Eigenschaften können das Installationsverhalten von ccmsetup.msi ändern.
CCMSETUPCMD
Verwenden Sie dieses ccmsetup. MSI-Eigenschaft verwenden, um zusätzliche Befehlszeilenparameter und -eigenschaften an ccmsetup zu übergeben. exe. Fügen Sie andere Parameter und Eigenschaften in Anführungszeichen (") ein. Verwenden Sie diese Eigenschaft, wenn Sie den Konfigurations-Manager-Client mit der MDM-Installationsmethode Intune booten.
Beispiel: ccmsetup.msi CCMSETUPCMD="/mp:https://mp.contoso.com CCMHOSTNAME=mp.contoso.com"
Tipp
Microsoft Intune schränkt die Befehlszeile auf 1024 Zeichen ein.
Client.msi Eigenschaften
Die folgenden Eigenschaften können das Installationsverhalten von client.msi ändern, das ccmsetup.exe installiert.
AADCLIENTAPPID
Gibt den Bezeichner der Microsoft Entra-Client-App an. Sie erstellen oder importieren die Client-App, wenn Sie Azure Services für die Cloudverwaltung konfigurieren. Ein Azure-Administrator kann den Wert für diese Eigenschaft über das Azure-Portal abrufen. Weitere Informationen finden Sie unter Abrufen der Anwendungs-ID. Für die AADCLIENTAPPID Eigenschaft gilt diese Anwendungs-ID für den nativen Anwendungstyp.
Beispiel: ccmsetup.exe AADCLIENTAPPID=aa28e7f1-b88a-43cd-a2e3-f88b257c863b
AADRESOURCEURI
Gibt den Bezeichner der Microsoft Entra-Server-App an. Sie erstellen oder importieren die Server-App, wenn Sie Azure Services für die Cloudverwaltung konfigurieren. Wenn Sie die Server-App erstellen, ist diese Eigenschaft im Fenster "Serveranwendung erstellen" der App-ID-URI.
Ein Azure-Administrator kann den Wert für diese Eigenschaft über das Azure-Portal abrufen. Suchen Sie in Microsoft Entra ID die Server-App unter App-Registrierungen. Suchen Sie nach dem Anwendungstyp: Web-App/API. Öffnen Sie die App, wählen Sie Einstellungen und dann Eigenschaften. Verwenden Sie den App-ID-URI-Wert für diese AADRESOURCEURI Clientinstallationseigenschaft.
Beispiel: ccmsetup.exe AADRESOURCEURI=https://contososerver
AADTENANTID
Gibt die Microsoft Entra-Mandanten-ID an. Konfigurations-Manager verknüpft diesen Mandanten, wenn Sie Azure Services für die Cloudverwaltung konfigurieren. Führen Sie die folgenden Schritte aus, um den Wert für diese Eigenschaft abzurufen:
Öffnen Sie auf einem Gerät, auf dem Windows 10 oder höher ausgeführt wird und das demselben Microsoft Entra-Mandanten angehört, eine Eingabeaufforderung.
Führen Sie den folgenden Befehl aus:
dsregcmd.exe /statusSuchen Sie im Abschnitt "Gerätestatus" nach dem TenantId-Wert . Beispiel:
TenantId : aaaabbbb-0000-cccc-1111-dddd2222eeeeHinweis
Ein Azure-Administrator kann diesen Wert auch im Azure-Portal abrufen. Weitere Informationen finden Sie unter Abrufen der Mandanten-ID.
Beispiel: ccmsetup.exe AADTENANTID=aaaabbbb-0000-cccc-1111-dddd2222eeee
CCMADMINS
Gibt mindestens ein Windows-Benutzerkonto oder eine Windows-Gruppe an, die Zugriff auf Clienteinstellungen und -richtlinien erhalten sollen. Diese Eigenschaft ist nützlich, wenn Sie nicht über lokale Administratoranmeldeinformationen auf dem Clientcomputer verfügen. Geben Sie eine Liste der Konten an, die durch Semikolons (;) getrennt werden.
Beispiel: CCMSetup.exe CCMADMINS="domain\account1;domain\group1"
CCMALLOWSILENTREBOOT
Lassen Sie den Computer nach der Clientinstallation ggf. automatisch neu starten.
Wichtig
Wenn Sie diese Eigenschaft verwenden, wird der Computer ohne Vorwarnung neu gestartet. Dieses Verhalten tritt auch dann auf, wenn ein Benutzer bei Windows angemeldet ist.
Beispiel: CCMSetup.exe CCMALLOWSILENTREBOOT
CCMALWAYSINF
Um anzugeben, dass der Client immer internetbasiert ist und niemals eine Verbindung zum Intranet herstellt, setzen Sie diesen Eigenschaftswert auf 1. Als Verbindungstyp des Clients wird "Immer Internet" angezeigt.
Verwenden Sie diese Eigenschaft mit CCMHOSTNAME , um den FQDN des internetbasierten Verwaltungspunkts anzugeben. Verwenden Sie es auch mit dem CCMSetup-Parameter UsePKICert und der SMSSITECODE-Eigenschaft .
Weitere Informationen zur internetbasierten Clientverwaltung finden Sie unter Überlegungen zur Clientkommunikation über das Internet oder eine nicht vertrauenswürdige Gesamtstruktur.
Beispiel: CCMSetup.exe /UsePKICert CCMALWAYSINF=1 CCMHOSTNAME=SERVER3.CONTOSO.COM SMSSITECODE=ABC
CCMCERTISSUERS
Verwenden Sie diese Eigenschaft, um die Liste der Zertifikataussteller anzugeben. Diese Liste enthält Zertifikatinformationen für die vertrauenswürdigen Stammzertifizierungsstellen (CA), denen der Konfigurations-Manager-Standort vertraut.
Bei diesem Wert wird die Groß-/Kleinschreibung für die Attribute des Antragstellers im Zertifikat der Stammzertifizierungsstelle beachtet. Trennen Sie Attribute durch ein Komma (,) oder ein Semikolon (;). Geben Sie mehr als ein Root-CA-Zertifikat mithilfe einer Trennleiste (|) an.
Beispiel: CCMCERTISSUERS="CN=Contoso Root CA; OU=Servers; O=Contoso, Ltd; C=US | CN=Litware Corporate Root CA; O=Litware, Inc."
Tipp
Verwenden Sie den Wert des Attributs CertificateIssuers in der Datei mobileclient.tcf für die Site. Diese Datei befindet sich im \bin\<platform> Unterordner des Installationsverzeichnisses von Konfigurations-Manager auf dem Standortserver.
Weitere Informationen zur Liste der Zertifikataussteller und dazu, wie Clients sie während des Zertifikatauswahlprozesses verwenden, finden Sie unter Planen der Auswahl von PKI-Clientzertifikaten.
CCMCERTNAMECHECK
Ab Version 2207 kann diese Eigenschaft verwendet werden, um die Überprüfung des Antragstellernamens für das Zertifikat zu überspringen.
CCMCERTNAMECHECK=0 Überspringt die Überprüfung des Antragstellernamens des Zertifikats.
CCMCERTSEL
Wenn der Client über mehrere Zertifikate für die HTTPS-Kommunikation verfügt, gibt diese Eigenschaft die Kriterien für die Auswahl eines gültigen Clientauthentifizierungszertifikats an.
Verwenden Sie die folgenden Schlüsselwörter, um das Zertifikat zu durchsuchen: Antragstellername oder alternativer Antragstellername:
-
Subject: Eine exakte Übereinstimmung suchen -
SubjectStr: Eine Teilübereinstimmung suchen
Beispiele:
CCMCERTSEL="Subject:computer1.contoso.com": Suchen Sie nach einem Zertifikat mit einer genauen Übereinstimmung mit dem Computernamencomputer1.contoso.comim Antragstellernamen oder dem alternativen Antragstellernamen.CCMCERTSEL="SubjectStr:contoso.com": Suchen Sie nach einem Zertifikat, das im Antragstellernamen oder im alternativen Antragstellernamen enthalten istcontoso.com.
Verwenden Sie das SubjectAttr Schlüsselwort (keyword), um nach den Attributen Objektbezeichner (OID) oder definierten Namen im Antragstellernamen oder alternativen Antragstellernamen zu suchen.
Beispiele:
CCMCERTSEL="SubjectAttr:2.5.4.11 = Computers": Suchen Sie nach dem Attribut der Organisationseinheit, das als Objektbezeichner ausgedrückt wird und benannt istComputers.CCMCERTSEL="SubjectAttr:OU = Computers": Suchen Sie nach dem Attribut der Organisationseinheit, ausgedrückt als distinguished name und benanntComputers.
Wichtig
Wenn Sie den Betreffnamen verwenden, Subject wird beim Schlüsselwort (keyword) zwischen Groß- und Kleinschreibung unterschieden, und für das SubjectStr Schlüsselwort (keyword) wird die Groß-/Kleinschreibung nicht beachtet.
Wenn Sie den alternativen Antragstellernamen verwenden, wird bei den Schlüsselwörtern Subject und den SubjectStr Schlüsselwörtern die Groß-/Kleinschreibung nicht beachtet.
Eine vollständige Liste der Attribute, die Sie für die Zertifikatsauswahl verwenden können, finden Sie unter Unterstützte Attributwerte für PKI-Zertifikatauswahlkriterien.
Wenn mehr als ein Zertifikat mit der Suche übereinstimmt und Sie den Wert CCMFIRSTCERT festlegen 1, wählt das Clientinstallationsprogramm das Zertifikat mit der längsten Gültigkeitsdauer aus.
CCMCERTSTORE
Wenn das Clientinstallationsprogramm im standardmäßigen persönlichen Zertifikatspeicher für den Computer kein gültiges Zertifikat finden kann, verwenden Sie diese Eigenschaft, um einen alternativen Namen für den Zertifikatspeicher anzugeben.
Beispiel: CCMSetup.exe /UsePKICert CCMCERTSTORE="ConfigMgr"
CCMDEBUGLOGGING
Diese Eigenschaft aktiviert die Debugprotokollierung, wenn der Client installiert wird. Diese Eigenschaft veranlasst den Client, Informationen auf niedriger Ebene zur Problembehandlung zu protokollieren. Vermeiden Sie die Verwendung dieser Eigenschaft in Produktionsstätten. Es kann zu einer übermäßigen Protokollierung kommen, die es schwierig machen kann, relevante Informationen in den Protokolldateien zu finden. Aktivieren CCMENABLELOGGINGSie auch .
Unterstützte Werte:
-
0: Debugprotokollierung deaktivieren (Standard) -
1: Aktivieren der Debugprotokollierung
Beispiel: CCMSetup.exe CCMDEBUGLOGGING=1
Weitere Informationen finden Sie unter Informationen zu Protokolldateien.
CCMENABLELOGGING
Der Konfigurations-Manager aktiviert standardmäßig die Protokollierung.
Unterstützte Werte:
-
TRUE: Protokollierung aktivieren (Standard) -
FALSE: Protokollierung deaktivieren
Beispiel: CCMSetup.exe CCMENABLELOGGING=TRUE
Weitere Informationen finden Sie unter Informationen zu Protokolldateien.
CCMEVALINTERVAL
Die Häufigkeit in Minuten, mit der das Tool zur Bewertung der Clientintegrität (Client Health Evaluation, ccmeval.exe) ausgeführt wird. Geben Sie einen ganzzahligen Wert von 1 bis an 1440. Standardmäßig wird ccmeval einmal täglich (1440 Minuten) ausgeführt.
Beispiel: CCMSetup.exe CCMEVALINTERVAL=1440
Weitere Informationen zur Auswertung der Clientintegrität finden Sie unter Überwachen von Clients.
CCMEVALHOUR
Die Stunde während des Tages, zu der das Tool zur Bewertung der Client-Integrität (Client Health Evaluation, ccmeval.exe) ausgeführt wird. Geben Sie einen Ganzzahlwert zwischen 0 (Mitternacht) bis 23 (23:00 Uhr) an. Standardmäßig wird ccmeval um Mitternacht ausgeführt.
Weitere Informationen zur Auswertung der Clientintegrität finden Sie unter Überwachen von Clients.
CCMFIRSTCERT
Wenn Sie diese Eigenschaft auf 1festlegen, wählt der Client das PKI-Zertifikat mit der längsten Gültigkeitsdauer aus.
Beispiel: CCMSetup.exe /UsePKICert CCMFIRSTCERT=1
CCMHOSTNAME
Wenn der Client über das Internet verwaltet wird, gibt diese Eigenschaft den FQDN des internetbasierten Verwaltungspunkts an.
Geben Sie diese Option nicht mit der Installationseigenschaft von SMSSITECODE=AUTOan. Weisen Sie internetbasierte Clients direkt einer internetbasierten Site zu.
Beispiel: CCMSetup.exe /UsePKICert CCMHOSTNAME="SMSMP01.corp.contoso.com"
Diese Eigenschaft kann die Adresse eines Cloudverwaltungsgateways (Cloud Management Gateway, CMG) angeben. Führen Sie die folgenden Schritte aus, um den Wert für diese Eigenschaft abzurufen:
Erstellen einer CMG. Weitere Informationen finden Sie unter Einrichten einer CMG.
Öffnen Sie auf einem aktiven Client eine Windows PowerShell-Eingabeaufforderung als Administrator.
Führen Sie den folgenden Befehl aus:
(Get-WmiObject -Namespace Root\Ccm\LocationServices -Class SMS_ActiveMPCandidate | Where-Object {$_.Type -eq "Internet"}).MPVerwenden Sie den zurückgegebenen Wert unverändert mit der
CCMHOSTNAMEEigenschaft.
Beispiel: ccmsetup.exe CCMHOSTNAME=CONTOSO.CLOUDAPP.NET/CCM_Proxy_MutualAuth/72057598037248100
Wichtig
Wenn Sie die Adresse einer CMG für die CCMHOSTNAME Eigenschaft angeben, fügen Sie kein Präfix wie https://an. Verwenden Sie dieses Präfix nur mit der /mp URL eines CMG.
CCMHTTPPORT
Gibt den Port an, den der Client verwenden soll, wenn er über HTTP mit Standortsystemservern kommuniziert. Standardmäßig lautet 80dieser Wert .
Beispiel: CCMSetup.exe CCMHTTPPORT=80
CCMHTTPSPORT
Gibt den Port an, den der Client verwenden soll, wenn er über HTTPS mit Standortsystemservern kommuniziert. Standardmäßig lautet 443dieser Wert .
Beispiel: CCMSetup.exe /UsePKICert CCMHTTPSPORT=443
CCMINSTALLDIR
Verwenden Sie diese Eigenschaft, um den Ordner zum Installieren der Konfigurations-Manager-Clientdateien festzulegen. Standardmäßig wird %WinDir%\CCMverwendet.
Tipp
Unabhängig davon, wo Sie die Clientdateien installieren, wird immer die ccmcore.dll Datei im %WinDir%\System32 Ordner installiert. Unter einem 64-Bit-Betriebssystem wird eine Kopie der ccmcore.dll in dem %WinDir%\SysWOW64 Ordner installiert. Diese Datei unterstützt 32-Bit-Anwendungen, die die 32-Bit-Version der Client-APIs aus dem Konfigurations-Manager SDK verwenden.
Beispiel: CCMSetup.exe CCMINSTALLDIR="C:\ConfigMgr"
CCMLOGLEVEL
Verwenden Sie diese Eigenschaft, um die Detailebene anzugeben, die in Konfigurations-Manager-Protokolldateien geschrieben werden soll.
Unterstützte Werte:
-
0: Ausführlich -
1: Standard -
2: Warnungen und Fehler -
3: Nur Fehler
Beispiel: CCMSetup.exe CCMLOGLEVEL=0
Weitere Informationen finden Sie unter Informationen zu Protokolldateien.
CCMLOGMAXHISTORY
Wenn eine Konfigurations-Manager-Protokolldatei die maximale Größe erreicht, benennt der Client sie in eine Sicherung um und erstellt eine neue Protokolldatei. Diese Eigenschaft gibt an, wie viele frühere Versionen der Protokolldatei beibehalten werden sollen. Der Standardwert ist 1. Wenn Sie den Wert auf 0festlegen, speichert der Client keinen Protokolldateiverlauf.
Beispiel: CCMSetup.exe CCMLOGMAXHISTORY=5
Weitere Informationen finden Sie unter Informationen zu Protokolldateien.
CCMLOGMAXSIZE
Diese Eigenschaft gibt die maximale Protokolldateigröße in Bytes an. Wenn ein Protokoll auf die angegebene Größe anwächst, benennt der Client es in eine Verlaufsdatei um und erstellt eine neue Datei. Die Standardgröße beträgt 250.000 Byte, die Mindestgröße 10.000 Byte.
Beispiel: CCMSetup.exe CCMLOGMAXSIZE=300000 (300.000 Bytes)
DISABLESITEOPT
Legen Sie diese Eigenschaft fest, um TRUE zu verhindern, dass Administratoren den zugewiesenen Standort in der Systemsteuerung von Konfigurations-Manager ändern.
Beispiel: CCMSetup.exe DISABLESITEOPT=TRUE
DISABLECACHEOPT
Wenn diese Eigenschaft auf TRUE festgelegt ist, können Administratoren die Einstellungen des Clientcacheordners in der Systemsteuerung des Konfigurations-Manager nicht ändern.
Beispiel: CCMSetup.exe DISABLECACHEOPT=TRUE
DNSSUFFIX
Geben Sie eine DNS-Domäne an, in der Clients Verwaltungspunkte suchen sollen, die Sie in DNS veröffentlichen. Wenn der Client einen Verwaltungspunkt sucht, informiert er ihn über andere Verwaltungspunkte in der Hierarchie. Dieses Verhalten bedeutet, dass der Verwaltungspunkt, den der Client über DNS findet, ein beliebiger in der Hierarchie sein kann.
Hinweis
Sie müssen diese Eigenschaft nicht angeben, wenn sich der Client in derselben Domäne wie ein veröffentlichter Verwaltungspunkt befindet. In diesem Fall wird die Domäne des Clients automatisch verwendet, um DNS nach Verwaltungspunkten zu durchsuchen.
Weitere Informationen zur DNS-Veröffentlichung als Dienstidentifizierungsmethode für Konfigurations-Manager-Clients finden Sie unter Dienstspeicherort und wie Clients ihren zugewiesenen Verwaltungspunkt bestimmen.
Hinweis
Standardmäßig aktiviert Konfigurations-Manager die DNS-Veröffentlichung nicht.
Beispiel: CCMSetup.exe SMSSITECODE=ABC DNSSUFFIX=contoso.com
FSP
Geben Sie den Fallback-status-Punkt an, der von Konfigurations-Manager Clients gesendete Statusmeldungen empfängt und verarbeitet.
Weitere Informationen finden Sie unter Ermitteln, ob Sie einen Fallback-Status-Punkt benötigen.
Beispiel: CCMSetup.exe FSP=SMSFP01
IGNOREAPPVVERSIONCHECK
Wenn Sie diese Eigenschaft auf TRUEfestlegen, überprüft das Clientinstallationsprogramm nicht die erforderliche Mindestversion von Microsoft Application Virtualization (App-V).
Wichtig
Wenn Sie den Konfigurations-Manager-Client installieren, ohne App-V zu installieren, können Sie keine virtuellen Anwendungen bereitstellen.
Beispiel: CCMSetup.exe IGNOREAPPVVERSIONCHECK=TRUE
MANAGEDINSTALLER
Wenn Sie diese Eigenschaft so festlegen, 1 werden ccmsetup.exe und client.msi als verwaltete Installationsprogramme festgelegt. Weitere Informationen finden Sie unter Automatisches Zulassen von Apps, die von einem verwalteten Installationsprogramm mit Windows Defender Application Control bereitgestellt werden.
Beispiel: CCMSetup.exe MANAGEDINSTALLER=1
NOTIFYONLY
Wenn Sie diese Eigenschaft aktivieren, meldet der Client den Status, behebt jedoch keine gefundenen Probleme.
Beispiel: CCMSetup.exe NOTIFYONLY=TRUE
Weitere Informationen finden Sie unter Konfigurieren des Client-Status.
PROVISIONTS
Verwenden Sie diese Eigenschaft, um eine Tasksequenz auf einem Client zu starten, nachdem dieser sich erfolgreich bei der Website registriert hat.
Hinweis
Wenn die Tasksequenz Softwareupdates oder Anwendungen installiert, benötigen Clients ein gültiges Clientauthentifizierungszertifikat. Die Tokenauthentifizierung allein funktioniert nicht.
Sie stellen z. B. ein neues Windows-Gerät mit Windows Autopilot bereit, registrieren es automatisch bei Microsoft Intune und installieren dann den Konfigurations-Manager-Client für die gemeinsame Verwaltung. Wenn Sie diese neue Option angeben, führt der neu bereitgestellte Client eine Tasksequenz aus. Dieser Prozess bietet Ihnen zusätzliche Flexibilität, Anwendungen und Softwareupdates zu installieren oder Einstellungen zu konfigurieren.
Gehen Sie folgendermaßen vor:
Erstellen Sie eine nicht auf dem Betriebssystem basierende Bereitstellungstasksequenz , um Apps zu installieren, Softwareupdates zu installieren und Einstellungen zu konfigurieren.
Stellen Sie diese Tasksequenz für die neue integrierte Sammlung Alle Bereitstellungsgeräte bereit. Notieren Sie sich beispielsweise die Bereitstellungs-ID
PRI20001der Tasksequenz.Tipp
Der Zweck der Bereitstellung kann entweder verfügbar oder erforderlich sein. Da Sie die Bereitstellungs-ID als Eigenschaftswert angeben, spielt der Zweck keine Rolle.
Installieren Sie den Konfigurations-Manager Client auf einem Gerät mit ccmsetup.msi, und schließen Sie die folgende Eigenschaft ein:
PROVISIONTS=PRI20001. Legen Sie den Wert dieser Eigenschaft als Tasksequenz-Bereitstellungs-ID fest.Wenn Sie den Client während der Co-Management-Registrierung über Intune installieren, finden Sie weitere Informationen unter Vorbereiten internetbasierter Geräte für die Co-Management.
Hinweis
Für diese Methode können zusätzliche Voraussetzungen gelten. Beispielsweise das Registrieren der Website bei Microsoft Entra ID oder das Erstellen eines inhaltsfähigen Cloudverwaltungsgateways.
Verwenden Sie diese Eigenschaft unabhängig von der Methode nur mit ccmsetup.msi.
Nachdem der Client installiert und ordnungsgemäß bei der Website registriert wurde, startet er die Tasksequenz, auf die verwiesen wird. Wenn die Clientregistrierung fehlschlägt, wird die Tasksequenz nicht gestartet.
Hinweis
Die gestartete PROVISIONTS Tasksequenz verwendet die Standardclienteinstellungen. Diese Tasksequenz wird unmittelbar nach der Registrierung des Clients gestartet und ist daher nicht Teil einer Sammlung, für die Sie benutzerdefinierte Clienteinstellungen bereitgestellt haben. Der Client verarbeitet oder wendet keine benutzerdefinierten Clienteinstellungen an, bevor diese Tasksequenz ausgeführt wird.
Damit die Tasksequenz ordnungsgemäß funktioniert, müssen Sie möglicherweise bestimmte Einstellungen in den Standardclienteinstellungen ändern. Zum Beispiel:
- Gruppe "Cloud Services": Clients die Verwendung eines Cloudverwaltungsgateways ermöglichen und Zugriff auf Cloudverteilungspunkt zulassen
- Computer-Agent-Gruppe : PowerShell-Ausführungsrichtlinie
Wenn Geräte diese Clienteinstellungen nach Abschluss der Tasksequenz nicht benötigen, stellen Sie neue benutzerdefinierte Clienteinstellungen bereit, um die Standardeinstellungen rückgängig zu machen.
Weitere Informationen finden Sie unter Informationen zu Clienteinstellungen.
RESETKEYINFORMATION
Wenn ein Client über den falschen vertrauenswürdigen Konfigurations-Manager-Stammschlüssel verfügt, kann er keinen vertrauenswürdigen Verwaltungspunkt kontaktieren, um den neuen vertrauenswürdigen Stammschlüssel zu erhalten. Verwenden Sie diese Eigenschaft, um den alten vertrauenswürdigen Stammschlüssel zu entfernen. Diese Situation kann auftreten, wenn Sie einen Client aus einer Standorthierarchie in eine andere verschieben. Diese Eigenschaft gilt für Clients, die HTTP- und HTTPS-Clientkommunikation verwenden. Weitere Informationen finden Sie unter Planen des vertrauenswürdigen Stammschlüssels.
Beispiel: CCMSetup.exe RESETKEYINFORMATION=TRUE
SITEREASSIGN
Aktiviert die automatische Neuzuweisung von Standorten für Clientupgrades, wenn sie mit SMSSITECODE=AUTO verwendet wird.
Beispiel: CCMSetup.exe SMSSITECODE=AUTO SITEREASSIGN=TRUE
SMSCACHEDIR
Gibt den Speicherort des Clientcacheordners auf dem Clientcomputer an. Standardmäßig ist %WinDir%\ccmcacheder Cachespeicherort .
Beispiel: CCMSetup.exe SMSCACHEDIR="C:\Temp"
Verwenden Sie diese Eigenschaft zusammen mit der SMSCACHEFLAGS Eigenschaft, um den Speicherort des Clientcacheordners zu steuern. So installieren Sie beispielsweise den Clientcacheordner auf dem größten verfügbaren Clientlaufwerk: CCMSetup.exe SMSCACHEDIR=Cache SMSCACHEFLAGS=MAXDRIVE
SMSCACHEFLAGS
Verwenden Sie diese Eigenschaft, um weitere Installationsdetails für den Clientcacheordner anzugeben. Sie können Eigenschaften einzeln oder in Kombination verwenden SMSCACHEFLAGS , getrennt durch Semikolons (;).
Wenn Sie diese Eigenschaft nicht angeben:
- Der Client installiert den Cacheordner gemäß der
SMSCACHEDIREigenschaft - Der Ordner ist nicht komprimiert
- Der Client verwendet diese
SMSCACHESIZEEigenschaft als Größenbeschränkung in MB für den Cache
Wenn Sie einen vorhandenen Client aktualisieren, ignoriert das Clientinstallationsprogramm diese Eigenschaft.
Werte für die SMSCACHEFLAGS Eigenschaft
PERCENTDISKSPACE: Legen Sie die Cachegröße als Prozentsatz des gesamten Speicherplatzes fest. Wenn Sie diese Eigenschaft angeben, wird sie auch auf einen Prozentwert festgelegtSMSCACHESIZE.PERCENTFREEDISKSPACE: Legen Sie die Cachegröße als Prozentsatz des freien Speicherplatzes fest. Wenn Sie diese Eigenschaft angeben, wird sie auch als Prozentwert festgelegtSMSCACHESIZE. Angenommen, der Datenträger hat 10 MB freien Speicherplatz, und Sie gebenSMSCACHESIZE=50an. Das Clientinstallationsprogramm legt die Cachegröße auf 5 MB fest. Sie können diese Eigenschaft nicht mit derPERCENTDISKSPACEEigenschaft verwenden.MAXDRIVE: Installieren Sie den Cache auf dem größten verfügbaren Datenträger. Wenn Sie mit derSMSCACHEDIREigenschaft einen Pfad angeben, ignoriert das Clientinstallationsprogramm diesen Wert.MAXDRIVESPACE: Installieren Sie den Cache auf dem Laufwerk mit dem meisten freien Speicherplatz. Wenn Sie mit derSMSCACHEDIREigenschaft einen Pfad angeben, ignoriert das Clientinstallationsprogramm diesen Wert.NTFSONLY: Installieren Sie den Cache nur auf einem NTFS-formatierten Laufwerk. Wenn Sie mit derSMSCACHEDIREigenschaft einen Pfad angeben, ignoriert das Clientinstallationsprogramm diesen Wert.COMPRESS: Speichern Sie den Cache in komprimierter Form.FAILIFNOSPACE: Wenn der Speicherplatz für die Installation des Caches nicht ausreicht, entfernen Sie den Konfigurations-Manager-Client.
Beispiel: CCMSetup.exe SMSCACHEFLAGS=NTFSONLY;COMPRESS
SMSCACHESIZE
Wichtig
Clienteinstellungen stehen zum Angeben der Größe des Clientcacheordners zur Verfügung. Das Hinzufügen dieser Clienteinstellungen ersetzt effektiv die Verwendung von SMSCACHESIZE als client.msi Eigenschaft, um die Größe des Clientcaches anzugeben. Weitere Informationen finden Sie in den Clienteinstellungen für die Cachegröße.
Wenn Sie einen vorhandenen Client aktualisieren, ignoriert das Clientinstallationsprogramm diese Einstellung. Der Client ignoriert beim Herunterladen von Softwareupdates auch die Cachegröße.
Beispiel: CCMSetup.exe SMSCACHESIZE=100
Hinweis
Wenn Sie einen Client neu installieren, können Sie die Cachegröße nicht mehr auf "Kleiner als zuvor" festlegen SMSCACHESIZESMSCACHEFLAGS . Die vorherige Größe ist der Mindestwert.
SMSCONFIGSOURCE
Verwenden Sie diese Eigenschaft, um den Speicherort und die Reihenfolge anzugeben, in der das Clientinstallationsprogramm die Konfigurationseinstellungen überprüft. Es handelt sich um eine Zeichenfolge aus einem oder mehreren Zeichen, die jeweils eine bestimmte Konfigurationsquelle definiert:
R: Überprüfen Sie die Konfigurationseinstellungen in der Registrierung.Weitere Informationen finden Sie unter Bereitstellen von Clientinstallationseigenschaften.
P: Überprüfen Sie in der Befehlszeile die Konfigurationseinstellungen in den Installationseigenschaften.M: Überprüfen Sie vorhandene Einstellungen, wenn Sie einen älteren Client aktualisieren.U: Aktualisieren Sie den installierten Client auf eine neuere Version und verwenden Sie den zugewiesenen Standortcode.
Standardmäßig verwendet PUdas Clientinstallationsprogramm . Er prüft zunächst die Installationseigenschaften (P) und dann die vorhandenen Einstellungen (U).
Beispiel: CCMSetup.exe SMSCONFIGSOURCE=RP
SMSMP
Gibt einen anfänglichen Verwaltungspunkt an, den der Konfigurations-Manager-Client verwenden soll.
Wichtig
Wenn der Verwaltungspunkt nur Clientverbindungen über HTTPS akzeptiert, stellen Sie dem Namen des Verwaltungspunkts das Präfix voran.https://
Beispiele:
CCMSetup.exe SMSMP=smsmp01.contoso.comCCMSetup.exe SMSMP=https://smsmp01.contoso.com
SMSMPLIST
Gibt eine Liste der Verwaltungspunkte an, die vom Konfigurations-Manager-Client verwendet werden sollen. Verwenden Sie ein Semikolon (;) als Trennzeichen, wenn Sie mehrere Verwaltungspunkte angeben.
Wichtig
Wenn der Verwaltungspunkt nur Clientverbindungen über HTTPS akzeptiert, stellen Sie dem Namen des Verwaltungspunkts das Präfix voran.https://
Beispiele:
CCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;https://smsmp02.contoso.com;smsmp03.contoso.comCCMSetup.exe SMSMPLIST=https://smsmp01.contoso.com;smsmp02.contoso.com;smsmp03.contoso.com
SMSPUBLICROOTKEY
Wenn der Client den vertrauenswürdigen Konfigurations-Manager Stammschlüssel nicht von Active Directory Domain Services abrufen kann, verwenden Sie diese Eigenschaft, um den Schlüssel anzugeben. Diese Eigenschaft gilt für Clients, die HTTP- und HTTPS-Kommunikation verwenden. Weitere Informationen finden Sie unter Planen des vertrauenswürdigen Stammschlüssels.
Beispiel: CCMSetup.exe SMSPUBLICROOTKEY=<keyvalue>
Tipp
Rufen Sie den Wert für den vertrauenswürdigen Stammschlüssel der Website aus der Datei mobileclient.tcf auf dem Standortserver ab. Weitere Informationen finden Sie unter Vorab einen Client mit dem vertrauenswürdigen Stammschlüssel mithilfe einer Datei bereitstellen.
SMSROOTKEYPATH
Verwenden Sie diese Eigenschaft, um den vertrauenswürdigen Stammschlüssel von Konfigurations-Manager neu zu installieren. Sie gibt den vollständigen Pfad und Namen einer Datei an, die den vertrauenswürdigen Stammschlüssel enthält. Diese Eigenschaft gilt für Clients, die HTTP- und HTTPS-Clientkommunikation verwenden. Weitere Informationen finden Sie unter Planen des vertrauenswürdigen Stammschlüssels.
Beispiel: CCMSetup.exe SMSROOTKEYPATH=C:\folder\trk
SMSSIGNCERT
Gibt den vollständigen Pfad und Namen des exportierten selbstsignierten Zertifikats auf dem Standortserver an. Der Standortserver speichert dieses Zertifikat im SMS-Zertifikatspeicher . Sie verfügt über den Betreffnamen Standortserver und den Anzeigenamen Standortserver-Signaturzertifikat.
Exportieren Sie das Zertifikat ohne den privaten Schlüssel, speichern Sie die Datei sicher, und greifen Sie nur über einen gesicherten Kanal darauf zu.
Beispiel: CCMSetup.exe /UsePKICert SMSSIGNCERT=C:\folder\smssign.cer
SMSSITECODE
Diese Eigenschaft gibt einen Konfigurations-Manager-Standort an, dem Sie den Client zuweisen. Dieser Wert kann entweder ein dreistelliger Websitecode oder das Wort AUTOsein. Wenn Sie diese Eigenschaft angeben AUTOoder nicht angeben, versucht der Client, die Standortzuweisung von Active Directory Domain Services oder von einem angegebenen Verwaltungspunkt zu ermitteln. Legen Sie zum Aktivieren AUTO für Clientupgrades auch SITEREASSIGN=TRUE fest.
Hinweis
Wenn Sie auch einen internetbasierten Verwaltungspunkt mit der CCMHOSTNAME Eigenschaft angeben, verwenden AUTO Sie nicht mit SMSSITECODE. Weisen Sie den Client direkt seinem Standort zu, indem Sie den Standortcode angeben.
Beispiel: CCMSetup.exe SMSSITECODE=XZY
UPGRADETOLATEST
Diese Eigenschaft zwingt CCMSetup, eine Standortanforderung an den Verwaltungspunkt zu senden, um die neueste Version der Konfigurations-Manager Clientinstallationsquelle abzurufen. Es gibt mehrere Szenarien, in denen diese Eigenschaft besonders nützlich ist:
Präproduktionsclients. Ein neu installierter Client verwendet die Produktionsbaseline, da er die Präproduktionssammlung erst auswerten kann, wenn der Client installiert ist. In diesem Szenario wird der Client, nachdem er installiert ist und die Richtlinie ausgewertet hat, später auf die Client-Präproduktionsversion aktualisiert. Verwenden Sie diese Eigenschaft, damit das Gerät sofort die neueste Version des Clients installiert.
Dieses Szenario gilt auch für die Verwendung von Windows Autopilot in der gemeinsamen Verwaltung. Verwenden Sie diese Eigenschaft, um sicherzustellen, dass das neu bereitgestellte Windows Autopilot-Gerät sofort die Vorproduktionsclientversion verwendet.
Pull-Verteilungspunkte. Pull-Verteilungspunkte können die Installation der neuesten Clientversion zulassen, auch wenn sie sich nicht in der Präproduktionssammlung befindet. Dadurch wird sichergestellt, dass die Clientversion auf dem Pullverteilungspunkt mit den Binärdateien des Verteilungspunkts übereinstimmt. Wenn diese Versionen nicht identisch sind, kann es zu Problemen kommen.
Attributwerte für Zertifikatauswahlkriterien
Konfigurations-Manager unterstützt die folgenden Attributwerte für die Auswahlkriterien für PKI-Zertifikate:
| OID-Attribut | Distinguished Name-Attribut | Attributdefinition |
|---|---|---|
| 0.9.2342.19200300.100.1.25 | Gleichstrom | Domänenkomponente |
| 1.2.840.113549.1.9.1 | E oder E-Mail | E-Mail-Adresse |
| 2.5.4.3 | CN | Allgemeiner Name |
| 2.5.4.4 | SN | Antragstellername |
| 2.5.4.5 | SERIENNUMMER | Seriennummer |
| 2.5.4.6 | C | Landeskennzahl |
| 2.5.4.7 | L | Ort |
| 2.5.4.8 | S oder ST | Name des Bundesstaats oder Bundeslands/Kantons |
| 2.5.4.9 | STRASSE | Adresse |
| 2.5.4.10 | O | Name der Organisation |
| 2.5.4.11 | OE | Organisationseinheit |
| 2.5.4.12 | T oder Titel | Position |
| 2.5.4.42 | G oder GN oder GivenName | Vorname |
| 2.5.4.43 | I oder Initialen | Initialen |
| 2.5.29.17 | (kein Wert) | Alternativer Antragstellername |
Clientpushinstallation
Wenn Sie die Clientpushinstallationsmethode verwenden, verwenden Sie die folgenden Optionen auf der Registerkarte Client der Eigenschaften der Clientpushinstallation in der Konfigurations-Manager Konsole:
Eine der Client.msi Eigenschaften
Die folgende Teilmenge CCMSetup.exe Befehlszeilenparametern ist für Clientpush zulässig:
/AllowMetered(ab Version 2103)/AlwaysExcludeUpgrade/BITSPriority/downloadtimeout/ExcludeFeatures/forcereboot/logon/skipprereq/UsePKICert