$siteUrl = "https://tenant.sharepoint.com"

# 必要なアセンブリをロードします
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll";
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll";

# SPO に接続します
$script:context = New-Object Microsoft.SharePoint.Client.ClientContext($siteUrl);

# ユーザー名入力を促します。
Write-Host "Please input user name : "
$username = Read-Host

# パスワード入力を促します。
Write-Host "Please input password : "
$password = Read-Host -AsSecureString

$creds = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($username, $password);
$script:context.Credentials = $creds;

# UserAgent を指定します。
$script:context.add_ExecutingWebRequest({
    param ($source, $eventArgs);
    $request = $eventArgs.WebRequestExecutor.WebRequest;
    $request.UserAgent = "NONISV|Contoso|Application/1.0";
})

function ExecuteQueryWithIncrementalRetry {
    param (
        [parameter(Mandatory = $true)]
        [int]$retryCount
    );

    $DefaultRetryAfterInMs = 120000;
    $RetryAfterHeaderName = "Retry-After";
    $retryAttempts = 0;

    if ($retryCount -le 0) {
        throw "Provide a retry count greater than zero."
    }

    while ($retryAttempts -lt $retryCount) {
        try {
            $script:context.ExecuteQuery();
            return;
        }
        catch [System.Net.WebException] {
            $response = $_.Exception.Response

            if (($null -ne $response) -and (($response.StatusCode -eq 429) -or ($response.StatusCode -eq 503))) {
                $retryAfterHeader = $response.GetResponseHeader($RetryAfterHeaderName);
                $retryAfterInMs = $DefaultRetryAfterInMs;

                if (-not [string]::IsNullOrEmpty($retryAfterHeader)) {
                    if (-not [int]::TryParse($retryAfterHeader, [ref]$retryAfterInMs)) {
                        $retryAfterInMs = $DefaultRetryAfterInMs;
                    }
                    else {
                        $retryAfterInMs *= 1000;
                    }
                }

                Write-Output ("CSOM request exceeded usage limits. Sleeping for {0} seconds before retrying." -F ($retryAfterInMs / 1000))
                #Add delay.
                Start-Sleep -m $retryAfterInMs
                #Add to retry count.
                $retryAttempts++;
            }
            else {
                throw;
            }
        }
    }

    throw "Maximum retry attempts {0}, have been attempted." -F $retryCount;
}

# ここから実装したい任意のコードを書きます。
$web = $script:context.Web
$script:context.Load($web)
#$context.ExecuteQuery() を以下に置き換えます。
ExecuteQueryWithIncrementalRetry -retryCount 5
$web.Title = "RetryTest"
$web.Update()
#$context.ExecuteQuery() を以下に置き換えます。
ExecuteQueryWithIncrementalRetry -retryCount 5

パフォーマンス劣化が生じる要因について

1.     フロントエンドサーバーの増加、キャッシュの廃止

2.     データベースが保持する情報の増加

3.     バックエンドの処理の変更

事前準備

1 : SharePoint Online Client Components SDK のダウンロード

2 : スクリプトの実行ポリシーを変更する

Get-ExecutionPolicy

Set-ExecutionPolicy RemoteSigned

コードの実行

param(
 $siteUrl,
 $listName,
 $username,
 $password,
 $outfile,
 $resume = $false
)

Add-Type -Path "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"
Add-Type -Path "C:\Program Files\Common Files\microsoft shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.WorkflowServices.dll"

function ExecuteQueryWithIncrementalRetry($retryCount, $delay)
{
  $retryAttempts = 0;
  $backoffInterval = $delay;
  if ($retryCount -le 0)
  {
    throw "Provide a retry count greater than zero."
  }
  if ($delay -le 0)
  {
    throw "Provide a delay greater than zero."
  }
  while ($retryAttempts -lt $retryCount)
  {
    try
    {
      $script:context.ExecuteQuery();
      return;
    }
    catch [System.Net.WebException]
    {
      $response = $_.Exception.Response
      if ($response -ne $null -and $response.StatusCode -eq 429)
      {
        Write-Host ("CSOM request exceeded usage limits. Sleeping for {0} seconds before retrying." -F ($backoffInterval/1000))
        #Add delay.
        Start-Sleep -m $backoffInterval
        #Add to retry count and increase delay.
        $retryAttempts++;
        $backoffInterval = $backoffInterval * 2;
      }
      else
      {
        throw;
      }
    }
  }
  throw "Maximum retry attempts {0}, have been attempted." -F $retryCount;
}

