Reporting Server
Serveur de rapports
Explanation
Reporting Server URL: Displays the URL of reporting server.
Reporting Time: When the client data should be reported to the server. Acceptable range is 0~23, corresponding to the 24 hours in a day. A good practice is, don't set this time to a busy hour, e.g. 9AM.
Delay reporting for the random minutes: The maximum minutes of random delay on top of the reporting time. For a busy system, the random delay will help reduce the server load.
Repeat reporting for every (days): The periodical interval in days for sending the reporting data.
Data Cache Limit: This value specifies the maximum size in megabytes (MB) of the XML cache for storing reporting information. The default value is 20 MB. The size applies to the cache in memory. When the limit is reached, the log file will roll over. When a new record is to be added (bottom of the list), one or more of the oldest records (top of the list) will be deleted to make room. A warning will be logged to the Client log and the event log the first time this occurs, and will not be logged again until after the cache has been successfully cleared on transmission and the log has filled up again.
Data Block Size: This value specifies the maximum size in bytes to transmit to the server at once on a reporting upload, to avoid permanent transmission failures when the log has reached a significant size. The default value is 65536. When transmitting report data to the server, one block at a time of application records that is less than or equal to the block size in bytes of XML data will be removed from the cache and sent to the server. Each block will have the general Client data and global package list data prepended, and these will not factor into the block size calculations; the potential exists for an extremely large package list to result in transmission failures over low bandwidth or unreliable connections.
URL du serveur de rapports : affiche l'URL du serveur de rapports.
Heure du rapport : moment auquel les données du client doivent être rapportées au serveur. La plage acceptable est 0~23, ce qui correspond aux 24 heures d'une journée. Il est conseillé de ne pas définir cette heure sur une heure de pointe, par ex. 9 heures.
Retarder les rapports du nombre de minutes aléatoires : nombre de minutes maximum de délai aléatoire en plus du temps de rapport. Pour un système occupé, le délai aléatoire permet de réduire la charge du serveur.
Répéter les rapports pour chaque (jours) : l'intervalle périodique en jours pour envoyer les données de rapport.
Limite du cache de données : cette valeur spécifie la taille maximale en mégaoctets (Mo) du cache XML pour le stockage des informations de rapport. La valeur par défaut est 20 Mo. La taille s'applique au cache en mémoire. Lorsque la limite est atteinte, le fichier journal est substitué. Lorsqu'un nouvel enregistrement doit être ajouté (bas de la liste), un ou plusieurs des plus anciens enregistrements (haut de la liste) sont supprimés pour faire de la place. Un avertissement est journalisé dans le journal Client et dans le journal des événements la première fois que cela se produit et n'est pas de nouveau journalisé tant que le cache n'a pas été correctement effacé lors de la transmission et que le journal n'est pas de nouveau rempli.
Taille de bloc de données : cette valeur spécifie la taille maximale en octets à transmettre au serveur à la fois lors d'un transfert de rapports pour éviter les échecs de transmission permanents lorsque le journal a atteint une taille importante. La valeur par défaut est 65536. Lors de la transmission de données au serveur, un bloc à la fois d'enregistrements d'application qui est inférieur ou égal à la taille de bloc en octets de données XML sera supprimé du cache et envoyé au serveur. Chaque bloc contiendra des données Client générales et des données de liste de package globales ajoutées, et ces données ne seront pas incluses dans les calculs de taille de bloc. Il existe un risque potentiel qu'une liste de packages très importante entraîne des échecs de transmission sur des connexions à faible bande passante ou non fiables.
Registry
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\AppV\Client\Reporting- Value name
ReportingEnabled
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_DWORD = 0 |
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: appv/Reporting_Server_Policy
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\AppV\Client\Reporting'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'ReportingEnabled' -Value 1 -Type DWord
# Reporting Server URL
Set-ItemProperty -Path $k -Name 'ReportingServerURL' -Value '<value>' -Type String
# Reporting Time
Set-ItemProperty -Path $k -Name 'ReportingStartTime' -Value 3 -Type DWord # between 0 and 23
# Delay reporting for the random minutes
Set-ItemProperty -Path $k -Name 'ReportingRandomDelay' -Value 30 -Type DWord # between 0 and 60
# Repeat reporting for every (days)
Set-ItemProperty -Path $k -Name 'ReportingInterval' -Value 1 -Type DWord # between 1 and 30
# Data Cache Limit
Set-ItemProperty -Path $k -Name 'ReportingDataCacheLimit' -Value 20 -Type DWord # between 1 and 1024
# Data Block Size
Set-ItemProperty -Path $k -Name 'ReportingDataBlockSize' -Value 65536 -Type DWord # between 1024 and 4294967295Disable
# Disable: appv/Reporting_Server_Policy
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\AppV\Client\Reporting'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'ReportingEnabled' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": appv/Reporting_Server_Policy
$k = 'HKLM:\SOFTWARE\Policies\Microsoft\AppV\Client\Reporting'
Remove-ItemProperty -Path $k -Name 'ReportingEnabled' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ReportingServerURL' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ReportingStartTime' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ReportingRandomDelay' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ReportingInterval' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ReportingDataCacheLimit' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'ReportingDataBlockSize' -ErrorAction SilentlyContinueOptions (6)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Reporting Server URLURL du serveur de rapportsReporting_Server_URL_Prompt | Text boxtext | ReportingServerURL | REG_SZ | |
| Reporting TimePériode de rapportsStart_Time | Numeric boxdecimal | ReportingStartTime | REG_DWORD | Min: 0 · Max: 23 · Default (UI): 3 |
| Delay reporting for the random minutesReporter les rapports sur les minutes aléatoiresRandom_Delay | Numeric boxdecimal | ReportingRandomDelay | REG_DWORD | Min: 0 · Max: 60 · Default (UI): 30 |
| Repeat reporting for every (days)Répéter les rapports tous les (jours)Interval | Numeric boxdecimal | ReportingInterval | REG_DWORD | Min: 1 · Max: 30 · Default (UI): 1 |
| Data Cache LimitLimite du cache de donnéesData_Cache_Limit | Numeric boxdecimal | ReportingDataCacheLimit | REG_DWORD | Min: 1 · Max: 1024 · Default (UI): 20 |
| Data Block SizeTaille de bloc de donnéesData_Block_Size | Numeric boxdecimal | ReportingDataBlockSize | REG_DWORD | Min: 1024 · Max: 4294967295 · Default (UI): 65536 |