Configurer le cache d’homologue pour les clients Configuration Manager

Article
12/14/2024

S’applique à : Microsoft Endpoint Configuration Manager (Current Branch)

Le cache d’homologue est une solution intégrée pour Microsoft Endpoint Configuration Manager qui permet aux clients de partager du contenu avec d’autres clients directement à partir de leur cache local. Il étend les solutions de déploiement de contenu traditionnelles, telles que les points de distribution. Utilisez le cache d’homologue pour gérer le déploiement de contenu sur des clients dans des emplacements distants. Pour plus d’informations, consultez Le cache d’homologue pour les clients Configuration Manager.

Configurer les paramètres du client de cache d’homologue

Pour permettre aux clients d’être des sources de cache d’homologue, procédez comme suit :

Dans la console Configuration Manager, créez un regroupement d’appareils. Déterminez les clients que vous souhaitez activer en tant que sources de cache d’homologue et ajoutez-les à la collection.
Accédez à l’espace de travail Administration , puis sélectionnez le nœud Paramètres du client.
Sélectionnez Créer des paramètres d’appareil client personnalisé, spécifiez un nom et une description, puis sélectionnez le groupe Paramètres du cache du client.
Dans le volet de navigation, sélectionnez Paramètres du cache du client, définissez Activer comme source de cache homologue sur Oui, puis spécifiez les ports.
Sélectionnez OK pour enregistrer les paramètres.
Déployez ce paramètre client personnalisé sur la collection d’appareils que vous avez créée à l’étape 1.

Vous n’avez pas besoin d’activer les clients de cache homologue. Lorsque vous autorisez les clients à être des sources de cache d’homologue, le point de gestion les inclut dans la liste des sources d’emplacement de contenu.

Modifications sur les clients qui agissent en tant que sources de cache d’homologue

Lorsque le paramètre de cache client est déployé sur le regroupement d’appareils, vous verrez les modifications suivantes sur les sources de cache homologue :

Dans l’instance CCM_SuperPeerClientConfig.SiteSettingsKey=1 de classe WMI sous ROOT\ccm\Policy\Machine\ActualConfig:

La valeur de la propriété CanBeSuperPeerPeer est remplacée par True.

Les entrées suivantes sont consignées CcmExec.log :

Notifying endpoint 'SuperPeerController' of 1 settings change(s).
Notifying endpoint 'SuperPeerController' of __InstanceModificationEvent settings change on object CCM_SuperPeerClientConfig.SiteSettingsKey=1 for user 'SID'.

Les entrées suivantes sont consignées CAS.log :

SuperPeerController main thread has started.
SuperPeerController has started

Un message d’état de type rubrique 7201 est généré. Les entrées suivantes sont consignées StateMessage.log :

Adding message with TopicType 7201 and TopicId Super Peer is now active to WMI
State message(State ID : 2) with TopicType 7201 and TopicId Super Peer is now active has been recorded for SYSTEM

Modification sur le point de gestion

Le message d’état est mis en forme au format XML, puis envoyé au point de gestion (MP_RelayEndpoint) via CCMMessaging.

Vous verrez l’entrée suivante dans le fichier MP_Relay.log :

Message Body :
<?xml version="1.0" encoding="UTF-16"?>
<Report><ReportHeader><Identification><Machine><ClientInstalled>1</ClientInstalled><ClientType>1</ClientType><ClientID>GUID:xxxx</ClientID><ClientVersion>5.00.9040.1015</ClientVersion><NetBIOSName>TestClient</NetBIOSName><CodePage>437</CodePage><SystemDefaultLCID>1033</SystemDefaultLCID><Priority>1</Priority></Machine></Identification></ReportDetails></ReportHeader><ReportBody><Topic ID="Super Peer is now active" Type="7201" IDType="0" User="" UserSID=""/><State ID="2"Criticality="0"/><StateDetails Type="1"><![CDATA[<ContentList><Content id="CAS00015" version="1" Flag="0"/></ContentList>]]></StateDetails><UserParameters Flags="0" Count="1"><Param>8003</Param></UserParameters></StateMessage></ReportBody></Report>

Lorsque le serveur de site reçoit le message d’état, il appelle la spUpdateSuperPeerStatus procédure stockée pour mettre à jour les tableaux suivants :

Superpeers
SuperPeerContentMap

Configurer les options de groupe de limites pour les téléchargements homologues

Dans la console Configuration Manager, accédez à l’espace de travail Administration, puis sélectionnez Groupes de limites de configuration>de hiérarchie.
Recherchez le groupe de limites qui contient les clients de cache homologue et les sources de cache homologue.
Cliquez avec le bouton droit sur le groupe de limites, puis sélectionnez Propriétés.
Sélectionnez l’onglet Options , puis activez les téléchargements homologues autorisés dans ce paramètre de groupe de limites.

Exemple de scénario

L’exemple suivant est utilisé pour montrer comment fonctionne le cache d’homologue pendant le déploiement de contenu.

Déployer une application sur la source du cache homologue

