Het hulpprogramma Instellingenlezer voor Cloud Data Store (readCloudDataSettings.exe)

In dit artikel wordt het hulpprogramma Lezer voor cloudgegevensopslag, readCloudDataSettings.exe, beschreven dat kan worden gebruikt om gegevens op te halen die zijn opgeslagen in het Windows Cloud Data Store-onderdeel op het lokale apparaat. Voor instellingen die worden beschreven in Naslaginformatie voor Windows 11-instellingen of Naslaginformatie voor Windows 11- en Windows 10-instellingen, moet u dit hulpprogramma gebruiken om de gegevens op te halen als de instelling een typenaam bevat in plaats van een registersleutel.

Gebruik

Items met een enkele instantie

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

Items met meerdere exemplaren

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

Beschrijvingen van opdrachtregelparameters

Kenmerk Beschrijving
<type name> De naam van een cloudgegevensarchieftype waarvan de gegevens moeten worden opgehaald (bijvoorbeeld 'windows.data.platform.diagnostics.diagnosticdata')
<collection name> De optionele naam van een verzameling voor een Cloud Datastore multi-instance type. Dit moet worden opgegeven als het type met meerdere exemplaren een benoemde verzameling heeft en mag niet worden opgegeven als de verzameling geen naam heeft of als het type een enkel exemplaar is. Cloud Data Store biedt geen ondersteuning voor het inventariseren van de gegevens of namen van alle verzamelingen van een type.
<secondary account id> De optionele id (in de vorm van user@domain) van een secundair account dat is gekoppeld aan de huidige gebruiker waarvan de gegevens moeten worden opgehaald. Dit moet een secundair account zijn dat is gekoppeld aan de momenteel aangemelde Windows-gebruiker; het biedt geen toegang tot gegevens voor andere Windows-gebruikers die het apparaat mogelijk delen.

Fouten

Als de gegevens niet bestaan of als er een fout optreedt, rapporteert de uitvoer een paar vierkante haken met niets ertussen; voorbeeld:

[ 
] 

Voorbeelden

Type enkele instantie

Opdrachtregel:

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

Uitvoer:

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

Type met één instantie, alternatief account

Opdrachtregel:

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

Uitvoer:

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

Meervoudig exemplaartype met verzamelingsnaam

Opdrachtregel:

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

Uitvoer:

/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}}
]

Opmerking over serialisatie

Voor interoperabiliteitsinstellingen worden gegevensstructuren geserialiseerd naar JSON wanneer ze vanuit Windows worden geëxporteerd. In sommige gevallen kan dit leiden tot onbedoelde resultaten. Zie de onderstaande voorbeelden.

Basisgegevenstypen

Basisgegevenstypen (geheel getal, drijvende komma, tekenreeks, enzovoort) hebben geen speciale weergave dan normale JSON-codering.

Structuren

Alle structuren (inclusief structuren op het hoogste niveau) worden verpakt in een JSON-element met de naam 'Gegevens'. Dit omvat geneste structuren (inclusief wanneer structuren worden gebruikt in vectoren, kaarten en nullables)

Voorbeeld

Deze structuurdefinitie:

struct MyInnerDataType
{
    0: int32 data;
}

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

Wordt de volgende JSON:

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

Vectoren/lijsten

Vectoren en lijsten worden omgezet in standaard JSON-matrices (met de kanttekening hierboven dat een lijst met structuren elk element heeft verpakt in een JSON-element met de naam 'Gegevens').

Voorbeeld

Deze structuurdefinitie:

struct MyInnerDataType
{
    0: int32 data;
}

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

Wordt de volgende JSON:

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

Klont

Blobs worden omgezet in matrices met gehele getallen

Voorbeeld

Deze structuurdefinitie:

Struct mySetting
{
0: blob settingData;
}

Wordt de volgende 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]
    }
}