Condividi tramite


Connect-SPOService

Connette un amministratore di SharePoint Online o un amministratore globale 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
       -AuthenticationUrl <String>
       [-ClientTag <String>]
       [-Credential <CredentialCmdletPipeBind>]
       -Url <UrlCmdletPipeBind>
       -ModernAuth <Boolean>
       [<CommonParameters>]
Connect-SPOService
       [-ClientTag <String>]
       [-Credential <CredentialCmdletPipeBind>]
       [-Region <AADCrossTenantAuthenticationLocation>]
       -Url <UrlCmdletPipeBind>
       [<CommonParameters>]

Descrizione

Il Connect-SPOService cmdlet connette un amministratore di SharePoint Online o un amministratore globale 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 avere il ruolo di amministratore globale o di amministratore di SharePoint Online.

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 o un amministratore globale 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 o un amministratore globale con nome utente e password si connette a un'interfaccia di amministrazione di SharePoint Online con l'URL https://contoso-admin.sharepoint.com.

-----------------------ESEMPIO 3-----------------------------

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

Richiede 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.

Parametri

-AuthenticationUrl

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 o di un amministratore globale che può accedere al sito dell'Interfaccia di amministrazione di SharePoint Online.

Type:CredentialCmdletPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to: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 .

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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.

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

-Url

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

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