บทช่วยสอน: สร้างรายงานความจุรายวัน

สร้างเวิร์กโฟลว์และตั้งค่าตัวแปร

ในการเริ่มต้น ในบทช่วยสอนนี้ เราจะใช้เวิร์กโฟลว์ Logic Apps โฟลว์ Power Automate ยังเป็นที่ยอมรับ และกลไกกระบวนการปฏิบัติการอื่นๆ ที่บริษัทของคุณต้องการใช้สำหรับการทำงานอัตโนมัติ การเรียกทั้งหมดเพื่อดึงข้อมูลใช้ RESTful API ดังนั้นเครื่องมือใดๆ ที่รองรับ REST สามารถทำงานร่วมกับบทช่วยสอนนี้ได้

เยี่ยมชมพอร์ทัล Azure และจากนั้น สร้าง Logic App ใหม่และตั้งชื่อ:

หลังจากเสร็จสิ้นการจัดเตรียม ให้แก้ไขเวิร์กโฟลว์โดยใช้ตัวออกแบบและตั้งค่าทริกเกอร์การเกิดขึ้นประจำเพื่อให้ทำงานทุกวัน:

ต่อไปเราจะต้องกำหนดค่าเริ่มต้นของตัวแปรห้าตัว:

• SPN-Id – นี่คือ ClientID หลักบริการของคุณ จะใช้ในภายหลังเพื่อดำเนินการพิสูจน์ตัวตนในบริบทหลักการบริการ ถ้าคุณกำลังใช้บริบทชื่อผู้ใช้/รหัสผ่าน คุณสามารถข้ามตัวแปรนี้
• DBCapacity – นี่คือตัวแปร Float สำหรับความจุฐานข้อมูลที่ใช้เป็นเมกะไบต์
• FileCapacity – นี่คือตัวแปร Float สำหรับความจุไฟล์ที่ใช้เป็นเมกะไบต์
• LogCapacity – นี่คือตัวแปร Float สำหรับความจุบันทึกที่ใช้ไปในหน่วยเมกะไบต์
• SimplifiedEnvironmentArray-Init – นี่คือตัวแปรอาร์เรย์ที่เราเพิ่มคุณสมบัติสภาพแวดล้อมบางอย่างลงไป สิ่งนี้ช่วยลดความซับซ้อนของผลลัพธ์รายงานตาราง HTML สุดท้ายได้อย่างมาก

ขั้นตอนต่อไปคือการตรวจสอบสิทธิ์ด้วย Microsoft Entra และดึงโทเค็นสำหรับการเรียกใช้ Power Platform API หากคุณยังติดตั้ง Microsoft Entra ไม่เสร็จสิ้น ดูที่ การรับรองความถูกต้อง - ดั้งเดิม

ในบทช่วยสอนนี้ เราใช้ key vault เพื่อเก็บค่าความลับของบริการหลัก ด้วยวิธีนี้ ผู้ดูแลระบบ IT สามารถทำให้ค่านี้พร้อมใช้งานอย่างปลอดภัยสำหรับเวิร์กโฟลว์ของคุณ จากนั้นข้อมูลนี้จะถูกเติมไว้ในการเรียก POST เพื่อดึงโทเค็น Microsoft Entra

จากนั้นเราจะแยกวิเคราะห์โทเค็นการตอบสนอง Microsoft Entra ในออบเจ็กต์ที่กำหนดชนิดโดยใช้สคีมา JSON นี้ ในการดำเนินการ 'Parse JSON':

{
    "properties": {
        "access_token": {
            "type": "string"
        },
        "expires_in": {
            "type": "integer"
        },
        "ext_expires_in": {
            "type": "integer"
        },
        "token_type": {
            "type": "string"
        }
    },
    "type": "object"
}

เริ่มต้นตัวแปรและเชื่อมต่อกับ API ของ Power Platform

