Connect-SPOService

  • リファレンス
モジュール:
Microsoft.Online.SharePoint.PowerShell
適用対象:
SharePoint Online

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

構文

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

説明

このコマンドレットは Connect-SPOService 、SharePoint Online 管理者またはグローバル管理者を SharePoint Online 管理センターに接続します。

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

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

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

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.

-----------------------例 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 サービスに接続する。

パラメーター

-AuthenticationUrl

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ClientTag

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Credential

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

Type:CredentialCmdletPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-ModernAuth

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

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

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Region

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

既定値は "default" です。

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

Type:AADCrossTenantAuthenticationLocation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Url

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

Type:UrlCmdletPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online