Вы можете проверить исходный объект, выполнив эту команду````
# Get insight about the schema structure of an object BEFORE changes. Command is only needed to verify columns in schema
Get-ObjectSchemaAsArray -Data $DataVariable -Verbose:$Verbose

4. ClientInspector будет выполняться 10–20 минут и создаст необходимые таблицы и правила сбора данных на основе фактической структуры в вашей среде. Пожалуйста, просмотрите результаты на экране и обратите внимание на любые ошибки (выделены красным).

5. Когда всё выглядит нормально, запустите скрипт повторно — он выполнится намного быстрее. Проверьте поступление данных с помощью запросов Kusto в различных таблицах. ПРИМЕЧАНИЕ: первая загрузка данных может занять примерно 10–15 минут, так как в фоновом режиме необходимо создать конвейер.

6. В качестве последнего изменения нам нужно поменять 2 параметра в parameters, чтобы указать ClientInspector вносить изменения схемы только при запуске с эталонной машины.```js
$AzLogDcrTableCreateFromReferenceMachine    = @("<<MyReferenceMachineComputerName>>")   # sample @("ComputerName")
$AzLogDcrTableCreateFromAnyMachine          = $false    # important so changes can only happen on reference machine

## .\ClientInspector.ps1 -function:PsGallery -scope [AllUsers|CurrentUser]
Этот параметр требует дополнительный параметр: -scope [AllUsers | CurrentUser]

ClientInspector проверит, установлен ли модуль в выбранной области. Если не установлен, он автоматически загрузит последнюю версию из Powershell Gallery и выполнит import-module. Если клиент использует последнюю версию, он продолжит работу.

Пример```
.\ClientInspector.ps1 -verbose:$false -function:PSGallery -scope:CurrentUser

ClientInspector | Inventory of Operational & Security-related information
Developed by Morten Knudsen, Microsoft MVP - for free community use

Powershell module was not found !
Installing in scope currentuser .... Please Wait !

</details>

<br>