ใช้สคริปต์ต่อไปนี้เพื่อเริ่มต้นตัวแปรบางตัวที่เราใช้ตลอดบทช่วยสอน หรือ คุณอาจใช้การรับรองความถูกต้องของชื่อผู้ใช้/รหัสผ่าน แต่ไม่แนะนำ

#Install the module
Install-Module -Name Microsoft.PowerApps.Administration.PowerShell

# Set variables for your session
$TenantId = "YOUR_TENANT_GUID_FROM_Microsoft Entra ID"
$SPNId = "YOUR_AZURE_APPLICATION_REGISTRATION_CLIENT_ID"
$ClientSecret = "YOUR_AZURE_APPLICATION_CLIENT_SECRET"
$capacityDetailsList = @()

Write-Host "Creating a session against the Power Platform API"

Add-PowerAppsAccount -Endpoint prod -TenantID $TenantId -ApplicationId $SPNId -ClientSecret $ClientSecret

เรียกจุดสิ้นสุดสภาพแวดล้อมรายการ

ตอนนี้เป็นเวลาเรียกใช้ API ของ Power Platform ใช้รายการสภาพแวดล้อม ตำแหน่งข้อมูล เพื่อดึงข้อมูลสภาพแวดล้อมทั้งหมดของเราและข้อมูลเมตา โดยเฉพาะอย่างยิ่งด้วยพารามิเตอร์ $expand สำหรับความจุ นอกจากนี้ ยังใช้ส่วนหัวของข้อมูลรับรองความถูกต้องพร้อมกับโทเค็นแบบแบเรอร์ที่เราได้รับในส่วนก่อนหน้าจาก Microsoft Entra ID หากคุณใช้บริบทชื่อผู้ใช้/รหัสผ่าน คุณสามารถป้อนโทเค็นผู้ถือในขั้นตอนนี้ได้เช่นกัน

จากนั้นเราจะวิเคราะห์ Power Platform API การตอบ เป็นอ็อบเจ็กต์ที่มีชนิดโดยใช้รูปแบบ JSON นี้ด้วยการดำเนินการ 'แยกวิเคราะห์ JSON':

