製品のマルチクラウド、マルチプラットフォーム機能をより適切に伝え、Microsoft Entra 製品ファミリの名前を統合するため、Azure Active Directory (Azure AD) の名前は Microsoft Entra ID に変更されました。
この記事では、新しい製品名とアイコンを使用してドキュメントやコンテンツを更新するお客様や組織のベスト プラクティスとサポートについて説明します。
方法: Azure AD の名前を変更する
前提条件
ドキュメントまたはコンテンツでインスタンスを Azure AD から Microsoft Entra ID に変更する前に、「Azure AD の新しい名前」記事のガイダンスを理解して、次のことを行います。
製品名と変更を行った理由を理解する
新しい製品アイコンをダウンロードする
変更されていない名前の一覧を取得する
よくある質問とその他の質問に対する回答を取得する
コンテンツの更新プログラムの名前変更を評価してスコープを設定する
エクスペリエンスを監査して、Azure AD とそのアイコンへの参照を確認します。
コンテンツをスキャンして、Azure AD とその同義語への参照を識別します。 すべてのインスタンスの詳細な一覧をコンパイルします。
- 次の用語を検索します:
Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、AAD - Azure AD アイコン (
) があるグラフィックスを検索して Microsoft Entra ID アイコン (
) に置き換える
Microsoft Entra ID アイコンは、Microsoft Entra アーキテクチャ アイコンからダウンロードできます
- 次の用語を検索します:
リスト内の例外を特定します。
- 破壊的変更をしないでください。
- 名前付けガイダンスの「変更されない名前」セクションを確認し、どの Azure AD 用語が変更されていないかについて注意してください。
Active Directoryのインスタンスを変更しないでください。Azure Active Directoryの名前だけが変更されており、Active Directoryは変更されません。これは、別の製品である Windows Server Active Directory の短縮名です。
将来の使用状況に基づいて評価し、優先順位を付けます。 どのコンテンツを更新する必要があるかは、ユーザー向けか、組織内、対象ユーザー、お客様ベースで広く認知されているかに基づいて検討します。 エンド ユーザーへの公開が制限されている場合は、一部のコードまたはコンテンツを更新する必要がない場合があります。
ビデオやブログなどの既存の日付付きコンテンツを将来の視聴者のために更新する価値があるかどうかを判断します。 古いコンテンツの名前を変更しなくてもかまいません。 エンドユーザーを支援するために、"Azure AD は ID Microsoft Entra になりました" などの免責事項を追加できます。
テキストベースのコンテンツに "検索と置換" を使用する
関連するツールを使用して、組織のコンテンツとエクスペリエンスを更新します。
ほとんどすべての編集ツールは、ネイティブまたはプラグインを使用して、"検索と置換 (search and replace)" または "検索と置換 (find and replace)" 機能を提供します。任意のアプリを使用します。
[検索と置換] を使って、文字列
Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、AADを検索します。すべてのインスタンスを Microsoft Entra ID に置き換えないでください。
各インスタンスが製品または製品の機能を参照しているかどうかを確認します。
製品名としてのみ使われている Azure AD は、Microsoft Entra ID に置き換える必要があります。
Azure AD の機能が、Microsoft Entra の機能になります。 たとえば、"Azure AD 条件付きアクセス" は、"Microsoft Entra 条件付きアクセス" になります。
カスタム コードを使用して一括編集を自動化する
次の条件を使って、Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、AAD のインスタンスに行う必要がある変更を判断します。
テキスト文字列が前の用語の名前付け辞書で見つかった場合は、新しい用語に変更します。
Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、またはAADの後に句読点がある場合は、それが製品名であるため、Microsoft Entra IDに置き換えます。Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、またはAADの後に、for、Premium、Plan、P1、またはP2が続く場合、それは SKU 名またはサービス プランを示しているため、Microsoft Entra IDに置き換えます。冠詞 (
a、an、the) または所有格 (your、your organization's) が (Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、AAD) の前にある場合は、機能名であるためMicrosoft Entraに置き換えます。 次に例を示します。- "Azure AD テナント" は "Microsoft Entra テナント" になります
- "お客様の組織の Azure AD テナント" は "お客様の Microsoft Entra テナント" になります
Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、またはAADの後に前の手順に含まれない形容詞または名詞が続く場合は、機能名であるためMicrosoft Entraに置き換えます。 たとえば、Azure AD Conditional AccessはMicrosoft Entra Conditional Accessになり、Azure AD tenantはMicrosoft Entra tenantになります。それ以外の場合は、
Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、またはAADをMicrosoft Entra IDに置き換えます。カスタム ロジックをさらに使いやすくするには、「更新された用語の用語集」セクションを参照してください。
グラフィックスとアイコンを更新する
グラフィックスとアイコンを更新するには、次の手順のようにします。
Azure AD アイコンを Microsoft Entra ID アイコンに置き換えます。
Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、またはAADを含むタイトルまたはテキストは、Microsoft Entra IDに置き換えます。
変更をお客様に伝える
顧客の移行を支援するため、更新したコンテンツまたはドキュメントに注を追加することをお勧めします。
最初の 1 年間は、
Azure Active Directory is now Microsoft Entra IDを追加するか、新しい名前の後にformerly Azure Active Directoryを付けます。
PowerShell スクリプトのサンプル
次の PowerShell スクリプトをベースラインとして使って、ドキュメントまたはコンテンツでの Azure AD の参照の名前を変更できます。 このコード サンプルでは次のことを行います。
- 指定されたフォルダーと入れ子になったすべてのフォルダー内で
.resxファイルをスキャンします。 Azure Active Directory (Azure AD)、Azure Active Directory、Azure AD、AADへの参照を Azure AD の新しい名前に従って正しい用語に置き換えることで、ファイルを編集します。
ニーズと更新する必要があるファイルのスコープに従って、ベースライン スクリプトを編集します。 エッジ ケースを考慮し、ソース ファイルでメッセージを定義した方法に従ってスクリプトを変更することが、必要な場合があります。 スクリプトは完全には自動化されません。 スクリプトをそのまま使用する場合は、出力を確認する必要があり、「Azure AD の新しい名前」のガイダンスに従うために追加の調整が必要になることがあります。
# Define the old and new terminology
$terminology = @(
@{ Key = 'Azure AD External Identities'; Value = 'Microsoft Entra External ID' },
@{ Key = 'Azure AD Identity Governance'; Value = 'Microsoft Entra ID Governance' },
@{ Key = 'Azure AD Verifiable Credentials'; Value = 'Microsoft Entra Verified ID' },
@{ Key = 'Azure AD Workload Identities'; Value = 'Microsoft Entra Workload ID' },
@{ Key = 'Azure AD Domain Services'; Value = 'Microsoft Entra Domain Services' },
@{ Key = 'Azure AD access token authentication'; Value = 'Microsoft Entra access token authentication' },
@{ Key = 'Azure AD admin center'; Value = 'Microsoft Entra admin center' },
@{ Key = 'Azure AD portal'; Value = 'Microsoft Entra admin center' },
@{ Key = 'Azure AD application proxy'; Value = 'Microsoft Entra application proxy' },
@{ Key = 'Azure AD authentication'; Value = 'Microsoft Entra authentication' },
@{ Key = 'Azure AD Conditional Access'; Value = 'Microsoft Entra Conditional Access' },
@{ Key = 'Azure AD cloud-only identities'; Value = 'Microsoft Entra cloud-only identities' },
@{ Key = 'Azure AD Connect'; Value = 'Microsoft Entra Connect' },
@{ Key = 'AD Connect'; Value = 'Microsoft Entra Connect' },
@{ Key = 'AD Connect Sync'; Value = 'Microsoft Entra Connect Sync' },
@{ Key = 'Azure AD Connect Sync'; Value = 'Microsoft Entra Connect Sync' },
@{ Key = 'Azure AD domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'Azure AD domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'Azure AD Domain Services'; Value = 'Microsoft Entra Domain Services' },
@{ Key = 'Azure AD Enterprise Applications'; Value = 'Microsoft Entra enterprise applications' },
@{ Key = 'Azure AD federation services'; Value = 'Active Directory Federation Services' },
@{ Key = 'Azure AD hybrid identities'; Value = 'Microsoft Entra hybrid identities' },
@{ Key = 'Azure AD identities'; Value = 'Microsoft Entra identities' },
@{ Key = 'Azure AD role'; Value = 'Microsoft Entra role' },
@{ Key = 'Azure AD'; Value = 'Microsoft Entra ID' },
@{ Key = 'AAD'; Value = 'ME-ID' },
@{ Key = 'Azure AD auth'; Value = 'Microsoft Entra auth' },
@{ Key = 'Azure AD-only auth'; Value = 'Microsoft Entra-only auth' },
@{ Key = 'Azure AD object'; Value = 'Microsoft Entra object' },
@{ Key = 'Azure AD identity'; Value = 'Microsoft Entra identity' },
@{ Key = 'Azure AD schema'; Value = 'Microsoft Entra schema' },
@{ Key = 'Azure AD seamless single sign-on'; Value = 'Microsoft Entra seamless single sign-on' },
@{ Key = 'Azure AD self-service password reset'; Value = 'Microsoft Entra self-service password reset' },
@{ Key = 'Azure AD SSPR'; Value = 'Microsoft Entra SSPR' },
@{ Key = 'Azure AD domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'Azure AD group'; Value = 'Microsoft Entra group' },
@{ Key = 'Azure AD login'; Value = 'Microsoft Entra login' },
@{ Key = 'Azure AD managed'; Value = 'Microsoft Entra managed' },
@{ Key = 'Azure AD managed identities'; Value = 'Managed identities for Azure resources' },
@{ Key = 'Azure AD entitlement'; Value = 'Microsoft Entra entitlement' },
@{ Key = 'Azure AD access review'; Value = 'Microsoft Entra access review' },
@{ Key = 'Azure AD Identity Protection'; Value = 'Microsoft Entra ID Protection' },
@{ Key = 'Azure AD pass-through'; Value = 'Microsoft Entra pass-through' },
@{ Key = 'Azure AD password'; Value = 'Microsoft Entra password' },
@{ Key = 'Azure AD Privileged Identity Management'; Value = 'Microsoft Entra Privileged Identity Management' },
@{ Key = 'Azure AD registered'; Value = 'Microsoft Entra registered' },
@{ Key = 'Azure AD reporting and monitoring'; Value = 'Microsoft Entra reporting and monitoring' },
@{ Key = 'Azure AD enterprise app'; Value = 'Microsoft Entra enterprise app' },
@{ Key = 'Azure AD cloud-only identities'; Value = 'Microsoft Entra cloud-only identities' },
@{ Key = 'Cloud Knox'; Value = 'Microsoft Entra Permissions Management' },
@{ Key = 'Azure AD Premium P1'; Value = 'Microsoft Entra ID P1' },
@{ Key = 'AD Premium P1'; Value = 'Microsoft Entra ID P1' },
@{ Key = 'Azure AD Premium P2'; Value = 'Microsoft Entra ID P2' },
@{ Key = 'AD Premium P2'; Value = 'Microsoft Entra ID P2' },
@{ Key = 'Azure AD F2'; Value = 'Microsoft Entra ID F2' },
@{ Key = 'Azure AD Free'; Value = 'Microsoft Entra ID Free' },
@{ Key = 'Azure AD for education'; Value = 'Microsoft Entra ID for education' },
@{ Key = 'Azure AD work or school account'; Value = 'Microsoft Entra work or school account' },
@{ Key = 'federated with Azure AD'; Value = 'federated with Microsoft Entra' },
@{ Key = 'Hybrid Azure AD Join'; Value = 'Microsoft Entra hybrid join' },
@{ Key = 'Azure Active Directory External Identities'; Value = 'Microsoft Entra External ID' },
@{ Key = 'Azure Active Directory Identity Governance'; Value = 'Microsoft Entra ID Governance' },
@{ Key = 'Azure Active Directory Verifiable Credentials'; Value = 'Microsoft Entra Verified ID' },
@{ Key = 'Azure Active Directory Workload Identities'; Value = 'Microsoft Entra Workload ID' },
@{ Key = 'Azure Active Directory Domain Services'; Value = 'Microsoft Entra Domain Services' },
@{ Key = 'Azure Active Directory access token authentication'; Value = 'Microsoft Entra access token authentication' },
@{ Key = 'Azure Active Directory admin center'; Value = 'Microsoft Entra admin center' },
@{ Key = 'Azure Active Directory portal'; Value = 'Microsoft Entra admin center' },
@{ Key = 'Azure Active Directory application proxy'; Value = 'Microsoft Entra application proxy' },
@{ Key = 'Azure Active Directory authentication'; Value = 'Microsoft Entra authentication' },
@{ Key = 'Azure Active Directory Conditional Access'; Value = 'Microsoft Entra Conditional Access' },
@{ Key = 'Azure Active Directory cloud-only identities'; Value = 'Microsoft Entra cloud-only identities' },
@{ Key = 'Azure Active Directory Connect'; Value = 'Microsoft Entra Connect' },
@{ Key = 'Azure Active Directory Connect Sync'; Value = 'Microsoft Entra Connect Sync' },
@{ Key = 'Azure Active Directory domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'Azure Active Directory domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'Azure Active Directory Domain Services'; Value = 'Microsoft Entra Domain Services' },
@{ Key = 'Azure Active Directory Enterprise Applications'; Value = 'Microsoft Entra enterprise applications' },
@{ Key = 'Azure Active Directory federation services'; Value = 'Active Directory Federation Services' },
@{ Key = 'Azure Active Directory hybrid identities'; Value = 'Microsoft Entra hybrid identities' },
@{ Key = 'Azure Active Directory identities'; Value = 'Microsoft Entra identities' },
@{ Key = 'Azure Active Directory role'; Value = 'Microsoft Entra role' },
@{ Key = 'Azure Active Directory'; Value = 'Microsoft Entra ID' },
@{ Key = 'Azure Active Directory auth'; Value = 'Microsoft Entra auth' },
@{ Key = 'Azure Active Directory-only auth'; Value = 'Microsoft Entra-only auth' },
@{ Key = 'Azure Active Directory object'; Value = 'Microsoft Entra object' },
@{ Key = 'Azure Active Directory identity'; Value = 'Microsoft Entra identity' },
@{ Key = 'Azure Active Directory schema'; Value = 'Microsoft Entra schema' },
@{ Key = 'Azure Active Directory seamless single sign-on'; Value = 'Microsoft Entra seamless single sign-on' },
@{ Key = 'Azure Active Directory self-service password reset'; Value = 'Microsoft Entra self-service password reset' },
@{ Key = 'Azure Active Directory SSPR'; Value = 'Microsoft Entra SSPR' },
@{ Key = 'Azure Active Directory SSPR'; Value = 'Microsoft Entra SSPR' },
@{ Key = 'Azure Active Directory domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'Azure Active Directory group'; Value = 'Microsoft Entra group' },
@{ Key = 'Azure Active Directory login'; Value = 'Microsoft Entra login' },
@{ Key = 'Azure Active Directory managed'; Value = 'Microsoft Entra managed' },
@{ Key = 'Azure Active Directory entitlement'; Value = 'Microsoft Entra entitlement' },
@{ Key = 'Azure Active Directory access review'; Value = 'Microsoft Entra access review' },
@{ Key = 'Azure Active Directory Identity Protection'; Value = 'Microsoft Entra ID Protection' },
@{ Key = 'Azure Active Directory pass-through'; Value = 'Microsoft Entra pass-through' },
@{ Key = 'Azure Active Directory password'; Value = 'Microsoft Entra password' },
@{ Key = 'Azure Active Directory Privileged Identity Management'; Value = 'Microsoft Entra Privileged Identity Management' },
@{ Key = 'Azure Active Directory registered'; Value = 'Microsoft Entra registered' },
@{ Key = 'Azure Active Directory reporting and monitoring'; Value = 'Microsoft Entra reporting and monitoring' },
@{ Key = 'Azure Active Directory enterprise app'; Value = 'Microsoft Entra enterprise app' },
@{ Key = 'Azure Active Directory cloud-only identities'; Value = 'Microsoft Entra cloud-only identities' },
@{ Key = 'Azure Active Directory Premium P1'; Value = 'Microsoft Entra ID P1' },
@{ Key = 'Azure Active Directory Premium P2'; Value = 'Microsoft Entra ID P2' },
@{ Key = 'Azure Active Directory F2'; Value = 'Microsoft Entra ID F2' },
@{ Key = 'Azure Active Directory Free'; Value = 'Microsoft Entra ID Free' },
@{ Key = 'Azure Active Directory for education'; Value = 'Microsoft Entra ID for education' },
@{ Key = 'Azure Active Directory work or school account'; Value = 'Microsoft Entra work or school account' },
@{ Key = 'federated with Azure Active Directory'; Value = 'federated with Microsoft Entra' },
@{ Key = 'Hybrid Azure Active Directory Join'; Value = 'Microsoft Entra hybrid join' },
@{ Key = 'AAD External Identities'; Value = 'Microsoft Entra External ID' },
@{ Key = 'AAD Identity Governance'; Value = 'Microsoft Entra ID Governance' },
@{ Key = 'AAD Verifiable Credentials'; Value = 'Microsoft Entra Verified ID' },
@{ Key = 'AAD Workload Identities'; Value = 'Microsoft Entra Workload ID' },
@{ Key = 'AAD Domain Services'; Value = 'Microsoft Entra Domain Services' },
@{ Key = 'AAD access token authentication'; Value = 'Microsoft Entra access token authentication' },
@{ Key = 'AAD admin center'; Value = 'Microsoft Entra admin center' },
@{ Key = 'AAD portal'; Value = 'Microsoft Entra admin center' },
@{ Key = 'AAD application proxy'; Value = 'Microsoft Entra application proxy' },
@{ Key = 'AAD authentication'; Value = 'Microsoft Entra authentication' },
@{ Key = 'AAD Conditional Access'; Value = 'Microsoft Entra Conditional Access' },
@{ Key = 'AAD cloud-only identities'; Value = 'Microsoft Entra cloud-only identities' },
@{ Key = 'AAD Connect'; Value = 'Microsoft Entra Connect' },
@{ Key = 'AAD Connect Sync'; Value = 'Microsoft Entra Connect Sync' },
@{ Key = 'AAD domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'AAD domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'AAD Domain Services'; Value = 'Microsoft Entra Domain Services' },
@{ Key = 'AAD Enterprise Applications'; Value = 'Microsoft Entra enterprise applications' },
@{ Key = 'AAD federation services'; Value = 'Active Directory Federation Services' },
@{ Key = 'AAD hybrid identities'; Value = 'Microsoft Entra hybrid identities' },
@{ Key = 'AAD identities'; Value = 'Microsoft Entra identities' },
@{ Key = 'AAD role'; Value = 'Microsoft Entra role' },
@{ Key = 'AAD'; Value = 'Microsoft Entra ID' },
@{ Key = 'AAD auth'; Value = 'Microsoft Entra auth' },
@{ Key = 'AAD-only auth'; Value = 'Microsoft Entra-only auth' },
@{ Key = 'AAD object'; Value = 'Microsoft Entra object' },
@{ Key = 'AAD identity'; Value = 'Microsoft Entra identity' },
@{ Key = 'AAD schema'; Value = 'Microsoft Entra schema' },
@{ Key = 'AAD seamless single sign-on'; Value = 'Microsoft Entra seamless single sign-on' },
@{ Key = 'AAD self-service password reset'; Value = 'Microsoft Entra self-service password reset' },
@{ Key = 'AAD SSPR'; Value = 'Microsoft Entra SSPR' },
@{ Key = 'AAD SSPR'; Value = 'Microsoft Entra SSPR' },
@{ Key = 'AAD domain'; Value = 'Microsoft Entra domain' },
@{ Key = 'AAD group'; Value = 'Microsoft Entra group' },
@{ Key = 'AAD login'; Value = 'Microsoft Entra login' },
@{ Key = 'AAD managed'; Value = 'Microsoft Entra managed' },
@{ Key = 'AAD entitlement'; Value = 'Microsoft Entra entitlement' },
@{ Key = 'AAD access review'; Value = 'Microsoft Entra access review' },
@{ Key = 'AAD Identity Protection'; Value = 'Microsoft Entra ID Protection' },
@{ Key = 'AAD pass-through'; Value = 'Microsoft Entra pass-through' },
@{ Key = 'AAD password'; Value = 'Microsoft Entra password' },
@{ Key = 'AAD Privileged Identity Management'; Value = 'Microsoft Entra Privileged Identity Management' },
@{ Key = 'AAD registered'; Value = 'Microsoft Entra registered' },
@{ Key = 'AAD reporting and monitoring'; Value = 'Microsoft Entra reporting and monitoring' },
@{ Key = 'AAD enterprise app'; Value = 'Microsoft Entra enterprise app' },
@{ Key = 'AAD cloud-only identities'; Value = 'Microsoft Entra cloud-only identities' },
@{ Key = 'AAD Premium P1'; Value = 'Microsoft Entra ID P1' },
@{ Key = 'AAD Premium P2'; Value = 'Microsoft Entra ID P2' },
@{ Key = 'AAD F2'; Value = 'Microsoft Entra ID F2' },
@{ Key = 'AAD Free'; Value = 'Microsoft Entra ID Free' },
@{ Key = 'AAD for education'; Value = 'Microsoft Entra ID for education' },
@{ Key = 'AAD work or school account'; Value = 'Microsoft Entra work or school account' },
@{ Key = 'federated with AAD'; Value = 'federated with Microsoft Entra' },
@{ Key = 'Hybrid AAD Join'; Value = 'Microsoft Entra hybrid join' }
)
$postTransforms = @(
@{ Key = 'Microsoft Entra ID B2C'; Value = 'Azure AD B2C' },
@{ Key = 'Microsoft Entra ID B2B'; Value = 'Microsoft Entra B2B' },
@{ Key = 'ME-ID B2C'; Value = 'AAD B2C' },
@{ Key = 'ME-ID B2B'; Value = 'Microsoft Entra B2B' },
@{ Key = 'ME-IDSTS'; Value = 'AADSTS' },
@{ Key = 'ME-ID Connect'; Value = 'Microsoft Entra Connect' }
@{ Key = 'Microsoft Entra ID tenant'; Value = 'Microsoft Entra tenant' }
@{ Key = 'Microsoft Entra ID organization'; Value = 'Microsoft Entra tenant' }
@{ Key = 'Microsoft Entra ID account'; Value = 'Microsoft Entra account' }
@{ Key = 'Microsoft Entra ID resources'; Value = 'Microsoft Entra resources' }
@{ Key = 'Microsoft Entra ID admin'; Value = 'Microsoft Entra admin' }
@{ Key = ' an Microsoft Entra'; Value = ' a Microsoft Entra' }
@{ Key = '>An Microsoft Entra'; Value = '>A Microsoft Entra' }
@{ Key = ' an ME-ID'; Value = ' a ME-ID' }
@{ Key = '>An ME-ID'; Value = '>A ME-ID' }
@{ Key = 'Microsoft Entra ID administration portal'; Value = 'Microsoft Entra administration portal' }
@{ Key = 'Microsoft Entra ID Advanced Threat'; Value = 'Azure Advanced Threat' }
@{ Key = 'Entra ID hybrid join'; Value = 'Entra hybrid join' }
@{ Key = 'Microsoft Entra ID join'; Value = 'Microsoft Entra join' }
@{ Key = 'ME-ID join'; Value = 'Microsoft Entra join' }
@{ Key = 'Microsoft Entra ID service principal'; Value = 'Microsoft Entra service principal' }
@{ Key = 'Download Microsoft Entra Connector'; Value = 'Download connector' }
@{ Key = 'Microsoft Microsoft'; Value = 'Microsoft' }
)
# Sort the replacements by the length of the keys in descending order
$terminology = $terminology.GetEnumerator() | Sort-Object -Property { $_.Key.Length } -Descending
$postTransforms = $postTransforms.GetEnumerator() | Sort-Object -Property { $_.Key.Length } -Descending
# Get all resx files in the current directory and its subdirectories, ignoring .gitignored files.
Write-Host "Getting all resx files in the current directory and its subdirectories, ignoring .gitignored files."
$gitIgnoreFiles = Get-ChildItem -Path . -Filter .gitignore -Recurse
$targetFiles = Get-ChildItem -Path . -Include *.resx -Recurse
$filteredFiles = @()
foreach ($file in $targetFiles) {
$ignoreFile = $gitIgnoreFiles | Where-Object { $_.DirectoryName -eq $file.DirectoryName }
if ($ignoreFile) {
$excludedPatterns = Get-Content $ignoreFile.FullName | Select-String -Pattern '^(?!#).*' | ForEach-Object { $_.Line }
if ($excludedPatterns -notcontains $file.Name) {
$filteredFiles += $file
}
}
else {
$filteredFiles += $file
}
}
$scriptPath = $MyInvocation.MyCommand.Path
$filteredFiles = $filteredFiles | Where-Object { $_.FullName -ne $scriptPath }
# This command will get all the files with the extensions .resx in the current directory and its subdirectories, and then filter out those that match the patterns in the .gitignore file. The Resolve-Path cmdlet will find the full path of the .gitignore file, and the Get-Content cmdlet will read its content as a single string. The -notmatch operator will compare the full name of each file with the .gitignore content using regular expressions, and return only those that do not match.
Write-Host "Found $($filteredFiles.Count) files."
function Update-Terminology {
param (
[Parameter(Mandatory = $true)]
[ref]$Content,
[Parameter(Mandatory = $true)]
[object[]]$Terminology
)
foreach ($item in $Terminology.GetEnumerator()) {
$old = [regex]::Escape($item.Key)
$new = $item.Value
$toReplace = '(?<!(name=\"[^$]{1,100}|https?://aka.ms/[a-z0-9/-]{1,100}))' + $($old)
# Replace the old terminology with the new one
$Content.Value = $Content.Value -replace $toReplace, $new
}
}
# Loop through each file
foreach ($file in $filteredFiles) {
# Read the content of the file
$content = Get-Content $file.FullName
Write-Host "Processing $file"
Update-Terminology -Content ([ref]$content) -Terminology $terminology
Update-Terminology -Content ([ref]$content) -Terminology $postTransforms
$newContent = $content -join "`n"
if ($newContent -ne (Get-Content $file.FullName -Raw)) {
Write-Host "Updating $file"
# Write the updated content back to the file
Set-Content -Path $file.FullName -Value $newContent
}
}