## Пример вывода ClientInspector
[Видео 3m 19s — Запуск ClientInspector из командной строки (обычный режим)](https://youtu.be/4kA4BE0zJ9g)  

<br>

# Безопасность
## Подпись кода
Как **файл ClientInspector.ps1**, так и **модуль AzLogDcrIngestPS (AzLogDcrIngest.psm1)** подписаны моим сертификатом подписи кода (2LINKIT — моя компания). Таким образом, вы можете запускать скрипт, если требуются подписанные скрипты. Конечно, вы также можете подписать его своим собственным внутренним сертификатом подписи кода.

![Подписано](https://assets.kitploit.com/production/public/readmes/6097/95ae9fae064341feae5467ba04c909e3bab84393eb7070a304d9d9e6fd184499.png)

Пожалуйста, [скачайте сертификат открытого ключа](https://github.com/KnudsenMorten/ClientInspectorV2/raw/main/Trusted_Publisher_Certificate/2LINKIT-TrustedPublisher.cer) и поместите его в контейнер «доверенный издатель», чтобы доверять издателю (2LINKIT — моя компания). Вы можете развернуть это с помощью Intune или групповой политики.

![Доверенный издатель](https://assets.kitploit.com/production/public/readmes/6097/b02285397783a3495f5d1418ed716fa450b677117dd1754875354779568b0b47.png)  
![Доверенный издатель](https://assets.kitploit.com/production/public/readmes/6097/740ae59eff117b8e59d56a7274440a991b7c5ceddd486894160d0248826084b2.png)  
![Доверенный издатель](https://assets.kitploit.com/production/public/readmes/6097/47d1eb6b7da9ff5a341b8486c7b4bc7532b0b8ef3d05e7b710d495e183929279.png)  

### Развёртывание Intune не требует установки доверенного издателя
По умолчанию Intune выполняет BYPASS при запуске скриптов исправлений.

## Структура
Безопасность **ClientInspector** разделена на 4 слоя: **ввод данных**, **выгрузка данных** (отправка в бэкенд) и **просмотр данных** (панели мониторинга) — а также **управление схемой**.

| Этап | Реализация безопасности |Делегирование / Разрешения|
|:------|:------------------------|:------------------------|
|Ввод данных (сбор)|Этот этап контролируется выбранным методом сбора (Intune, ConfigMg или другое стороннее ПО)|Скрипт должен выполняться с правами локального администратора (контекст системы), чтобы иметь возможность собирать основные данные об оборудовании и Windows|
|Выгрузка данных|Аутентификация для API приема журналов выполняется в DCE, который использует стандартную аутентификацию Azure Resource Manager.<br><br>Обычная стратегия — использовать идентификатор приложения и ключ приложения, что также является методом, используемым в ClientInspector.<br><br>Идентификатор приложения Azure и секрет хранятся в заголовке ClientInspector для простоты.<br><br>Также возможно использовать Azure Keyvault для хранения идентификатора приложения и секрета|[Подробности описаны в ClientInspectV2-DeploymentKit](https://github.com/KnudsenMorten/ClientInspectorV2-DeploymentKit#security-1)|
|Просмотр данных|Разрешения Azure RCAC|Предоставьте доступ к вашему Azure LogAnalytics, Azure Workbooks и Azure Dashboards|
|Управление схемой|Метод 1: Azure RBAC (рекомендуется)<br><br>Метод 2: приложение Azure с секретом или сертификатом|[Подробности описаны в ClientInSpectorV2-DeploymentKit](https://github.com/KnudsenMorten/ClientInspectorV2-DeploymentKit#azure-rbac-security-adjustment-separation-of-permissions-between-log-ingestion-and-tabledcr-management)|

<br>

# Структура набора данных ClientInspector
Каждый набор данных (bios, applications, bitlocker и т. д.) построен по одной и той же 4-фазной структуре:

## Фаза 1/4 - Переменные (именование - куда отправлять данные)```
#-------------------------------------------------------------------------------------------
# Variables
#-------------------------------------------------------------------------------------------
	
$TableName  = 'InvClientComputerInfoSystemV2'   # must not contain _CL
$DcrName    = "dcr-" + $AzDcrPrefixClient + "-" + $TableName + "_CL"

## Этап 3/4 - Обработка данных (обеспечить правильный формат данных, удалить любой 'шум' и добавить релевантную информацию)```
#-------------------------------------------------------------------------------------------
# Preparing data structure
#-------------------------------------------------------------------------------------------

# convert CIM array to PSCustomObject and remove CIM class information
$DataVariable = Convert-CimArrayToObjectFixStructure -data $DataVariable -Verbose:$Verbose

# add CollectionTime to existing array
$DataVariable = Add-CollectionTimeToAllEntriesInArray -Data $DataVariable -Verbose:$Verbose

# add Computer & UserLoggedOn info to existing array
$DataVariable = Add-ColumnDataToAllEntriesInArray -Data $DataVariable -Column1Name Computer -Column1Data $Env:ComputerName  -Column2Name UserLoggedOn -Column2Data $UserLoggedOn

# Validating/fixing schema data structure of source data
$DataVariable = ValidateFix-AzLogAnalyticsTableSchemaColumnNames -Data $DataVariable -Verbose:$Verbose

# Aligning data structure with schema (requirement for DCR)
$DataVariable = Build-DataArrayToAlignWithSchema -Data $DataVariable -Verbose:$Verbose

<br>

**СОВЕТ: ошибка 513 - объект слишком большой**  
По умолчанию ClientInspector отправляет данные пакетами в зависимости от рассчитанного среднего размера каждой записи. Если ваш набор записей имеет другой размер, вы можете получить ошибку 513.

Причина в том, что вы достигаете ограничения в 1 МБ на каждую загрузку (ограничение Azure Pipeline). Microsoft хочет получать много небольших фрагментов данных, поскольку это общая среда. Я сталкивался с этой проблемой при получении списка всех установленных приложений. По-видимому, приложения хранят информацию с очень разной степенью размера.

Вы можете смягчить эту проблему, добавив параметр **-BatchAmount <количество записей для отправки за пакет>** в Post-команду. Если хотите быть уверены, установите его на 1.```
Post-AzLogAnalyticsLogIngestCustomLogDcrDce-Output -DceName $DceName `
                                                   -DcrName $DcrName `
                                                   -Data $DataVariable `
                                                   -TableName $TableName `
                                                   -AzAppId $LogIngestAppId `
                                                   -AzAppSecret $LogIngestAppSecret `
                                                   -TenantId $TenantId `
                                                   -BatchAmount 1 `
                                                   -Verbose:$Verbose `
												   

<br>

# Verbose-mode & Дополнительная справка
Если вы хотите получить более подробную информацию о том, что происходит, вы можете включить подробный режим (-verbose:$true)```
.\ClientInspector.ps1 -verbose:$true -function:localpath

Если вы хотите получить справку по синтаксису и примерам из модуля AzLogDcrLogIngestPS, вы можете написать
get-module```
PS  get-command -module AzLogDcrIngestPS

CommandType     Name                                               Version    Source                                                                         
-----------     ----                                               -------    ------                                                                         
Function        Add-CollectionTimeToAllEntriesInArray              1.1.17     AzLogDcrIngestPS                                                               
Function        Add-ColumnDataToAllEntriesInArray                  1.1.17     AzLogDcrIngestPS                                                               
Function        Build-DataArrayToAlignWithSchema                   1.1.17     AzLogDcrIngestPS                                                               
Function        CheckCreateUpdate-TableDcr-Structure               1.1.17     AzLogDcrIngestPS                                                               
Function        Convert-CimArrayToObjectFixStructure               1.1.17     AzLogDcrIngestPS                                                               
Function        Convert-PSArrayToObjectFixStructure                1.1.17     AzLogDcrIngestPS                                                               
Function        CreateUpdate-AzDataCollectionRuleLogIngestCusto... 1.1.17     AzLogDcrIngestPS                                                               
Function        CreateUpdate-AzLogAnalyticsCustomLogTableDcr       1.1.17     AzLogDcrIngestPS                                                               
Function        Delete-AzDataCollectionRules                       1.1.17     AzLogDcrIngestPS                                                               
Function        Delete-AzLogAnalyticsCustomLogTables               1.1.17     AzLogDcrIngestPS                                                               
Function        Filter-ObjectExcludeProperty                       1.1.17     AzLogDcrIngestPS                                                               
Function        Get-AzAccessTokenManagement                        1.1.17     AzLogDcrIngestPS                                                               
Function        Get-AzDceListAll                                   1.1.17     AzLogDcrIngestPS                                                               
Function        Get-AzDcrDceDetails                                1.1.17     AzLogDcrIngestPS                                                               
Function        Get-AzDataCollectionRuleTransformKql               1.1.17     AzLogDcrIngestPS                                                               
Function        Get-AzDcrListAll                                   1.1.17     AzLogDcrIngestPS                                                               
Function        Get-AzLogAnalyticsTableAzDataCollectionRuleStatus  1.1.17     AzLogDcrIngestPS                                                               
Function        Get-ObjectSchemaAsArray                            1.1.17     AzLogDcrIngestPS                                                               
Function        Get-ObjectSchemaAsHash                             1.1.17     AzLogDcrIngestPS                                                               
Function        Post-AzLogAnalyticsLogIngestCustomLogDcrDce        1.1.17     AzLogDcrIngestPS                                                               
Function        Post-AzLogAnalyticsLogIngestCustomLogDcrDce-Output 1.1.17     AzLogDcrIngestPS                                                               
Function        Update-AzDataCollectionRuleDceEndpoint             1.1.17     AzLogDcrIngestPS                                                               
Function        Update-AzDataCollectionRuleResetTransformKqlDef... 1.1.17     AzLogDcrIngestPS                                                               
Function        Update-AzDataCollectionRuleTransformKql            1.1.17     AzLogDcrIngestPS                                                               
Function        ValidateFix-AzLogAnalyticsTableSchemaColumnNames   1.1.17     AzLogDcrIngestPS                                                               

    Required?                    true
    Position?                    1
    Default value                
    Accept pipeline input?       false
    Accept wildcard characters?  false
    
<CommonParameters>
    This cmdlet supports the common parameters: Verbose, Debug,
    ErrorAction, ErrorVariable, WarningAction, WarningVariable,
    OutBuffer, PipelineVariable, and OutVariable. For more information, see 
    about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). 

-------------------------- EXAMPLE 1 --------------------------

PS C:\>#-------------------------------------------------------------------------------------------

# Variables
#-------------------------------------------------------------------------------------------
$Verbose                   = $true  # $true or $false

#-------------------------------------------------------------------------------------------
# Collecting data (in)
#-------------------------------------------------------------------------------------------
$DNSName                   = (Get-CimInstance win32_computersystem).DNSHostName +"." + (Get-CimInstance win32_computersystem).Domain
$ComputerName              = (Get-CimInstance win32_computersystem).DNSHostName
[datetime]$CollectionTime  = ( Get-date ([datetime]::Now.ToUniversalTime()) -format "yyyy-MM-ddTHH:mm:ssK" )

$UserLoggedOnRaw           = Get-Process -IncludeUserName -Name explorer | Select-Object UserName -Unique
$UserLoggedOn              = $UserLoggedOnRaw.UserName

$DataVariable = Get-CimInstance -ClassName Win32_Processor | Select-Object -ExcludeProperty "CIM*"

#-------------------------------------------------------------------------------------------
# Preparing data structure
#-------------------------------------------------------------------------------------------
$DataVariable = Convert-CimArrayToObjectFixStructure -data $DataVariable -Verbose:$Verbose
$DataVariable

# add CollectionTime to existing array
$DataVariable = Add-CollectionTimeToAllEntriesInArray -Data $DataVariable -Verbose:$Verbose
$DataVariable

#-------------------------------------------------------------------------------------------
# Output
#-------------------------------------------------------------------------------------------

VERBOSE:   Adding CollectionTime to all entries in array .... please wait !
Caption                                 : Intel64 Family 6 Model 165 Stepping 5
Description                             : Intel64 Family 6 Model 165 Stepping 5
InstallDate                             : 
Name                                    : Intel(R) Core(TM) i7-10700 CPU @ 2.90GHz
Status                                  : OK
Availability                            : 3
ConfigManagerErrorCode                  : 
ConfigManagerUserConfig                 : 
CreationClassName                       : Win32_Processor
DeviceID                                : CPU0
ErrorCleared                            : 
ErrorDescription                        : 
LastErrorCode                           : 
PNPDeviceID                             : 
PowerManagementCapabilities             : 
PowerManagementSupported                : False
StatusInfo                              : 3
SystemCreationClassName                 : Win32_ComputerSystem
SystemName                              : STRV-MOK-DT-02
AddressWidth                            : 64
CurrentClockSpeed                       : 2904
DataWidth                               : 64
Family                                  : 198
LoadPercentage                          : 1
MaxClockSpeed                           : 2904
OtherFamilyDescription                  : 
Role                                    : CPU
Stepping                                : 
UniqueId                                : 
UpgradeMethod                           : 1
Architecture                            : 9
AssetTag                                : To Be Filled By O.E.M.
Characteristics                         : 252
CpuStatus                               : 1
CurrentVoltage                          : 8
ExtClock                                : 100
L2CacheSize                             : 2048
L2CacheSpeed                            : 
L3CacheSize                             : 16384
L3CacheSpeed                            : 0
Level                                   : 6
Manufacturer                            : GenuineIntel
NumberOfCores                           : 8
NumberOfEnabledCore                     : 8
NumberOfLogicalProcessors               : 16
PartNumber                              : To Be Filled By O.E.M.
ProcessorId                             : BFEBFBFF000A0655
ProcessorType                           : 3
Revision                                : 
SecondLevelAddressTranslationExtensions : False
SerialNumber                            : To Be Filled By O.E.M.
SocketDesignation                       : U3E1
ThreadCount                             : 16
Version                                 : 
VirtualizationFirmwareEnabled           : False
VMMonitorModeExtensions                 : False
VoltageCaps                             : 
PSComputerName                          : 
CollectionTime                          : 12-03-2023 16:08:33

<br>

# Стоимость – сколько стоит хранение этих данных?
Данные от **500** клиентов, выполняющих **ежедневную** инвентаризацию ClientInspector, обойдутся вам примерно в **200 датских крон в месяц / 27 долларов США в месяц**

<br>

# Обнаружение ошибок, сообщите мне
Сегодня ClientInspectorV1 используется на тысячах компьютеров (а ServerInspectorV1 – на тысячах серверов).

Поскольку ClientInspectorV2 — это полная переработка V1, которая сейчас внедряется с, например, новыми правилами именования, я не могу гарантировать, что ошибок не будет.
Но **я могу вам пообещать**, что исправлю их так быстро, как позволит моё свободное время. Пожалуйста, отправляйте мне письмо на [email protected] с вашими находками.

Рекомендую сделать форк репозитория на GitHub — или следить за обновлениями в панелях мониторинга/книгах или скрипте ClientInspector.

Кроме того, ClientInspector создан для покрытия различных конфигураций и платформ, но у вас могут быть уникальные настройки, не охваченные коллекциями или панелями мониторинга.
Однако открытый подход позволяет вам настроить как панели мониторинга, книги, так и скрипт ClientInspector, чтобы он работал на 100% для вас. Считайте это демонстрацией возможностей для работы с технологиями журналирования Azure — это не платный продукт с круглосуточной поддержкой. Он бесплатен для всех!

<br>

# Контакты
Если у вас есть комментарии к решению — или вы просто хотите связаться со мной, обращайтесь через эти каналы — буду рад знакомству:

[Github](https://github.com/KnudsenMorten)

[Twitter](https://twitter.com/knudsenmortendk)

[Blog](https://mortenknudsen.net/)

[LinkedIn](https://www.linkedin.com/in/mortenwaltorpknudsen/)

[Microsoft MVP profile](https://mvp.microsoft.com/en-us/PublicProfile/5005156?fullName=Morten%20Knudsen)

[Sessionize](https://sessionize.com/mortenknudsen/)

[Mail](mailto:[email protected])

<br>

# Большое спасибо замечательным людям из команд продуктов Microsoft — вы рок-звёзды :smile:
В завершение хочу выразить огромную благодарность нескольким людям, с которыми я работал над созданием модуля PowerShell AzLogDcrIngestPS и в своей повседневной работе с возможностями журналирования и просмотра Azure:

|Имя|Роль|
|:---|:---|
|Ivan Varnitski|Program Manager - Azure Pipeline|
|Evgeny Ternovsky|Program Manager - Azure Pipeline|
|Nick Kiest|Program Manager - Azure Data Collection Rules|
|Oren Salzberg|Program Manager - Azure LogAnalytics|
|Guy Wild|Technical Writer - Azure LogAnalytics|
|John Gardner|Program Manager - Azure Workbooks|
|Shikha Jain|Program Manager - Azure Workbooks|
|Shayoni Seth|Program Manager - Azure Monitor Agent|
|Jeff Wolford|Program Manager - Azure Monitor Agent|
|Xema Pathak|Program Manager - Azure VMInsight (integration to Azure Monitor Agent)|

![MS-friends](https://assets.kitploit.com/production/public/readmes/6097/654c3844cb0324e2b53e04ebfd758652372ae0820636c3c37adc3f18ab178e8e.jpg)