注: PowerShellとの連携には、ShareGate MigrateのProまたはEnterpriseサブスクリプションが必要です。Essentialsプランでは利用できません。

コマンド

Connect-Site

説明

SharePointサイトに接続するためのコマンドです。

注: 2026年1月末以降、MicrosoftはIDCRL Cookieの段階的な廃止を開始しました。これにより、ほとんどのMicrosoft 365テナントで、パラメーター-Browserおよび-ModernAuthを使用するブラウザーおよびModern Authentication方式のみが機能するようになります。この変更の詳細については、Microsoft 365における「その他のユーザー」認証の重要な変更を参照してください。

例

Microsoft 365でModern Authenticationを使用してSharePoint Onlineサイトに接続する

$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth

Microsoft 365でModern AuthenticationとUserNameを使用してSharePoint Onlineサイトに接続する

$mysite = Connect-Site -Url http://mytenantdomain/sites/mysitecollection -ModernAuth -UserName [email protected]

注: PowerShellウィンドウでパスワードの入力を求められます。

Microsoft 365でModern Authentication、UserName、およびパスワードを使用して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

接続し、SharePointサイト接続をShareGate Migrate Explorerに追加する

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
既定値	None
パイプライン入力を許可するか	False
ワイルドカード文字を許可するか	False
パラメーターセット名	(All)
エイリアス	None

-AllowConnectionFallback <SwitchParameter>

指定したURLに接続できない場合に、ShareGateが階層を上位にたどって接続オプションを検索できるようにします。

必須かどうか	False
既定値	None
パイプライン入力を許可するか	False
ワイルドカード文字を許可するか	False
パラメーターセット名	(All)
エイリアス	None

-AllowMissingPermissions <SwitchParameter>

AzureアプリケーションにSharePoint、グループ、Teams、またはPlannerに通常必要な1つ以上のアクセス許可が不足している場合でも、接続を続行できるようにします。不足しているアクセス許可を一覧表示する警告が出力されます。

必須かどうか	False
既定値	None
パイプライン入力を許可するか	False
ワイルドカード文字を許可するか	False
パラメーターセット名	UseCredentialsFrom, AzureApplication
エイリアス	None

-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への接続時にのみ機能します。TeamsやExchangeメールボックスなど、他のMicrosoft 365サービスに接続するには-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

この記事はAIによって翻訳されています。ご不明な点がある場合は、英語の原文をご確認ください。