Herramienta lector de configuración del almacén de datos en la nube (readCloudDataSettings.exe)

En este artículo se describe la herramienta lector de configuración del Almacén de datos en la nube, readCloudDataSettings.exe, que se puede usar para capturar datos almacenados en el componente almacén de datos en la nube de Windows en el dispositivo local. Para la configuración documentada en Referencia para la configuración de Windows 11 o Referencia para la configuración de Windows 11 y Windows 10, si la configuración muestra un nombre de tipo en lugar de una clave del Registro, debe usar esta herramienta para recuperar los datos.

Uso

Elementos de instancia única

readCloudDataSettings.exe get -type:<type name> [-account:<secondary account id>]

Elementos de instancias múltiples

readCloudDataSettings.exe enum -type:<type name> [-collection:<collection name>] [-account:<secondary account id>]

Descripciones de parámetros de línea de comandos

Parámetro Descripción
<type name> Nombre de un tipo de Almacén de datos en la nube cuyos datos se van a recuperar (por ejemplo, "windows.data.platform.diagnostics.diagnosticdata")
<collection name> Nombre opcional de una colección para un tipo de instancia múltiple de Cloud Data Store. Debe especificarse si el tipo de instancia múltiple tiene una colección con nombre y no debe especificarse si la colección no tiene ningún nombre o el tipo es de instancia única. Cloud Data Store no admite la enumeración de los datos o nombres de todas las colecciones de un tipo.
<secondary account id> Identificador opcional (en forma de user@domain) de una cuenta secundaria asociada al usuario actual cuyos datos se van a capturar. Debe ser una cuenta secundaria asociada al usuario de Windows que ha iniciado sesión actualmente; no proporciona acceso a los datos de otros usuarios de Windows que podrían compartir el dispositivo.

Errores

Si los datos no existen o se produce un error, la salida notificará un par de corchetes entre los que no hay nada; ejemplo:

[ 
] 

Ejemplos

Tipo de instancia única

Línea de comandos:

C:\Windows\System32>readCloudDataSettings.exe get -type:windows.data.settings.settingsusagehistory

Salida:

/type: windows.data.settings.settingsusagehistory

[
{"Data":{"pageUsages":{"\"SettingsPageAppsNotifications\"":{"Data":{"frequency":1,"lastUsedTime":1.3353819570909629E+17,"lastUsedSettingId":"SystemSettings_Notifications_QuietHours_MuteNotification_Enabled"}},"\"SettingsPageOtherUsers\"":{"Data":{"frequency":1,"lastUsedTime":1.3353709031552022E+17,"lastUsedSettingId":"SystemSettings.UserAccountsHandlers.RemoveOtherUserSetting"}}}}}
]

Tipo de instancia única, cuenta alternativa

Línea de comandos:

C:\Windows\System32>readCloudDataSettings.exe get -type:windows.data.settings.settingsusagehistory -account:otheruser@contoso.com

Salida:

/type: windows.data.settings.settingsusagehistory

[
{"Data":{"pageUsages":{"\"SettingsPageAppsNotifications\"":{"Data":{"frequency":1,"lastUsedTime":1.3353819570909629E+17,"lastUsedSettingId":"SystemSettings_Notifications_QuietHours_MuteNotification_Enabled"}},"\"SettingsPageOtherUsers\"":{"Data":{"frequency":1,"lastUsedTime":1.3353709031552022E+17,"lastUsedSettingId":"SystemSettings.UserAccountsHandlers.RemoveOtherUserSetting"}}}}}
] 

Tipo de instancia múltiple con el nombre de la colección

Línea de comandos:

readclouddatasettings.exe enum -type:windows.data.wifi.wifiprofile -collection:wificloudstore3
 

Salida:

/type: windows.data.wifi.wifiprofile
/collection: wificloudstore3
 
[
    {"Data":{"profileXml":"<?xml version=\"1.0\"?>\r\n<WLANProfile xmlns=\"http://www.microsoft.com/networking/WLAN/profile/v1\">\r\n\t<name>MySpectrumWiFi98-5G</name>\r\n\t<SSIDConfig>\r\n\t\t<SSID>\r\n\t\t\t<hex>4D79537065637472756D5769466939382D3547</hex>\r\n\t\t\t<name>MySpectrumWiFi98-5G</name>\r\n\t\t</SSID>\r\n\t</SSIDConfig>\r\n\t<connectionType>ESS</connectionType>\r\n\t<connectionMode>auto</connectionMode>\r\n\t<MSM>\r\n\t\t<security>\r\n\t\t\t<authEncryption>\r\n\t\t\t\t<authentication>WPA2PSK</authentication>\r\n\t\t\t\t<encryption>AES</encryption>\r\n\t\t\t\t<useOneX>false</useOneX>\r\n\t\t\t</authEncryption>\r\n\t\t\t<sharedKey>\r\n\t\t\t\t<keyType>passPhrase</keyType>\r\n\t\t\t\t<protected>false</protected>\r\n\t\t\t\t<keyMaterial>ancientzebra274</keyMaterial>\r\n\t\t\t</sharedKey>\r\n\t\t</security>\r\n\t</MSM>\r\n\t<MacRandomization xmlns=\"http://www.microsoft.com/networking/WLAN/profile/v3\">\r\n\t\t<enableRandomization>false</enableRandomization>\r\n\t\t<randomizationSeed>1865639973</randomizationSeed>\r\n\t</MacRandomization>\r\n</WLANProfile>\r\n","lastModifiedTime":1.3354054522984058E+17}},
    {"Data":{"profileXml":"<?xml version=\"1.0\"?>\r\n<WLANProfile xmlns=\"http://www.microsoft.com/networking/WLAN/profile/v1\">\r\n\t<name>KIA Service Color</name>\r\n\t<SSIDConfig>\r\n\t\t<SSID>\r\n\t\t\t<hex>4B4941205365727669636520436F6C6F72</hex>\r\n\t\t\t<name>KIA Service Color</name>\r\n\t\t</SSID>\r\n\t</SSIDConfig>\r\n\t<connectionType>ESS</connectionType>\r\n\t<connectionMode>manual</connectionMode>\r\n\t<MSM>\r\n\t\t<security>\r\n\t\t\t<authEncryption>\r\n\t\t\t\t<authentication>WPA2PSK</authentication>\r\n\t\t\t\t<encryption>AES</encryption>\r\n\t\t\t\t<useOneX>false</useOneX>\r\n\t\t\t</authEncryption>\r\n\t\t\t<sharedKey>\r\n\t\t\t\t<keyType>passPhrase</keyType>\r\n\t\t\t\t<protected>false</protected>\r\n\t\t\t\t<keyMaterial>4258270521</keyMaterial>\r\n\t\t\t</sharedKey>\r\n\t\t</security>\r\n\t</MSM>\r\n\t<MacRandomization xmlns=\"http://www.microsoft.com/networking/WLAN/profile/v3\">\r\n\t\t<enableRandomization>false</enableRandomization>\r\n\t\t<randomizationSeed>4088426234</randomizationSeed>\r\n\t</MacRandomization>\r\n</WLANProfile>\r\n","lastModifiedTime":1.3354054522999686E+17}}
]

