PowerShell使用ConvertFrom-JSON创建Microsoft Teams脚本问题咨询

1. ConvertFrom-Json 使用方法 #

ConvertFrom-Json 是PowerShell内置的JSON解析cmdlet，作用是将输入的JSON格式字符串转换为可直接操作的PSCustomObject对象：

• 通常搭配Get-Content读取本地JSON文件，管道传输给ConvertFrom-Json即可完成解析
• JSON中的对象键会自动转为转换后对象的属性，JSON数组会转为PowerShell对象数组
• 你示例中执行$json = Get-Content -Path 配置文件路径 | ConvertFrom-Json后，$json.teams就对应配置里的teams数组，每个数组元素都自带displayName、visibility、users、channels这些属性，可直接读取使用。

2. 管道中$_.DisplayName的生效原理 #

$_是PowerShell的管道当前项变量：

• 当你把一个集合（比如你解析得到的$json.teams数组）通过管道传给ForEach-Object时，PowerShell会遍历集合中的每一个元素
• 每次循环中，$_就指代当前正在被处理的那个元素
• 比如$json.teams | ForEach-Object { $_.displayName }，每次循环时$_就是一个团队配置对象，直接调用$_.displayName就能读取到该团队的名称，PowerShell默认不区分属性名大小写，所以写$_.DisplayName也能正常读取。

3. 修正后的可运行脚本 #

你原脚本存在变量未定义、逻辑块缺花括号、路径写死等问题，修正后代码如下：

function New-MSteam {
    [CmdletBinding()]
    param (
        [Parameter(Position = 0, Mandatory = $true)]
        [string]$TeamsFilePath
    )

    begin {
        # 检查并安装Microsoft Teams模块
        Write-Verbose "正在导入Microsoft Teams模块"
        $Module = Get-Module -Name MicrosoftTeams -ListAvailable
        if ($Module.Count -eq 0) {
            Write-Verbose "正在安装Microsoft Teams模块"
            Install-Module -Name MicrosoftTeams -AllowPrerelease -AllowClobber -Force
        }
        # 连接Teams
        Connect-MicrosoftTeams
    }

    process {
        # 解析JSON配置文件
        $json = Get-Content -Path $TeamsFilePath | ConvertFrom-Json
        
        # 遍历每个团队配置创建团队
        $json.teams | ForEach-Object {
            # 创建新团队
            $NewTeam = New-Team -DisplayName $_.displayName -Visibility $_.visibility
            
            # 给团队添加用户
            $_.users | ForEach-Object {
                Add-TeamUser -User $_.email -Role $_.role -GroupId $NewTeam.GroupId
            }

            # 给团队创建频道
            $_.channels | ForEach-Object {
                New-TeamChannel -DisplayName $_.displayName -MembershipType $_.membershipType -GroupId $NewTeam.GroupId
                # 如果需要给私有频道添加用户，可在此处加对应逻辑
            }
        }            
    }
              
    end {
        Write-Verbose "所有团队创建完成"
    }
}

脚本使用方法 #

执行时直接传入你的JSON配置文件路径即可：
New-MSteam -TeamsFilePath "C:\salest.json" -Verbose

4. 你提供的JSON配置示例可以直接兼容上述脚本，无需修改结构。 #

{
    "teams": [
        {
            "displayName": "IT Team",
            "visibility": "Public",
            "users": [
                {
                    "email": "admin@3q4kz.onmicrosoft.com",
                    "role": "Owner"
                },
                {
                    "email": "AlexW@3q4kz.onmicrosoft.com",
                    "role": "Member"
                },
                {
                    "email": "GradyA@3q4kz.onmicrosoft.com",
                    "role": "Member"
                }
            ],
            "channels": [
                {
                    "displayName": "Systems",
                    "membershipType": "Standard"
                },
                {
                    "displayName": "Dev",
                    "membershipType": "Standard"
                },
                {
                    "displayName": "Suport",
                    "membershipType": "Standard",
                    "users": [
                        {
                            "email": "admin@3q44z.onmicrosoft.com",
                            "role": "Owner"
                        }
                    ]
                }
            ]
        }
    ]
}

内容的提问来源于stack exchange，提问作者Derek