Strumento di lettura delle impostazioni di archiviazione dati cloud (readCloudDataSettings.exe)

Questo articolo descrive lo strumento di lettura delle impostazioni dell'archivio dati cloud, readCloudDataSettings.exe, che può essere usato per recuperare i dati archiviati nel componente Archivio dati cloud di Windows nel dispositivo locale. Per le impostazioni documentate in Informazioni di riferimento sulle impostazioni di Windows 11 o Informazioni di riferimento per le impostazioni di Windows 11 e Windows 10, se l'impostazione elenca un nome di tipo anziché una chiave del Registro di sistema, devi usare questo strumento per recuperare i dati.

Uso

Elementi a istanza singola

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

Elementi a istanze multiple

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

Descrizioni dei parametri della riga di comando

Parametro Descrizione
<type name> Nome di un tipo di archivio dati cloud i cui dati devono essere recuperati ,ad esempio "windows.data.platform.diagnostics.diagnosticdata")
<collection name> Nome facoltativo di una raccolta per un tipo di istanza multipla dell'archivio dati cloud. Deve essere specificato se il tipo di istanza multipla dispone di una raccolta denominata e non deve essere specificato se la raccolta non ha alcun nome o se il tipo è a istanza singola. Cloud Data Store non supporta l'enumerazione dei dati o dei nomi di tutte le raccolte di un tipo.
<secondary account id> ID facoltativo (sotto forma di user@domain) di un account secondario associato all'utente corrente i cui dati devono essere recuperati. Deve trattarsi di un account secondario associato all'utente di Windows attualmente connesso; non fornisce l'accesso ai dati per altri utenti di Windows che potrebbero condividere il dispositivo.

Errori

Se i dati non esistono o si verifica un errore, l'output segnala una coppia di parentesi quadre con nulla tra cui; esempio:

[ 
] 

Esempi

Tipo a istanza singola

Riga di comando:

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

Risultato:

/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 a istanza singola, account secondario

Riga di comando:

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

Risultato:

/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 a istanza multipla con nome della raccolta

Riga di comando:

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

Risultato:

/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 sulla serializzazione

Le strutture di dati delle impostazioni di interoperabilità vengono serializzate in JSON quando vengono esportate da Windows. In alcuni casi, questo può comportare risultati poco intuitivi. Vedere gli esempi seguenti.

Tipi di dati di base

I tipi di dati di base (integer, a virgola mobile, stringa e così via) non hanno una rappresentazione speciale oltre la normale codifica JSON.

Strutture

Tutte le strutture (incluse le strutture di primo livello) vengono incluse in un elemento JSON denominato "Data". Sono incluse le strutture nidificate (incluse le strutture usate in vettori, mappe e valori annullabili)

Esempio

Questa definizione di struttura:

struct MyInnerDataType
{
    0: int32 data;
}

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

Diventa il codice JSON seguente:

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

Vettori/Elenchi

I vettori e gli elenchi vengono convertiti in matrici JSON standard (con l'avvertenza precedente che un elenco di strutture include ogni elemento di cui è stato eseguito il wrapping in un elemento JSON denominato "Data").

Esempio

Questa definizione di struttura:

struct MyInnerDataType
{
    0: int32 data;
}

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

Diventa il codice JSON seguente:

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

Blob

I BLOB vengono convertiti in matrici di numeri interi

Esempio

Questa definizione di struttura:

Struct mySetting
{
0: blob settingData;
}

Diventa il codice JSON seguente:

{
    "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]
    }
}