Partilhar via


Ferramenta Cloud Data Store Settings Reader (readCloudDataSettings.exe)

Este artigo descreve a Cloud Data Store Settings Reader Tool, readCloudDataSettings.exe, que pode ser usada para buscar dados armazenados no componente Windows Cloud Data Store no dispositivo local. Para configurações documentadas em Referência para configurações do Windows 11 ou Referência para configurações do Windows 11 e Windows 10, se a configuração listar um nome de tipo em vez de uma chave do Registro, você deverá usar essa ferramenta para recuperar os dados.

Utilização

Itens de instância única

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

Itens de várias instâncias

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

Descrições de parâmetros de linha de comando

Parâmetro Descrição
<type name> O nome de um tipo de armazenamento de dados na nuvem cujos dados devem ser recuperados (por exemplo, "windows.data.platform.diagnostics.diagnosticdata")
<collection name> O nome opcional de uma coleção para um tipo de instância múltipla do Cloud Data Store. Isso deve ser especificado se o tipo de várias instâncias tiver uma coleção nomeada e não deve ser especificado se a coleção não tiver nome ou se o tipo for de instância única. O Cloud Data Store não tem suporte para enumerar os dados ou nomes de todas as coleções de um tipo.
<secondary account id> O id opcional (na forma de user@domain) de uma conta secundária associada ao usuário atual cujos dados devem ser buscados. Esta deve ser uma conta secundária associada ao usuário do Windows conectado no momento; ele não fornece acesso a dados para outros usuários do Windows que possam estar compartilhando o dispositivo.

Erros

Se os dados não existirem ou ocorrer um erro, a saída exibirá um par de colchetes sem nada entre eles; exemplo:

[ 
] 

Exemplos

Tipo de instância única

Linha de comando:

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

Saída:

/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 instância única, conta alternativa

Linha de comando:

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

Saída:

/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 instância múltipla com nome de coleção

Linha de comando:

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

Saída:

/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 serialização

Para configurações de interoperabilidade, as estruturas de dados são serializadas para JSON quando exportadas do Windows. Em alguns casos, isso pode resultar em resultados pouco intuitivos. Veja os exemplos abaixo.

Tipos básicos de dados

Os tipos de dados básicos (inteiro, ponto flutuante, string, etc.) não têm representação especial além da codificação JSON normal.

Estruturas

Todas as estruturas (incluindo estruturas de nível superior) são encapsuladas em um elemento JSON chamado "Data". Isso inclui estruturas aninhadas (inclusive quando estruturas são usadas em vetores, mapas e anuláveis)

Exemplo

Esta definição de estrutura:

struct MyInnerDataType
{
    0: int32 data;
}

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

Torna-se o seguinte JSON:

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

Vetores / Listas

Vetores e listas são traduzidos em matrizes JSON padrão (com a ressalva de cima de que uma lista de estruturas tem cada elemento encapsulado em um elemento JSON chamado "Data").

Exemplo

Esta definição de estrutura:

struct MyInnerDataType
{
    0: int32 data;
}

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

Torna-se o seguinte JSON:

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

Blob

Os blobs são traduzidos em matrizes de inteiros

Exemplo

Esta definição de estrutura:

Struct mySetting
{
0: blob settingData;
}

Torna-se o seguinte 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]
    }
}