function EnumWorkflowsInFolder($list, $ServerRelativeUrl)
{
  do
  {
    $camlQuery = New-Object Microsoft.SharePoint.Client.CamlQuery
    $camlQuery.ListItemCollectionPosition = $position
    $camlQuery.ViewXml = "<View><RowLimit>5000</RowLimit></View>";
    if ($serverRelativeUrl -ne $null)
    {
       $camlQuery.FolderServerRelativeUrl = $ServerRelativeUrl
    }
    $listItems = $list.GetItems($camlQuery);
    $script:context.Load($listItems);
    ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000

    foreach($listItem in $listItems)
    {
      if ($listItem.FileSystemObjectType -eq [Microsoft.SharePoint.Client.FileSystemObjectType]::Folder)
      {
         $script:context.Load($listItem.Folder)
         ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000
         EnumWorkflowsInFolder -List $list -ServerRelativeUrl $listItem.Folder.ServerRelativeUrl
      }

      $wfic = $script:wfis.EnumerateInstancesForListItem($list.Id, $listItem.Id);
      $script:context.Load($wfic);
      ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000
 
      foreach ($wfi in $wfic)
      {
        WriteOut -text (($listItem.Id.ToString()) + "," + (GetWorkflowSubscription -subid $wfi.WorkflowSubscriptionId) + "," + $wfi.Status) -append $true
        if ($resume)
        {
            if ($wfi.Status -eq "Suspended")
            {
                $script:wfis.ResumeWorkflow($wfi)
                ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000
                Write-Output ("Resumed workflow on Item ID = " + $listItem.Id.ToString())
            }
        }
      }
    } 
    $position = $listItems.ListItemCollectionPosition
  }
  while($position -ne $null)
}

function GetWorkflowSubscription($subid)
{
  if ($script:wfsubhash[$subid.ToString()] -eq $null)
  {    
    $sub = $script:wfss.GetSubscription($subid)
    $script:context.Load($sub)
    ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000

    $script:wfsubhash[$subid.ToString()] = $sub.Name
    return $sub.Name
  }
  else
  {
    return $script:wfsubhash[$subid.ToString()]
  }
}

function WriteOut($text, $append)
{
  if ($outfile -eq $null)
  {
    Write-Output $text
  }
  else
  {
    if ($append)
    {
      $text | Out-File $outfile -Append -Encoding UTF8
    }
    else
    {
      $text | Out-File $outfile -Encoding UTF8
    }
  }
}

$script:context = new-object Microsoft.SharePoint.Client.ClientContext($siteUrl)
$pwd = convertto-securestring $password -AsPlainText -Force
$credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($username, $pwd)
$script:context.Credentials = $credentials

$wfsm = new-object Microsoft.SharePoint.Client.WorkflowServices.WorkflowServicesManager($script:context, $script:context.Web)
$script:wfss = $wfsm.GetWorkflowSubscriptionService();
$script:wfsubhash = @{}
$script:wfis = $wfsm.GetWorkflowInstanceService();

$list = $script:context.Web.Lists.GetByTitle($listName)
$script:context.Load($list)
ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000

$wfSubs = $wfss.EnumerateSubscriptionsByList($list.Id);
$script:context.Load($wfSubs);
ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000

WriteOut -text "ItemId,WorkflowName,Status" 
EnumWorkflowsInFolder -List $list -serverRelativeUrl $null

.\getwfstatus.ps1 -siteUrl https://tenant.sharepoint.com/sites/workflowsite -listName ドキュメント -username account@tenant.onmicrosoft.com -password password

• リスト ビューのしきい値と、HTTP 調整対策の内、増分バックオフ リトライに対応しています。
• 大規模なリストに対して、本スクリプトを実行する場合、HTTP 要求数が増える可能性があります。万が一のことを想定し、オフピークの時間帯に実行してください。