{
    "properties": {
        "value": {
            "items": {
                "properties": {
                    "description": {
                        "type": "string"
                    },
                    "id": {
                        "type": "string"
                    },
                    "location": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "properties": {
                        "properties": {
                            "addons": {
                                "type": "array"
                            },
                            "azureRegion": {
                                "type": "string"
                            },
                            "capacity": {
                                "items": {
                                    "properties": {
                                        "actualConsumption": {
                                            "type": "number"
                                        },
                                        "capacityType": {
                                            "type": "string"
                                        },
                                        "capacityUnit": {
                                            "type": "string"
                                        },
                                        "ratedConsumption": {
                                            "type": "number"
                                        },
                                        "updatedOn": {
                                            "type": "string"
                                        }
                                    },
                                    "required": [
                                        "capacityType",
                                        "actualConsumption",
                                        "ratedConsumption",
                                        "capacityUnit",
                                        "updatedOn"
                                    ],
                                    "type": "object"
                                },
                                "type": "array"
                            },
                            "clientUris": {
                                "properties": {
                                    "admin": {
                                        "type": "string"
                                    },
                                    "maker": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            },
                            "cluster": {
                                "properties": {
                                    "category": {
                                        "type": "string"
                                    },
                                    "number": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            },
                            "connectedGroups": {
                                "type": "array"
                            },
                            "createdBy": {
                                "properties": {
                                    "displayName": {
                                        "type": "string"
                                    },
                                    "id": {
                                        "type": "string"
                                    },
                                    "type": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            },
                            "createdTime": {
                                "type": "string"
                            },
                            "creationType": {
                                "type": "string"
                            },
                            "databaseType": {
                                "type": "string"
                            },
                            "displayName": {
                                "type": "string"
                            },
                            "environmentSku": {
                                "type": "string"
                            },
                            "isDefault": {
                                "type": "boolean"
                            },
                            "linkedEnvironmentMetadata": {
                                "properties": {
                                    "backgroundOperationsState": {
                                        "type": "string"
                                    },
                                    "baseLanguage": {
                                        "type": "number"
                                    },
                                    "createdTime": {
                                        "type": "string"
                                    },
                                    "domainName": {
                                        "type": "string"
                                    },
                                    "friendlyName": {
                                        "type": "string"
                                    },
                                    "instanceApiUrl": {
                                        "type": "string"
                                    },
                                    "instanceState": {
                                        "type": "string"
                                    },
                                    "instanceUrl": {
                                        "type": "string"
                                    },
                                    "platformSku": {
                                        "type": "string"
                                    },
                                    "resourceId": {
                                        "type": "string"
                                    },
                                    "scaleGroup": {
                                        "type": "string"
                                    },
                                    "uniqueName": {
                                        "type": "string"
                                    },
                                    "version": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            },
                            "protectionStatus": {
                                "properties": {
                                    "keyManagedBy": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            },
                            "provisioningState": {
                                "type": "string"
                            },
                            "retentionDetails": {
                                "properties": {
                                    "backupsAvailableFromDateTime": {
                                        "type": "string"
                                    },
                                    "retentionPeriod": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            },
                            "retentionPeriod": {
                                "type": "string"
                            },
                            "runtimeEndpoints": {
                                "properties": {
                                    "microsoft.ApiManagement": {
                                        "type": "string"
                                    },
                                    "microsoft.BusinessAppPlatform": {
                                        "type": "string"
                                    },
                                    "microsoft.CommonDataModel": {
                                        "type": "string"
                                    },
                                    "microsoft.Flow": {
                                        "type": "string"
                                    },
                                    "microsoft.PowerApps": {
                                        "type": "string"
                                    },
                                    "microsoft.PowerAppsAdvisor": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            },
                            "states": {
                                "properties": {
                                    "management": {
                                        "properties": {
                                            "id": {
                                                "type": "string"
                                            }
                                        },
                                        "type": "object"
                                    },
                                    "runtime": {
                                        "properties": {
                                            "id": {
                                                "type": "string"
                                            }
                                        },
                                        "type": "object"
                                    }
                                },
                                "type": "object"
                            },
                            "updateCadence": {
                                "properties": {
                                    "id": {
                                        "type": "string"
                                    }
                                },
                                "type": "object"
                            }
                        },
                        "type": "object"
                    },
                    "type": {
                        "type": "string"
                    }
                },
                "required": [
                    "id",
                    "type",
                    "location",
                    "name",
                    "properties"
                ],
                "type": "object"
            },
            "type": "array"
        }
    },
    "type": "object"
}

ส่งสถานะความจุ

ใช้สคริปต์ต่อไปนี้เพื่อดึงรายการสภาพแวดล้อมทั้งหมดที่คุณอยู่ใน ผู้ดูแลระบบ การใช้สถานะ "ความจุ" ใหม่ คุณสามารถเพิ่มข้อมูลการใช้ความจุสำหรับแต่ละสภาพแวดล้อมที่ดึงมาได้

#fetch environment list with capacity populated. This is only possible when calling full environment list
$environmentsList = Get-AdminPowerAppEnvironment -Capacity

For-each และการแยกวิเคราะห์

ลองทำตามทีละขั้นตอน ขั้นแรก เราใช้การควบคุม For Each โดยใช้ 'ค่า' ของเอาต์พุต Parse-List-Response:

จากนั้นเราจะแยกวิเคราะห์สภาพแวดล้อมเดียวนี้ลงในอ็อบเจ็กต์ที่มีชนิดโดยใช้รูปแบบ JSON นี้:

{
    "properties": {
        "description": {
            "type": "string"
        },
        "id": {
            "type": "string"
        },
        "location": {
            "type": "string"
        },
        "name": {
            "type": "string"
        },
        "properties": {
            "properties": {
                "addons": {
                    "type": "array"
                },
                "azureRegion": {
                    "type": "string"
                },
                "capacity": {
                    "items": {
                        "properties": {
                            "actualConsumption": {
                                "type": "number"
                            },
                            "capacityType": {
                                "type": "string"
                            },
                            "capacityUnit": {
                                "type": "string"
                            },
                            "ratedConsumption": {
                                "type": "number"
                            },
                            "updatedOn": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "capacityType",
                            "actualConsumption",
                            "ratedConsumption",
                            "capacityUnit",
                            "updatedOn"
                        ],
                        "type": "object"
                    },
                    "type": "array"
                },
                "clientUris": {
                    "properties": {
                        "admin": {
                            "type": "string"
                        },
                        "maker": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                },
                "cluster": {
                    "properties": {
                        "number": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                },
                "connectedGroups": {
                    "type": "array"
                },
                "createdBy": {
                    "properties": {
                        "displayName": {
                            "type": "string"
                        },
                        "id": {
                            "type": "string"
                        },
                        "type": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                },
                "createdTime": {
                    "type": "string"
                },
                "creationType": {
                    "type": "string"
                },
                "databaseType": {
                    "type": "string"
                },
                "displayName": {
                    "type": "string"
                },
                "environmentSku": {
                    "type": "string"
                },
                "isDefault": {
                    "type": "boolean"
                },
                "linkedEnvironmentMetadata": {
                    "properties": {
                        "backgroundOperationsState": {
                            "type": "string"
                        },
                        "baseLanguage": {
                            "type": "integer"
                        },
                        "createdTime": {
                            "type": "string"
                        },
                        "domainName": {
                            "type": "string"
                        },
                        "friendlyName": {
                            "type": "string"
                        },
                        "instanceApiUrl": {
                            "type": "string"
                        },
                        "instanceState": {
                            "type": "string"
                        },
                        "instanceUrl": {
                            "type": "string"
                        },
                        "resourceId": {
                            "type": "string"
                        },
                        "scaleGroup": {
                            "type": "string"
                        },
                        "uniqueName": {
                            "type": "string"
                        },
                        "version": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                },
                "protectionStatus": {
                    "properties": {
                        "keyManagedBy": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                },
                "provisioningState": {
                    "type": "string"
                },
                "retentionDetails": {
                    "properties": {
                        "backupsAvailableFromDateTime": {
                            "type": "string"
                        },
                        "retentionPeriod": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                },
                "retentionPeriod": {
                    "type": "string"
                },
                "runtimeEndpoints": {
                    "properties": {
                        "microsoft.ApiManagement": {
                            "type": "string"
                        },
                        "microsoft.BusinessAppPlatform": {
                            "type": "string"
                        },
                        "microsoft.CommonDataModel": {
                            "type": "string"
                        },
                        "microsoft.Flow": {
                            "type": "string"
                        },
                        "microsoft.PowerApps": {
                            "type": "string"
                        },
                        "microsoft.PowerAppsAdvisor": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                },
                "states": {
                    "properties": {
                        "management": {
                            "properties": {
                                "id": {
                                    "type": "string"
                                }
                            },
                            "type": "object"
                        },
                        "runtime": {
                            "properties": {
                                "id": {
                                    "type": "string"
                                }
                            },
                            "type": "object"
                        }
                    },
                    "type": "object"
                },
                "updateCadence": {
                    "properties": {
                        "id": {
                            "type": "string"
                        }
                    },
                    "type": "object"
                }
            },
            "type": "object"
        },
        "type": {
            "type": "string"
        }
    },
    "type": "object"
}

ถัดไป เราใช้การควบคุม For Each อื่นโดยใช้ 'ความจุ' ของเอาต์พุต Parse-CurrentItem จากนั้นเราจะแยกวิเคราะห์สิ่งนี้เป็นวัตถุที่มีชนิดโดยใช้รูปแบบ JSON นี้:

ตอนนี้เราสามารถใช้การควบคุม Switch บนคุณสมบัติ CapacityType จากผลลัพธ์ Parse-Capacity นี่คือค่าของ 'ฐานข้อมูล' 'ไฟล์' หรือ 'บันทึก' ภายใต้กรณีของสวิตช์แต่ละกรณี บันทึกคุณสมบัติ 'actualConsumption' ที่เกี่ยวข้องลงในตัวแปรที่เกี่ยวข้อง ในกรณีต่อไปนี้ คุณจะเห็นว่าเรากำลังจับความจุของฐานข้อมูล:

ในขั้นตอนสุดท้ายในลูป 'สำหรับแต่ละสภาพแวดล้อม' ตอนนี้เราสามารถบันทึกรายละเอียดสภาพแวดล้อมสำหรับแถวนี้ในรายงานได้ การใช้การควบคุมผนวกเข้ากับตัวแปรอาร์เรย์ ให้ใช้ Schema ของ JSON ต่อไปนี้:

{
    "properties": {
        "actualConsumption": {
            "type": "number"
        },
        "capacityType": {
            "type": "string"
        },
        "capacityUnit": {
            "type": "string"
        },
        "ratedConsumption": {
            "type": "number"
        },
        "updatedOn": {
            "type": "string"
        }
    },
    "type": "object"
}

สร้างอาร์เรย์ความจุโดยละเอียด

สร้าง PSObject ที่มีคุณสมบัติที่เกี่ยวข้องจากแต่ละครั้งที่ผ่านวัตถุสภาพแวดล้อม

foreach($environment in $environmentsList)
{
    Write-Host "Traversing environment " $environment.DisplayName " capacity metadata..."
    #Write-Host $environment
   
    foreach($capacityObject in $environment.Capacity)
    {
        $EnvironmentCapacity = New-Object -TypeName PSObject `
        | Add-Member -PassThru -MemberType NoteProperty -Name EnvironmentName -Value $environment.DisplayName `
        | Add-Member -PassThru -MemberType NoteProperty -Name Description -Value $environment.Description `
        | Add-Member -PassThru -MemberType NoteProperty -Name Type -Value $environment.EnvironmentType `
        | Add-Member -PassThru -MemberType NoteProperty -Name ActualConsumption -Value $capacityObject.actualConsumption `
        | Add-Member -PassThru -MemberType NoteProperty -Name CapacityType -Value $capacityObject.capacityType `
        | Add-Member -PassThru -MemberType NoteProperty -Name CapacityUnit -Value $capacityObject.capacityUnit `
        | Add-Member -PassThru -MemberType NoteProperty -Name UpdatedOn -Value $capacityObject.updatedOn
        
        $capacityDetailsList += $EnvironmentCapacity
    }
    
    Write-Host "==============================="
    
}

ใช้ตัวเชื่อมต่อ HTML ตาราง

โดยการเรียกใช้ Logic App ตอนนี้เราสามารถเห็นผลลัพธ์ของรายงานตาราง HTML:

รายงานอาจถูกส่งทางอีเมลไปยังผู้มีส่วนได้ส่วนเสียในตัวอย่างนี้เพื่อวัตถุประสงค์ในการบัญชีต้นทุน หรืออาจบันทึกข้อมูลลงในฐานข้อมูลเพื่อการวิเคราะห์เพิ่มเติมและแนวโน้มในอดีต

ส่งออกไปยังตาราง

ขอแสดงความยินดี ตอนนี้คุณมาถึงส่วนที่ง่ายแล้ว! ตอนนี้เรามีอาร์เรย์สภาพแวดล้อมที่มีประชากรและเรียบง่ายแล้ว เราสามารถส่งอาร์เรย์ของเราไปยัง Format-Table Commandlet สำหรับเอาต์พุตได้:

$capacityDetailsList | Format-Table -AutoSize