PowerShell を使用して SharePoint Online を管理し始めるには、SharePoint Online 管理シェルをインストールし、SharePoint Online に接続する必要があります。
SharePoint Online 管理シェルをインストールするには SharePoint Online 管理シェルをダウンロードして実行するか、または PowerShell ギャラリーからモジュールをインストールします。 インストールが完了すると、モジュールが使用できるようになり、新しいバージョンの機能が必要になるまでインストールする必要はありません。 たとえば、2018 年 10 月以降に、TLS 1.2 ネゴシエーション用の新しいバージョンをインストールすることが必要になる場合があります。
まず、PowerShell の管理モードで次のコマンドを実行して、SharePoint Online 管理シェルが既にインストールされているかどうかをチェックできます。
Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable | Select Name,Version
オペレーティング システムが Windows PowerShell 5 を使用している場合は、管理モードで次のコマンドを実行して SharePoint Online 管理シェルをインストールすることもできます。
Install-Module -Name Microsoft.Online.SharePoint.PowerShell
システムに対する管理者特権がない場合は、次のコマンドを実行して、現在のユーザーに対してのみ SharePoint Online 管理シェルをインストールできます。
Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser
使用可能なすべてのコマンドレットを確実に使用するには、モジュールが常に最新であることを確認する必要があります。 管理モードで次のコマンドを実行することにより、SharePoint Online 管理シェルを更新できます。
Update-Module -Name Microsoft.Online.SharePoint.PowerShell
SharePoint Online 管理シェルコマンドプロンプトを開くには、[のスタート] 画面で sharepointを入力し、[SharePoint Online 管理シェルをクリックします。
注:
Windows PowerShell 7 コンソールで SharePoint Online PowerShell コマンドを実行するには、-UseWindowsPowerShell パラメーターを使用して SharePoint モジュールをインポートする必要があります。
Import-Module Microsoft.Online.SharePoint.PowerShell -UseWindowsPowerShell
ユーザー名とパスワードを使用して接続する場合
SharePoint Online 管理シェル コマンド プロンプトで次のコマンドを実行します。
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com[Windows PowerShell 資格情報の要求] ダイアログ ボックスに指示に従い、SharePoint 管理者アカウントのパスワードを入力します。
ユーザーに SharePoint 管理者ロールを割り当てるには、「 管理者ロールを割り当て る」または 「PowerShell を使用して管理者ロールを Microsoft 365 ユーザー アカウントに割り当てる」を参照してください。
注:
接続しようとして問題が発生したり、"エラー メッセージ: SharePoint Online に接続できませんでした" などのエラーが表示された場合は、先進認証の使用が必要になる場合があります。 次の例を参照してください。
Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations
多要素認証 (MFA) を使用して接続するには
SharePoint Online 管理シェル コマンド プロンプトで次のコマンドを実行します。
Connect-SPOService -Url https://contoso-admin.sharepoint.com[Microsoft SharePoint Online Management Shell] ダイアログ ボックスが表示されたら、SharePoint 管理者アカウントのアカウント名とパスワードを入力してから、[サインイン] をクリックします。
[Microsoft SharePoint Online Management Shell] ダイアログ ボックスの手順に従って、検証コードなどの他の認証情報を提供してから、[サインイン] をクリックします。
これで SharePoint Online のコマンドを使用できるようになりました。
注:
SharePoint Online 管理シェル モジュールと SharePoint クライアント コンポーネント SDK の間には、両方が同じコンピューターにインストールされている場合、モジュールの読み込みに失敗するという既知の問題があります。 この問題が発生した場合は、SharePoint クライアント コンポーネント SDK をアンインストールしてください。