• 優先度 A の HTTP 要求は 15:00 のみにブロックされています。
• 優先度 B の HTTP 要求は 15:00 と 18:00 にブロックされています。
• 優先度 C の HTTP 要求は 12:00, 15:00, 18:00 にブロックされています。

HTTP アクセスの優先度付けについて

• ユーザー アクセス (ページ描画などの要求) の方が API よりも優先されます。
• API 実行の場合、HTTP要求の UserAgent 指定によっても優先度が影響されます。
• 調整は例外なくすべての HTTP 要求にかかります。(製品サービス内部の HTTP 要求も含む)

アプリケーション開発者の留意点

1. リトライ処理を組み込む。

HTTP 調整によるブロックを完全に回避する方法はありません。

アプリケーション開発者はブロックされた際に、ユーザーへの混乱を引き起こさないようプログラムを実装する必要があります。

例えば、バッチ処理の場合はリトライなどを組み込み、ブロックを受けても処理がリトライされ、正常に完了するように実装する必要があります。

画面 UI に関する API 処理がブロックされた場合は、リトライは難しいと思われます。その場合は、ユーザーに手動再実行を促すなどにとどまり、予期せぬエラーや深刻なエラーが発生したなどのキャプションを出すことは避けてください。

2. ユーザー エージェントを修飾する。

ユーザー エージェントを修飾することで、調整機能は HTTP 要求の優先度を適切に判断することができます。このことにより、優先度の低い HTTP 要求のみにかけられた一部の調整項目を回避することができます。

なお、ユーザー エージェントを指定することで、データセンター側がアプリケーションの動作を監視・追跡しやすくなります。

3. データ センター側に不用意に負荷をかけるようなコードを書かない。

アプリケーションによる処理を少しでも早く終わらせるため、データセンターに対して極端な並列処理を実施することや、インターバルのないリトライ処理を行うことは推奨されません。

このような実装を行った場合、調整によりブロックされた状態から復旧するまでに、より多くの時間がかかる可能性があります。

なお、増分バックオフを実装しても調整を回避できない場合は、何度も処理をリトライするのは逆効果です。急ぎの場合は、まずは業務時間後や週末などのオフピーク時にスケジューリングの上実行いただくことで調整を回避できる場合があります。

マイクロソフト サポートで対応できること、できないこと

1. HTTP 調整の詳細なアルゴリズムの公開はできません。

Office 365 をとりまく環境には、様々なアプリケーションが存在します。悪意のあるアプリケーションも存在することから、具体的なアルゴリズムの公開は安定稼働やセキュリティに深刻な影響を与える可能性があります。

そのため、このような要求をサポート部門としてお受けし、回答することはできません。

また、実際の設定も様々な運用上の経緯などを経て、データセンターの安定稼働のため更新されていますので固定ではありません。

2. 調整の一部緩和や変更依頼は受け付けておりません。

繰り返しとなりますが、データセンターに予期せぬ高負荷が生じた場合 HTTP 調整はサービス ダウンを防ぐための最も重要な砦となります。

弊社サービスとしては、サービス全体としての安定稼働を最優先事項として掲げているため、いかなる理由があり仮に一部のユーザーのみが恩恵を受けたとしても、サービス全体に危険を及ぼすようなリクエスト (調整の緩和や処理変更) を受けることはできません。

3. データセンターのパフォーマンス イシューによる調整が多発している場合

HTTP 調整は、サービス側の健全性に大きく依存します。サービス全体のパフォーマンスや健全性が低下してマルチ テナントに影響を与える状況に至っている場合、サポート部門としては調整に対して直接対処するのではなく、サービスのパフォーマンスや健全性の問題を解決するよう働きかけることで、HTTP 調整の多発を解決する方向性で対応することが可能です。

参考記事 

ナビゲーション

ページ (Pages) ライブラリ

補足

1. 概念 - 管理ナビゲーションと用語ストアの関連性について

• サイトのナビゲーション設定では、ナビゲーションに使用する用語セットを 1 つ選択します。

サイト ナビゲーションと用語セットの関係性は 1:1 です。用語セットを 1 つのサイトのナビゲーションで使用した場合、他のサイトでは同時に使用できません。画面上で設定しようとするとエラー ダイアログが出る場合がありますし、設定できたとしてもナビゲーション メニューがエラー表示となります。

