Konfigurieren des Peercaches für Configuration Manager Clients

Artikel
12/05/2023

Gilt für: Microsoft Endpoint Configuration Manager (Current Branch)

Peercache ist eine integrierte Lösung für Microsoft Endpoint Configuration Manager, mit der Clients Inhalte direkt aus ihrem lokalen Cache für andere Clients freigeben können. Es erweitert herkömmliche Lösungen für die Inhaltsbereitstellung, z. B. Verteilungspunkte. Verwenden Sie den Peercache, um die Bereitstellung von Inhalten auf Clients an Remotestandorten zu verwalten. Weitere Informationen finden Sie unter Peercache für Configuration Manager Clients.

Konfigurieren von Peercacheclienteinstellungen

Führen Sie die folgenden Schritte aus, um Clients als Peercachequellen zu aktivieren:

Erstellen Sie in der Configuration Manager-Konsole eine Gerätesammlung. Bestimmen Sie, welche Clients Sie als Peercachequellen aktivieren möchten, und fügen Sie sie der Sammlung hinzu.
Wechseln Sie zum Arbeitsbereich Verwaltung , und wählen Sie dann den Knoten Clienteinstellungen aus.
Wählen Sie Benutzerdefinierte Clientgeräteeinstellungen erstellen aus, geben Sie einen Namen und eine Beschreibung an, und wählen Sie dann die Gruppe Clientcacheeinstellungen aus.
Wählen Sie im Navigationsbereich Clientcacheeinstellungen aus, legen Sie Als Peercachequelle aktivieren auf Ja fest, und geben Sie dann die Ports an.
Wählen Sie OK aus, um die Einstellungen zu speichern.
Stellen Sie diese benutzerdefinierte Clienteinstellung für die Gerätesammlung bereit, die Sie in Schritt 1 erstellt haben.

Sie müssen keine Peercacheclients aktivieren. Wenn Sie Clients als Peercachequellen aktivieren, enthält der Verwaltungspunkt sie in die Liste der Inhaltsspeicherortquellen.

Änderungen an Clients, die als Peercachequellen fungieren

Wenn die Clientcacheeinstellung für die Gerätesammlung bereitgestellt wird, werden die folgenden Änderungen an den Peercachequellen angezeigt:

In der WMI-Klasse instance CCM_SuperPeerClientConfig.SiteSettingsKey=1 unter ROOT\ccm\Policy\Machine\ActualConfig:

Der Wert der CanBeSuperPeer-Eigenschaft wird in True geändert.

Die folgenden Einträge werden CcmExec.log protokolliert:

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

Die folgenden Einträge werden CAS.log protokolliert:

SuperPeerController main thread has started.
SuperPeerController has started

Es wird eine Statusmeldung vom Thementyp 7201 generiert. Die folgenden Einträge werden StateMessage.log protokolliert:

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

Änderung am Verwaltungspunkt

Die Statusmeldung wird als XML formatiert und dann über CCMMessaging an den Verwaltungspunkt (MP_RelayEndpoint) gesendet.

Der folgende Eintrag wird in der datei MP_Relay.log angezeigt:

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>

Wenn der Standortserver die Statusmeldung empfängt, ruft er die spUpdateSuperPeerStatus gespeicherte Prozedur auf, um die folgenden Tabellen zu aktualisieren:

SuperPeers
SuperPeerContentMap

Konfigurieren von Begrenzungsgruppenoptionen für Peerdownloads

Wechseln Sie in der Configuration Manager-Konsole zum Arbeitsbereich Verwaltung, und wählen Sie dann Hierarchiekonfiguration>Begrenzungsgruppen aus.
Suchen Sie die Begrenzungsgruppe, die die Peercacheclients und Peercachequellen enthält.
Klicken Sie mit der rechten Maustaste auf die Begrenzungsgruppe, und wählen Sie dann Eigenschaften aus.
Wählen Sie die Registerkarte Optionen aus, und aktivieren Sie dann die Einstellung Peerdownloads in dieser Begrenzungsgruppe zulassen .

Beispielszenario

Im folgenden Beispiel wird gezeigt, wie der Peercache während der Inhaltsbereitstellung funktioniert.

Bereitstellen einer Anwendung in der Peercachequelle

Wenn eine Anwendung in der Peercachequelle bereitgestellt und installiert wird, generiert der Inhaltszugriffsdienst eine Statusmeldung des Themas 7200. Der folgende Eintrag wird StateMessage.log protokolliert:

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

Die Statusmeldung wird über CCMMessaging an den Verwaltungspunkt gesendet.

Wenn der Standortserver diese Statusmeldung empfängt, wird die SuperPeerContentMap-Tabelle aktualisiert.

Bereitstellen einer Anwendung für den Peercacheclient

Der Client lädt die Richtlinie für die Anwendung herunter. Bei einer erforderlichen Bereitstellung sendet der Client eine Anforderung an den Verwaltungspunkt für Inhaltsspeicherorte.

Die folgenden Einträge werden LocationServices.log protokolliert:

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

Hinweis

Da die Option Peerdownloads in dieser Begrenzungsgruppe zulassen in der Begrenzungsgruppe aktiviert ist, wird AllowSuperPeer in der Anforderung auf 1 festgelegt. Andernfalls wird AllowSuperPeer in der Anforderung auf 0 festgelegt.

Um die Peercachequelle für den Download von Inhalten zu verwenden, aktivieren Sie die Option Peerdownloads in dieser Begrenzungsgruppe zulassen für jede Begrenzungsgruppe, die den Client enthält.

Der Verwaltungspunkt antwortet, indem er die Liste der Inhaltsspeicherorte zurückgibt. Sie finden die Liste auch in 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 zeigt auch die Inhaltsspeicherorte an, die die Peercachequelle und die Verteilungspunkte enthalten:

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

Peercacheclients priorisieren Peercachequellen zum Herunterladen von Inhalten. Diese Rangfolge wird im folgenden Eintrag in DataTransferService.log gezeigt:

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