Connect-SPOService
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 |