Nota sobre la serialización

Los datos de las estructuras de configuración de interoperabilidad se serializan a JSON cuando se exportan desde Windows. En algunos casos, esto puede dar lugar a resultados poco intuitivos. Consulte los ejemplos más abajo.

Tipos básicos de datos

Los tipos de datos básicos (entero, punto flotante, cadena, etc.) no tienen ninguna representación especial más allá de la codificación JSON normal.

Estructuras

Todas las estructuras (incluidas las estructuras de nivel superior) se encapsulan en un elemento JSON denominado "Data". Esto incluye estructuras anidadas (incluyendo cuando las estructuras se utilizan en vectores, mapas y valores anulables).

Ejemplo

Esta definición de estructura:

struct MyInnerDataType
{
    0: int32 data;
}

struct MyDataType
{
    0: MyInnerDataType innerData;
    1: int64 id;
}

Se convierte en el siguiente JSON:

{
    "Data":
    {
        "innerData":
        {
            "Data":
            {
                "data": 1
            }
        },
        "id": 2
    }
}

Vectores/Listas

Los vectores y las listas se traducen en matrices JSON estándar (con la advertencia anterior de que una lista de estructuras tiene cada elemento encapsulado en un elemento JSON denominado "Data").

Ejemplo

Esta definición de estructura:

struct MyInnerDataType
{
    0: int32 data;
}

struct MyDataType
{
    0: vector<MyInnerDataType> dataList;
    1: vector<int32> idList;
}

Se convierte en el siguiente JSON:

{
    "Data":
    {
        "dataList":
        [
            {
                "Data":
                {
                    "data": 1
                }
            },
            {
                "Data":
                {
                    "data": 2
                }
            },
        ],
        "idList": [ 1, 2 ]
    }
}

Masa amorfa

Los blobs se traducen en matrices de enteros

Ejemplo

Esta definición de estructura:

Struct mySetting
{
0: blob settingData;
}

Se convierte en el siguiente JSON:

{
    "Data":
    {
        "settingData":[-103,84,-51,60,-88,-121,16,75,-94,21,96,-120,-120,-35,59,85,4,0,0,0,0,1,0,0,36,0,0,0,73,0,110,0,116,0,101,0,114,0,110,0,101,0,116,0,32,0,69,0,120,0,112,0,108,0,111,0,114,0,101,0,114,0,0,0,1,0,0,0,2,0,0,0,7,0,0,0,7,0,0,0,58,0,0,0,104,0,116,0,116,0,112,0,115,0,58,0,47,0,47,0,103,0,108,0,111,0,98,0,97,0,108,0,46,0,115,0,116,0,115,0,46,0,109,0,115,0,102,0,116,0,46,0,110,0,101,0,116,0,47,0,0,0,2,0,0,0,2,0,0,0,7,0,0,0,7,0,0,0,34,0,0,0,109,0,105,0,99,0,114,0,105,0,100,0,101,0,114,0,64,0,103,0,109,0,101,0,46,0,103,0,98,0,108,0,0,0,3,0,0,0,0,0,0,0,7,0,0,0,7,0,0,0,34,0,0,0,110,0,97,0,109,0,105,0,56,0,48,0,114,0,117,0,108,0,101,0,115,0,58,0,68,0,103,0,109,0,101,0,0,0,1,0,0,0,100,0,0,0,0,0,0,0,8,0,0,0,8,0,0,0,16,0,0,0,-43,-74,60,78,86,37,-40,76,-92,-115,-57,85,-57,55,-53,-90,5,0,0,0,0,0,0,0,8,0,0,0,0,0,0,0,1,0,0,0,7,0,0,0,0,0,0,0,2,0,0,0,7,0,0,0,0,0,0,0,3,0,0,0,7,0,0,0,0,0,0,0,4,0,0,0,6,0,0,0,-58,-104,104,-79,72,-95,103,73,-111,113,100,-41,85,-38,-123,32]
    }
}