Lorsqu’une application est déployée et installée sur la source du cache homologue, le service Accès au contenu génère un message d’état de type rubrique 7200. L’entrée suivante est enregistrée StateMessage.log :

State message(State ID : 1) with TopicType 7200 and TopicId Cache add CAS00015.1 has been recorded for SYSTEM

Le message d’état est envoyé au point de gestion via CCMMessaging.

Lorsque le serveur de site reçoit ce message d’état, la table SuperPeerContentMap est mise à jour.

Déployer une application sur le client de cache homologue

Le client télécharge la stratégie de l’application. Pour un déploiement obligatoire , le client envoie une demande au point de gestion pour les emplacements de contenu.

Les entrées suivantes sont consignées LocationServices.log :

ContentLocationRequest : <ContentLocationRequest SchemaVersion="1.00" BGRVersion="1" ClientInOperation="PT0M" ExcludeFileList=""><Package ID="CAS00015" Version="1"
DeploymentFlags="9223372036855313105"/><AssignedSite SiteCode="P01"/><ClientLocationInfo LocationType="SMSPackage" DistributeOnDemand="0" UseAzure="1" AllowWUMU="0" UseInternetDP="0" AllowHTTP="1" AllowSMB="1" AllowMulticast="1" AllowSuperPeer="1" DPTokenAuth="1"><ADSite Name="Default-First-Site-Name"/><Forest Name="Contoso.Com"/><Domain Name="Contoso.Com"/><IPAddresses><IPAddress SubnetAddress="192.X.X.X" Address="192.X.X.X"/></IPAddresses><Adapters><Adapter Name="Ethernet" IfType="6" PhysicalAddressExists="1" DnsSuffix="abc.com" Description="Network Adapter"/></Adapters><BoundaryGroups BoundaryGroupListRetrieveTime="2021-04-03T14:03:16.603" IsOnVPN="0"><BoundaryGroup GroupID="5" GroupGUID="xxxx" GroupFlag="0"/><DOINCServers><DOINCServer DOINCServer="P01.Contoso.Com"/></DOINCServers></BoundaryGroups></ClientLocationInfo></ContentLocationRequest> LocationServices

Note

Étant donné que l’option Autoriser les téléchargements homologues dans cette option de groupe de limites est activée dans le groupe de limites, AllowSuperPeer est défini sur 1 dans la requête. Sinon, AllowSuperPeer est défini sur 0 dans la requête.

Pour utiliser la source de cache d’homologue pour le téléchargement de contenu, activez l’option Autoriser les téléchargements homologues dans cette option de groupe de limites pour chaque groupe de limites qui contient le client.

Le point de gestion répond en retournant la liste des emplacements de contenu. Vous trouverez également la liste dans LocationServices.log :

Calling back with the following distribution points 
Distribution Point='https://TestClient.Contoso.Com:8003/SCCM_BranchCache$/CAS00015', Locality='SUBNETPEER', Version='9040', Capabilities='<Capabilities SchemaVersion="1.0"><Property Name="SSLState" Value="63"/></Capabilities>', Signature='', ForestTrust='TRUE', BlockInfo='0'        
Distribution Point='http://P01.Contoso.com/SMS_DP_SMSPKG$/CAS00015', Locality='SUBNET', Version='9040', Capabilities='<Capabilities SchemaVersion="1.0"><Property Name="SSLState" Value="0"/></Capabilities>', Signature='http://P01.Contoso.Com/SMS_DP_SMSSIG$/CAS00015', ForestTrust='TRUE', BlockInfo='0'        
Distribution Point='https://P01.Contoso.Com/CCMTOKENAUTH_SMS_DP_SMSPKG$/CAS00015', Locality='SUBNET', Version='9040', Capabilities='<Capabilities SchemaVersion="1.0"><Property Name="SSLState" Value="0"/><Property Name="AuthMethod" Value="1024"/></Capabilities>', Signature='https://P01.Contoso.Com/CCMTOKENAUTH_SMS_DP_SMSSIG$/CAS00015', ForestTrust='TRUE', BlockInfo='0'

ContentTransferManager.log affiche également les emplacements de contenu qui incluent la source et les points de distribution du cache homologue :

ContentTransferManager    4324 (0x10e4)    Persisted locations for CTM job {139431E9-B106-49DC-B7A8-543D55110DE6}:
(SUBNETPEER) https://TestClient.Contoso.Com:8003/SCCM_BranchCache$/CAS00015
(SUBNET) http://P01.Contoso.Com/SMS_DP_SMSPKG$/CAS00015
(SUBNET) https://P01.Contoso.Com/CCMTOKENAUTH_SMS_DP_SMSPKG$/CAS00015

Les clients de cache homologue hiérarchisent les sources de cache homologue pour télécharger du contenu. Cette priorité est indiquée dans l’entrée suivante dans DataTransferService.log :

 DTSJob {0C3B06F6-E85D-4C54-9B4F-0B316B33AA5B} created to download from 'https://TestClient.Contoso.Com:8003/SCCM_BranchCache$/CAS00015' to 'C:\windows\ccmcache\1'.