• サイトのナビゲーションに使用する用語セットを選択した後は、用語ストアを編集する操作の流れとなります。
• 用語ストア配下に存在する用語が各ナビゲーション メニューに相当する形になります。
• 用語ストア内には、テナントとサイト コレクションを 2 種類の範囲が指定できます。ただし、テナントの範囲で用語ストアを編集するためには、用語ストア管理者権限が必要となります。

2. 基礎 - ナビゲーション設定の基本手順について

1) サイトのナビゲーション設定について

[サイトの設定] – [ナビゲーション] をクリックします。最初に、該当サイトで管理ナビゲーションを使用するよう設定します。

発行ポータルをテンプレートとしてサイト コレクションを作成した場合、トップサイトのナビゲーション設定は管理ナビゲーションが既定値になっています。

2) サイトのナビゲーションに使用する用語セットを選択 (または作成) します。

[用語セットの作成] をクリックすると、用語セットが作成され、自動的にサイトのナビゲーションとして選択されます。

また、作成済みの用語セットを選択することも可能です。

3) [用語ストア 管理ツール] にアクセスし、用語セットを編集します。

サイトが使用する用語セットが決まった後は、用語ストアの管理ツールを使用して用語 (ナビゲーション メニュー) を編集していきます。

 3-1) 用語セットの全般設定や使用目的を確認します。

3-2) 用語の作成をクリックして、用語を組み立てていきます。

3-3) 各用語 (ナビゲーション メニュー) に指定するハイパーリンクを指定します。

また、"メニューでの表示" にて、グローバル ナビゲーションや現在のナビゲーションといった表示位置も忘れずに指定します。

3. 応用 - テナント全体の用語セットから、用語をコピーする方法

1) SharePoint 管理センターで用語ストアの管理者を指定します。

 テナントのスコープで用語セットを編集するために必要です。

2) テナント スコープの用語ストアに用語をあらかじめ作っておきます。

補足 : 用語セットの作成・編集時には一番下 (System の下) に表示されており、再表示すると上記のようにアルファベット順に表示されます。

 3) サイトのナビゲーション設定から、用語ストア編集ツールに遷移し、[子用語を含めた用語の固定] メニューを使用します。

再使用の元となる用語を指定します。

下記の通り、テナントで使用していた用語が配下を含めてコピーされました。

4. 補足事項

1. 構造ナビゲーションと比較した際の制限事項

• サイト構造に応じて、自動的にメニューを生成する機能はありません。
• 対象ユーザーに応じてメニューの表示・非表示を切り替えることはできません。
• クリック時に別タブで開くなどの操作は実施できません。

2. 既知のエラーなど

ナビゲーション このサイトに管理ナビゲーション用語セットが不適切に添付されています。 の読み込みでエラーが発生しました (相互関係 ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx)

3. 参考情報

事前準備

1 : SharePoint Online 管理シェルのダウンロード

2 : スクリプトの実行ポリシーを変更する

Get-ExecutionPolicy

Set-ExecutionPolicy RemoteSigned

コードの実行

param(
  $adminurl,
  $username,
  $password, 
  $Disable = $true,
  $Verbose = $false,
  $Force = $false
)

