Konfigurieren des Peercaches für Configuration Manager-Clients

Artikel
12/14/2024

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. Sie erweitert herkömmliche Inhaltsbereitstellungslösungen, z. B. Verteilungspunkte. Verwenden Sie den Peercache, um die Bereitstellung von Inhalten an 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 Verwaltungsarbeitsbereich , und wählen Sie dann den Knoten "Clienteinstellungen" aus.
Wählen Sie "Benutzerdefinierte Clientgeräteeinstellungen erstellen", geben Sie einen Namen und eine Beschreibung an, und wählen Sie dann die Gruppe "Clientcacheeinstellungen" aus.
Wählen Sie im Navigationsbereich die Clientcacheeinstellungen aus, legen Sie "Als Peercachequelle aktivieren" auf "Ja" fest, und geben Sie dann die Ports an.
Wählen Sie OK, 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 die Peercachequellen ermöglichen, enthält der Verwaltungspunkt sie in die Liste der Inhaltsspeicherortquellen.

Änderungen an Clients, die als Peercachequellen fungieren

Wenn die Clientcacheeinstellung in der Gerätesammlung bereitgestellt wird, werden die folgenden Änderungen in den Peercachequellen angezeigt:

In der WMI-Klasseninstanz 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 in 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 in CAS.log protokolliert:

SuperPeerController main thread has started.
SuperPeerController has started

Es wird eine Statusmeldung vom Thementyp 7201 generiert. Die folgenden Einträge werden in 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

Ändern des Verwaltungspunkts

Die Statusnachricht 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 Optionen für Begrenzungsgruppen für Peerdownloads

Wechseln Sie in der Configuration Manager-Konsole zum Verwaltungsarbeitsbereich, und wählen Sie dann "Hierarchiekonfigurationsbegrenzungsgruppen>" 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 zulassen" in dieser Gruppeneinstellung .

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 vom Thementyp 7200. Der folgende Eintrag wird in StateMessage.log protokolliert:

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

Die Statusnachricht wird über CCMMessaging an den Verwaltungspunkt gesendet.

Wenn der Websiteserver diese Statusmeldung empfängt, wird die Tabelle "SuperPeerContentMap" aktualisiert.

Bereitstellen einer Anwendung auf dem Peercacheclient

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

Die folgenden Einträge werden in 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

Notiz

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

Um die Peercachequelle zum Herunterladen von Inhalten zu verwenden, aktivieren Sie die Option "Peerdownloads zulassen" in dieser Grenzgruppenoption für jede Grenzgruppe, die den Client enthält.

Der Verwaltungspunkt antwortet, indem die Liste der Inhaltsspeicherorte zurückgegeben wird. 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 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 angezeigt:

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