Open in the explorer

Reporting Server

Serveur de rapports

Type
Computer
GPO path
Computer Configuration › Policies › Administrative Templates › System › App-V › Reporting FR: Configuration ordinateur › Stratégies › Modèles d'administration › Système › App-V › Création de rapports
Supported on
At least Windows Server 2008 R2 or Windows 7 FR: Au minimum Windows Server 2008 R2 ou Windows 7
ADMX file
appv.admx
Internal name
appv/Reporting_Server_Policy

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.

French text from Windows 11 26H2

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
StateValue written
EnabledREG_DWORD = 1
DisabledREG_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 4294967295

Disable

# 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 DWord

Revert 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 SilentlyContinue

Options (6)

LabelControlRegistry valueREG typeConstraints / details
Reporting Server URLURL du serveur de rapportsReporting_Server_URL_PromptText boxtextReportingServerURLREG_SZ
Reporting TimePériode de rapportsStart_TimeNumeric boxdecimalReportingStartTimeREG_DWORD
Min: 0 · Max: 23 · Default (UI): 3
Delay reporting for the random minutesReporter les rapports sur les minutes aléatoiresRandom_DelayNumeric boxdecimalReportingRandomDelayREG_DWORD
Min: 0 · Max: 60 · Default (UI): 30
Repeat reporting for every (days)Répéter les rapports tous les (jours)IntervalNumeric boxdecimalReportingIntervalREG_DWORD
Min: 1 · Max: 30 · Default (UI): 1
Data Cache LimitLimite du cache de donnéesData_Cache_LimitNumeric boxdecimalReportingDataCacheLimitREG_DWORD
Min: 1 · Max: 1024 · Default (UI): 20
Data Block SizeTaille de bloc de donnéesData_Block_SizeNumeric boxdecimalReportingDataBlockSizeREG_DWORD
Min: 1024 · Max: 4294967295 · Default (UI): 65536

Availability