##the first two lines of the script load the CSOM model:
$loadInfo1 = [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client")
$loadInfo2 = [System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SharePoint.Client.Runtime")

function ExecuteQueryWithIncrementalRetry($retryCount, $delay)
{
  $retryAttempts = 0;
  $backoffInterval = $delay;
  if ($retryCount -le 0)
  {
    throw "Provide a retry count greater than zero."
  }
  if ($delay -le 0)
  {
    throw "Provide a delay greater than zero."
  }
  while ($retryAttempts -lt $retryCount)
  {
    try
    {
    $script:context.ExecuteQuery();
    return;
    }
    catch [System.Net.WebException]
    {
      $response = $_.Exception.Response
      if ($response -ne $null -and $response.StatusCode -eq 429)
      {
        Write-Host ("CSOM request exceeded usage limits. Sleeping for {0} seconds before retrying." -F ($backoffInterval/1000))
        #Add delay.
        Start-Sleep -m $backoffInterval
        #Add to retry count and increase delay.
        $retryAttempts++;
        $backoffInterval = $backoffInterval * 2;
      }
      else
      {
        throw;
      }
    }
  }
  throw "Maximum retry attempts {0}, have been attempted." -F $retryCount;
}

$securepwd = ConvertTo-SecureString $password -AsPlainText -Force
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $username, $securepwd
Connect-SPOService -Url $adminurl -Credential $cred
$siteurls = Get-SPOSite | select Url

foreach ($siteurl in $siteurls)
{
  if ($Force)
  {
    try
    {
      $PrevIsAdmin = (Get-SPOUser -Site $siteurl.Url -LoginName $username).IsSiteAdmin
    }
    catch
    {
      $PrevIsAdmin = ($_.Exception.GetType().Name -ne "ServerUnauthorizedAccessException")
    }

    if (!$PrevIsAdmin)
    {
      $tmpuser = Set-SPOUser -Site $siteurl.Url -LoginName $username -IsSiteCollectionAdmin $true
    }
  }

  try
  {
    try
    {
      $script:context = New-Object Microsoft.SharePoint.Client.ClientContext($siteurl.Url)
      $spocred = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($username, $securepwd)
      $script:context.Credentials = $spocred

      if ($Disable)
      {
        $featureguid = new-object System.Guid "80E47777-D21C-46E0-9139-7C7741EB4B54"
        [void]$script:context.Site.Features.Add($featureguid, $true, [Microsoft.SharePoint.Client.FeatureDefinitionScope]::None)
        ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000
      }
      else
      {
        $featureguid = new-object System.Guid "80E47777-D21C-46E0-9139-7C7741EB4B54"
        [void]$script:context.Site.Features.Remove($featureguid, $true);
        ExecuteQueryWithIncrementalRetry -retryCount 5 -delay 30000
      }
      if ($Verbose -eq $true)
      {
        Write-Output ($siteurl.Url + ",OK")
      }
    }
    catch [System.Net.WebException]
    {
      Write-Output ($siteurl.Url + ",NG," + $_)
    }
 }
 finally
 {
   if ($Force -and (!$PrevIsAdmin))
   {
     $tmpuser = Set-SPOUser -Site $siteurl.Url -LoginName $username -IsSiteCollectionAdmin $false
   }
 }
}

.\DisableEdgeMode.ps1 -adminurl https://tenant-admin.sharepoint.com -username accountname -password password

切り戻し

.\DisableEdgeMode.ps1 -adminurl https://tenant-admin.sharepoint.com -username accountname -password password -Disable $false

• SharePoint Online 管理センターの [設定] にて、"クラシック表示のエクスペリエンス" を指定している場合

• リストやライブラリの設定の [詳細設定] にて、クラシック表示または管理センターで指定した既定の動作を継承している場合

• 6 月末に、より多くの IE ブラウザーで Edge モードで描画するように、本設定を考慮しないよう動作変更されました。
• 7 月 4 日、この動作は元の動作に一旦切り戻されました。
• 現在、再度本設定を考慮しないように動作変更されました。

報告されている現象について

1. InfoPath ブラウザー フォームで People Picker のユーザー解決ができなくなる。

• SharePoint 2010 形式ワークフローにおける各種フォーム
• フォーム ライブラリ
• [InfoPath のカスタマイズ] で生成したカスタム フォーム (例. newifs.aspx, editifs.aspx)

2. 最新のパッチが適用されていない IE11 がクラッシュする

•Internet Explorer で SharePoint Online サイトが動作しなくなる問題を修正しました。

3. Office ファイルがクライアントではなく、ブラウザーで開くようになる。

サーバー レンダリングには以下のようなものがあります。

• ビューのスタイルで "既定" 以外 (例. 網掛け) を選択している場合
• Web パーツの設定で、サーバー表示にチェックを入れている場合
• SharePoint Designer で、XSL をカスタマイズしている場合

4. ActiveX オブジェクトを使用しているカスタム ページが動作しなくなる

5. エクスプローラー ビューが表示できなくなる

切り分け手順

回避策