Narzędzie do czytania ustawień magazynu danych w chmurze (readCloudDataSettings.exe)

W tym artykule opisano narzędzie czytelnika ustawień magazynu danych w chmurze, readCloudDataSettings.exe, które może służyć do pobierania danych przechowywanych w składniku magazynu danych w chmurze systemu Windows na urządzeniu lokalnym. W przypadku ustawień opisanych w Referencji ustawień Windows 11 lub Referencji ustawień Windows 11 i Windows 10, jeśli zamiast klucza rejestru ustawienie zawiera nazwę typu, należy użyć tego narzędzia do pozyskania danych.

Zastosowanie

Elementy pojedynczego wystąpienia

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

Elementy z wieloma wystąpieniami

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

Opisy parametrów wiersza polecenia

Parametr Opis
<type name> Nazwa typu magazynu danych w chmurze, którego dane mają zostać pobrane (np. "windows.data.platform.diagnostics.diagnosticdata")
<collection name> Opcjonalna nazwa kolekcji dla wielowystąpieniowego typu repozytorium danych w chmurze. Należy to określić, jeśli typ z wieloma wystąpieniami ma nazwaną kolekcję, i nie należy tego określać, jeśli kolekcja nie ma nazwy lub typ to pojedyncze wystąpienie. Magazyn danych w chmurze nie obsługuje wyliczania danych lub nazw wszystkich kolekcji typu.
<secondary account id> Opcjonalny identyfikator (w postaci user@domain) konta pomocniczego skojarzonego z bieżącym użytkownikiem, którego dane mają zostać pobrane. Musi to być konto pomocnicze skojarzone z aktualnie zalogowanym użytkownikiem systemu Windows; nie zapewnia dostępu do danych innym użytkownikom systemu Windows, którzy mogą udostępniać urządzenie.

Błędy

Jeśli dane są niedostępne lub wystąpi błąd, dane wyjściowe pokażą parę nawiasów kwadratowych z niczym pomiędzy; przykład:

[ 
]

Przykłady

Typ pojedynczego wystąpienia

Wiersz polecenia:

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

Wyjście:

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

Typ pojedynczego wystąpienia, konto alternatywne

Wiersz polecenia:

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

Wyjście:

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

Typ wielu instancji z nazwą kolekcji

Wiersz polecenia:

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

Wyjście:

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

Uwaga dotycząca serializacji

W przypadku ustawień współdziałania struktury danych są serializowane do formatu JSON podczas eksportowania z systemu Windows. W niektórych przypadkach może to spowodować niezamierzone wyniki. Zapoznaj się z poniższymi przykładami.

Podstawowe typy danych

Podstawowe typy danych (liczba całkowita, zmiennoprzecinkowa, ciąg itp.) nie mają specjalnej reprezentacji poza normalnym kodowaniem JSON.

Struktur

Wszystkie struktury (w tym struktury najwyższego poziomu) są opakowane w element JSON o nazwie "Dane". Obejmuje to zagnieżdżone struktury (w tym, gdy struktury są używane w wektorach, mapach i obiektach null)

Przykład

Ta definicja struktury:

struct MyInnerDataType
{
    0: int32 data;
}

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

Staje się następującym kodem JSON:

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

Wektory/listy

Wektory i listy są tłumaczone na standardowe tablice JSON (z zastrzeżeniem powyżej, że lista struktur ma każdy element opakowany w element JSON o nazwie "Data").

Przykład

Ta definicja struktury:

struct MyInnerDataType
{
    0: int32 data;
}

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

Staje się następującym kodem JSON:

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

Blob

Bloby są tłumaczone na tablice liczb całkowitych

Przykład

Ta definicja struktury:

Struct mySetting
{
0: blob settingData;
}

Staje się następującym kodem 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]
    }
}
  • Ostatnia aktualizacja o