Connect-SPOService

Modulo:: Microsoft.Online.SharePoint.PowerShell

Si applica a:: SharePoint Online

Connette l'amministratore di SharePoint Online o l'amministratore di SharePoint Embedded a una connessione di SharePoint Online (Interfaccia di amministrazione di SharePoint Online). Questo cmdlet deve essere eseguito prima dell'esecuzione di qualsiasi altro cmdlet di SharePoint Online.

Sintassi

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>]

Descrizione

Il Connect-SPOService cmdlet connette l'amministratore di SharePoint Online o l'amministratore di SharePoint Embedded all'Interfaccia di amministrazione di SharePoint Online.

Da una singola sessione di Windows PowerShell viene mantenuta una sola connessione al servizio SharePoint Online. In altre parole, si tratta di una connessione per area geografica all'interno di una connessione di amministratore dell'organizzazione. L'esecuzione del Connect-SPOService cmdlet due volte disconnette in modo implicito la connessione precedente. La sessione Windows PowerShell verrà impostata per servire il nuovo amministratore di SharePoint Online specificato.

Un amministratore partner delegato deve scambiare connessioni per organizzazioni diverse all'interno della stessa sessione di Windows PowerShell.

Per eseguire il cmdlet, è necessario essere un amministratore di SharePoint Online o un amministratore di SharePoint Embedded.

Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per SharePoint Online, vedere la documentazione online alla pagina Introduzione a SharePoint Online Management Shell.

Esempio

-----------------------ESEMPIO 1-----------------------------

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

L'esempio 1 mostra come un amministratore di SharePoint Online con credenziali admin@contoso.com si connette a un'interfaccia di amministrazione di SharePoint Online con l'URL <https://contoso-admin.sharepoint.com.>

-----------------------ESEMPIO 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

Nell'esempio 2 viene illustrato come un amministratore di SharePoint Online con nome utente e password si connette a un'interfaccia di amministrazione di SharePoint Online con l'URL <https://contoso-admin.sharepoint.com.>

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

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

Richieste per le credenziali. Questa operazione è necessaria se l'account usa l'autenticazione a più fattori.

-----------------------ESEMPIO 4-----------------------------

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

Si connette a un'interfaccia di amministrazione di SharePoint Online che specifica l'area.

-----------------------ESEMPIO 5-----------------------------

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

Connessione al servizio SPO con il flag ModernAuth.

-----------------------ESEMPIO 6-----------------------------

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

Esegue l'autenticazione tramite Microsoft Authentication Library (MSAL) e si connette all'Interfaccia di amministrazione di SharePoint Online al termine dell'autenticazione.

Parametri

-AuthenticationUrl

Percorso per Microsoft Entra servizio di autenticazione tra tenant. Può essere usato facoltativamente se viene usato il servizio di autenticazione tra tenant non predefinito.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	SharePoint Online

-ClientTag

Consente l'aggiunta di un tag client al tag client esistente. Usato facoltativamente nel traffico HTTP CSOM per identificare lo script o la soluzione usata.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	SharePoint Online

-Credential

Specifica le credenziali da utilizzare per la connessione. Se non vengono presentate credenziali, queste verranno richieste mediante una finestra di dialogo. Le credenziali devono essere quelle di un amministratore di SharePoint Online che può accedere al sito dell'Interfaccia di amministrazione di SharePoint Online.

Tipo:	CredentialCmdletPipeBind
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False
Si applica a:	SharePoint Online

-ModernAuth

Garantisce che i cmdlet di amministrazione del tenant di SharePoint Online possano connettersi al servizio usando protocolli TLS moderni.

Per usarlo, è anche necessario specificare il parametro AuthenticationUrl .

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	SharePoint Online

-Region

I valori validi sono: Default | ITAR | Germania | Cina

Il valore predefinito è "default".

Nota: il valore ITAR è solo per le tenancies GCC High e DoD.

Tipo:	AADCrossTenantAuthenticationLocation
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	SharePoint Online

-Url

Specifica l'URL del sito dell'Interfaccia di amministrazione di SharePoint Online.

Tipo:	UrlCmdletPipeBind
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False
Si applica a:	SharePoint Online

-UseSystemBrowser

Usato per autenticare l'utente usando Microsoft Authentication Library (MSAL).

Tipo:	Boolean
Posizione:	5
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	SharePoint Online