Connect-SPOService

モジュール:: Microsoft.Online.SharePoint.PowerShell

適用対象:: SharePoint Online

SharePoint Online 管理者または SharePoint 埋め込み管理者を SharePoint Online 接続 (SharePoint Online 管理センター) に接続します。このコマンドレットは、他の SharePoint Online コマンドレットを実行する前に実行する必要があります。

構文

Connect-SPOService
       [-Url] <UrlCmdletPipeBind>
       [[-Credential] <CredentialCmdletPipeBind>]
       [[-ClientTag] <String>]
       [-AuthenticationUrl] <String>
       [[-ModernAuth] <Boolean>]
       [[-UseSystemBrowser] <Boolean>]
       [<CommonParameters>]

Connect-SPOService
       [-Url] <UrlCmdletPipeBind>
       [[-Credential] <CredentialCmdletPipeBind>]
       [[-ClientTag] <String>]
       [[-Region] <AADCrossTenantAuthenticationLocation>]
       [[-ModernAuth] <Boolean>]
       [[-UseSystemBrowser] <Boolean>]
       [<CommonParameters>]

説明

Connect-SPOService コマンドレットは、SharePoint Online 管理者または SharePoint 埋め込み管理者を SharePoint Online 管理センターに接続します。

単一のWindows PowerShell セッションから保持されるのは、1 つの SharePoint Online サービス接続のみです。つまり、これは、organization管理者接続内の geo 単位です。 Connect-SPOService コマンドレットを 2 回実行すると、以前の接続が暗黙的に切断されます。 Windows PowerShell セッションは、指定された新しい SharePoint Online 管理者にサービスを提供するように設定されます。

委任されたパートナー管理者は、同じWindows PowerShell セッション内の異なる組織の接続を交換する必要があります。

コマンドレットを実行するには、SharePoint Online 管理者または SharePoint Embedded 管理者である必要があります。

SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint Online 管理シェルの概要」を参照してください。

例

-----------------------例 1-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential admin@contoso.com

例 1 は、資格情報 admin@contoso.com を持つ SharePoint Online 管理者が、URL を持つ SharePoint Online 管理センターに接続する方法を示しています <https://contoso-admin.sharepoint.com.>

-----------------------例 2-----------------------------

$username = "admin@contoso.sharepoint.com"
$password = "password"
$cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $(convertto-securestring $Password -asplaintext -force)
Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred

例 2 は、ユーザー名とパスワードを持つ SharePoint Online 管理者が、URL を持つ SharePoint Online 管理センターに接続する方法を示しています <https://contoso-admin.sharepoint.com.>

--------------------'---EXAMPLE 3-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com

資格情報のプロンプト。これは、アカウントが多要素認証を使用している場合に必要です。

-----------------------例 4-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR

リージョンを指定して SharePoint Online 管理センターに接続します。

-----------------------例 5-----------------------------

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

ModernAuth フラグを使用して SPO サービスに接続する。

-----------------------例 6-----------------------------

Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true

Microsoft 認証ライブラリ (MSAL) を使用して認証し、認証が成功したら SharePoint Online 管理センターに接続します。

パラメーター

-AuthenticationUrl

テナント間認証サービスMicrosoft Entra場所。既定以外のテナント間認証サービスを使用する場合は、必要に応じて使用できます。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	SharePoint Online

-ClientTag

既存のクライアントタグにクライアントタグを追加することを許可します。 CSOM http トラフィックで必要に応じて使用され、使用されているスクリプトまたはソリューションを識別します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	SharePoint Online

-Credential

接続に使用する資格情報を指定します。資格情報が指定されていない場合、資格情報を求めるダイアログが表示されます。資格情報は、SharePoint Online 管理センターサイトにアクセスできる SharePoint Online 管理者の資格情報である必要があります。

型:	CredentialCmdletPipeBind
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False
適用対象:	SharePoint Online

-ModernAuth

SharePoint Online テナント管理コマンドレットが最新の TLS プロトコルを使用してサービスに接続できることを確認します。

これを使用するには、 AuthenticationUrl パラメーターも指定する必要があります。

型:	Boolean
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	SharePoint Online

-Region

有効な値は、既定値 |ITAR |ドイツ |中国

既定値は "default" です。

注: ITAR 値は GCC High および DoD テナンシー専用です。

型:	AADCrossTenantAuthenticationLocation
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	SharePoint Online

-Url

SharePoint Online 管理センターサイトの URL を指定します。

型:	UrlCmdletPipeBind
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False
適用対象:	SharePoint Online

-UseSystemBrowser

Microsoft 認証ライブラリ (MSAL) を使用してユーザーを認証するために使用されます。

型:	Boolean
配置:	5
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	SharePoint Online