注意: PowerShell 連携機能を利用するには、ShareGate Migrate の Pro または Enterprise サブスクリプションが必要です。Essentials プランではご利用いただけません。
コマンド
Connect-Site
説明
SharePoint サイトに接続するためのコマンドです。
注意: 2026年1月末より、Microsoft は IDCRL クッキーの廃止を開始しました。そのため、ほとんどの Microsoft 365 テナントでは、パラメーター -Browser および -ModernAuth を使用した Browser および Modern authentication のみが動作します。この変更について詳しくは、Microsoft 365 の「他のユーザー」認証に関する重要な変更をご覧ください。
例
Microsoft 365 で Modern Authentication を使って SharePoint Online サイトに接続する
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth
Microsoft 365 で UserName を指定して Modern Authentication を使い、SharePoint Online サイトに接続する
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -UserName [email protected]
注意: PowerShell ウィンドウでパスワードの入力を求められます。
Microsoft 365 で UserName とパスワードを指定して Modern Authentication を使い、SharePoint Online サイトに接続する
$mypassword = ConvertTo-SecureString "mypassword" -AsPlainText -Force
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -UserName [email protected] -Password $mypassword
現在のユーザー資格情報で SharePoint サイトに接続する
Connect-Site -Url "http://myfarm1/sites/mysitecollection"
ユーザー名を指定して SharePoint サイトに接続する
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Username "myusername"
ユーザー名とパスワードを指定して SharePoint サイトに接続する
$mypassword = ConvertTo-SecureString 'mypassword' -AsPlainText -Force
$mysite = Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Username "myusername" -Password $mypassword
シングル サインオン (SSO) を使わずに SharePoint サイトに接続する
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser -DisableSSO
プロキシ設定を使って SharePoint サイトに接続する
$proxySettings = New-ProxySettings -Server myproxyserver -Port 888
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -ProxySettings $proxySettings
Browser Authentication を使って SharePoint サイトに接続する
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser
注意: foreach ループを使用する際に資格情報の入力を何度も求められないようにするには、以前のブラウザー接続から資格情報を利用する方法をご覧ください。
プロキシ設定を使って Browser Authentication で SharePoint サイトに接続する
$proxySettings = New-ProxySettings -Server myproxyserver -Port 888
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser -ProxySettings $proxySettings
既存の接続資格情報を使って SharePoint サイトに接続する
$connection = Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Browser
Connect-Site -Url "http://myfarm1/sites/anothersitecollection" -UseCredentialsFrom $connection
既存のテナント接続資格情報を使って SharePoint サイトに接続する
$connection = Connect-Tenant -Domain "mytenantdomain" -Browser
Connect-Site -Url "http://mytenantdomain/sites/mysitecollection" -UseCredentialsFrom $connection
ShareGate Migrate Explorer に SharePoint サイトの接続を追加して接続する
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -AddToExplorer
ユーザー名とパスワードの入力プロンプトを使って SharePoint サイトに接続する
$Credentials = Get-Credential
Connect-Site -Url "http://myfarm1/sites/mysitecollection" -Credential $Credentials
注意: Get-Credential は Microsoft PowerShell のコマンドです。スクリプト内で使用すると、資格情報を入力して変数に保存するためのプロンプトがワークステーション上に表示されます。
保存済みの SharePoint 接続を使って SharePoint に接続する
$connection = Get-SharePointConnection -Id 01c0ebab-a17e-4ae3-9caf-ba09f05f2970
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -UseConnection $connection
SharePoint に接続し、SharePoint 接続を保存する
$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -SaveConnection
構文
Connect-Site
-Url <String>
[-AllowConnectionFallback <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-Credential <PSCredential>
[-AllowConnectionFallback <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-UserName <String>
-Password <SecureString>
[-AllowConnectionFallback <SwitchParameter>]
[-ModernAuth <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-UseCredentialsFrom <ConnectionEntity>
[-AllowConnectionFallback <SwitchParameter>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-Browser <SwitchParameter>
[-AllowConnectionFallback <SwitchParameter>]
[-DisableSSO <SwitchParameter>]
[-ProxySettings <ProxySettings>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-ModernAuth <SwitchParameter>
[-AllowConnectionFallback <SwitchParameter>]
[-AddToExplorer <SwitchParameter>]
[-SaveConnection <SwitchParameter>]
Connect-Site
-Url <String>
-UseConnection <SharePointConnection>
[-AllowConnectionFallback <SwitchParameter>]
[-AddToExplorer <SwitchParameter>]
Connect-Site
-Url <String>
-AzureApplication <AzureApplication>
[-AllowConnectionFallback <SwitchParameter>]
[-TenantId <String>]
[-AllowMissingPermissions <SwitchParameter>]
パラメーター
-AddToExplorer <SwitchParameter>
この接続を ShareGate Explorer に追加します。
必須かどうか | False |
既定値 | なし |
パイプライン入力を許可? | False |
ワイルドカード文字を許可? | False |
パラメーターセット名 | (すべて) |
エイリアス | なし |
-AllowConnectionFallback <SwitchParameter>
指定した URL に接続できない場合、ShareGate が階層をさかのぼって接続オプションを探すことを許可します。
必須かどうか | False |
既定値 | なし |
パイプライン入力を許可? | False |
ワイルドカード文字を許可? | False |
パラメーターセット名 | (すべて) |
エイリアス | なし |
-AllowMissingPermissions <SwitchParameter>
Azure アプリケーションに SharePoint、グループ、Teams、Planner で通常必要な権限が 1 つ以上不足している場合でも接続を継続します。不足している権限の一覧が警告として表示されます。
必須かどうか | False |
既定値 | なし |
パイプライン入力を許可? | False |
ワイルドカード文字を許可? | False |
パラメーターセット名 | UseCredentialsFrom, AzureApplication |
エイリアス | なし |
-AzureApplication <AzureApplication>
認証に使用する Azure アプリケーションを指定します。New-AzureApplication で作成してください。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可？ | True (ByValue) |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | AzureApplication |
エイリアス | None |
-Browser <SwitchParameter>
ブラウザー認証を使用します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | Browser |
エイリアス | None |
-Credential <PSCredential>
資格情報を指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可？ | True (ByValue, ByPropertyName) |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | Credential |
エイリアス | None |
-DisableSSO <SwitchParameter>
自動ログイン機能を無効にし、別のユーザー アカウントでMicrosoft 365 サイトに接続できるようにします。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | Browser |
エイリアス | None |
-ModernAuth <SwitchParameter>
モダン認証を使用します。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | ModernManualAuth, ModernAuth |
エイリアス | None |
注: 現時点では、-ModernAuth は SharePoint サイトおよび OneDrive for Business への接続時のみ動作します。他の Microsoft 365 サービス（Teams や Exchange メールボックスなど）に接続する場合は、-Browser を使用してください。
-Password <SecureString>
パスワードを指定します。コマンドに文字列をそのまま渡すには、シングルクォーテーション（'）で囲んでください。
必須かどうか | True |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | Manual |
エイリアス | None |
-ProxySettings <ProxySettings>
プロキシ設定を設定して、SharePoint サイトに接続します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可？ | True (ByValue, ByPropertyName) |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | Default, Credential, Manual, Browser |
エイリアス | None |
-SaveConnection <SwitchParameter>
接続後、Connection Manager に接続を保存します。
必須かどうか | False |
既定値 | None |
パイプライン入力を許可？ | False |
ワイルドカード文字を許可？ | False |
パラメーターセット名 | Default, Credential, Manual, UseCredentialsFrom, Browser, ModernAuth |
エイリアス | None |
-TenantId <String>
接続に使用するテナント ID を指定します。
必須かどうか | False |
既定値 | None |
パイプライン入力を受け付けるか？ | False |
ワイルドカード文字を受け付けるか？ | False |
パラメーターセット名 | AzureApplication |
エイリアス | None |
-Url <String>
SharePoint サイトの URL を設定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を受け付けるか？ | False |
ワイルドカード文字を受け付けるか？ | False |
パラメーターセット名 | (All) |
エイリアス | None |
-UseConnection <SharePointConnection>
認証に使用する保存済みの SharePoint 接続を指定します。Get-SharePointConnection で取得できます。
必須かどうか | True |
既定値 | None |
パイプライン入力を受け付けるか？ | False |
ワイルドカード文字を受け付けるか？ | False |
パラメーターセット名 | UseConnection |
エイリアス | None |
-UseCredentialsFrom <ConnectionEntity>
他の接続から資格情報を使用します。
必須かどうか | True |
既定値 | None |
パイプライン入力を受け付けるか？ | False |
ワイルドカード文字を受け付けるか？ | False |
パラメーターセット名 | UseCredentialsFrom |
エイリアス | None |
-UserName <String>
ユーザー名を指定します。
必須かどうか | True |
既定値 | None |
パイプライン入力を受け付けるか？ | False |
ワイルドカード文字を受け付けるか？ | False |
パラメーターセット名 | Manual |
エイリアス | None |
この記事は人工知能を使用して翻訳されています。内容に不明点がある場合は、元の英語版をご参照ください。