Learn Editor: Update Connect-SPOService.md

Author: samkabue

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Connect-SPOService.md

@@ -14,132 +14,123 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-Connects the SharePoint Online Administrator or the SharePoint Embedded Administrator to a SharePoint Online connection (the SharePoint Online Administration Center).
-This cmdlet must be run before any other SharePoint Online cmdlets can run.
+Connects a SharePoint Administrator or SharePoint Embedded Administrator to the SharePoint admin center. You must run this cmdlet before running any other SharePoint Online cmdlets.
 
 ## SYNTAX
 
 ### AuthenticationCertificate
 
 ```
-Connect-SPOService -Url <UrlCmdletPipeBind> [-ClientTag <String>]
- [-Region <AADCrossTenantAuthenticationLocation>] [-AuthenticationUrl <String>]
- [-Certificate <X509Certificate2>] [-CertificatePath <String>] [-CertificateThumbprint <String>]
- [-CertificatePassword <SecureString>] -ClientId <String> -TenantId <String> [<CommonParameters>]
+Connect-SPOService [-Url] <UrlCmdletPipeBind> [[-ClientTag] <String>] [-Region <AADCrossTenantAuthenticationLocation>] [-AuthenticationUrl <String>] [-Certificate <X509Certificate2>] [-CertificatePath <String>] [-CertificateThumbprint <String>] [-CertificatePassword <SecureString>] -ClientId <String> -TenantId <String> [<CommonParameters>]
 ```
 
 ### AuthenticationLocation
 
 ```
-Connect-SPOService -Url <UrlCmdletPipeBind> [-Credential <CredentialCmdletPipeBind>] [-ClientTag <String>]
- [-Region <AADCrossTenantAuthenticationLocation>] [-ModernAuth <Boolean>] [-UseSystemBrowser <Boolean>]
- [<CommonParameters>]
+Connect-SPOService [-Url] <UrlCmdletPipeBind> [[-Credential] <CredentialCmdletPipeBind>] [[-ClientTag] <String>] [-Region <AADCrossTenantAuthenticationLocation>] [[-ModernAuth] <Boolean>] [[-UseSystemBrowser] <Boolean>]
 ```
 
 ### AuthenticationUrl
 
 ```
-Connect-SPOService -Url <UrlCmdletPipeBind> [-Credential <CredentialCmdletPipeBind>] [-ClientTag <String>]
- -AuthenticationUrl <String> [-ModernAuth <Boolean>] [-UseSystemBrowser <Boolean>] [<CommonParameters>]
+Connect-SPOService [-Url] <UrlCmdletPipeBind> [[-Credential] <CredentialCmdletPipeBind>] [[-ClientTag] <String>] -AuthenticationUrl <String> [[-ModernAuth] <Boolean>] [[-UseSystemBrowser] <Boolean>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 
-The `Connect-SPOService` cmdlet connects the SharePoint Online Administrator or the SharePoint Embedded Administrator to the SharePoint Online Administration Center.
-
-Only a single SharePoint Online service connection is maintained from any single Windows PowerShell session.
-In other words, this is a per-geo within an organization administrator connection.
-Running the `Connect-SPOService` cmdlet twice implicitly disconnects the previous connection.
-The Windows PowerShell session will be set to serve the new SharePoint Online administrator specified.
-
-A delegated partner administrator has to swap connections for different organizations within the same Windows PowerShell session.
-
-You must be a SharePoint Online Administrator or a SharePoint Embedded Administrator to run the cmdlet.
-
-For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell).
+This cmdlet connects a SharePoint Administrator or SharePoint Embedded Administrator to the SharePoint admin center.
+Only one SharePoint Online service connection is supported per Windows PowerShell session and per geo within an organization. If you run this cmdlet again, the existing connection is automatically disconnected and replaced with the new connection. The PowerShell session then uses the newly specified administrator context.
+Delegated partner administrators must switch connections when managing multiple organizations within the same PowerShell session.
+To run this cmdlet, you must be a SharePoint Administrator or SharePoint Embedded Administrator.
+For permission requirements and the latest guidance, see the [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell) documentation.
 
 ## EXAMPLES
 
 ### EXAMPLE 1
 
 ```powershell
-Connect-SPOService -Url https://contoso-admin.sharepoint.com -credential admin@contoso.com
+Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
 ```
 
-Example 1 shows how a SharePoint Online administrator with credential admin@contoso.com connects to a SharePoint Online Administration Center that has the URL `<https://contoso-admin.sharepoint.com.>`
+This example shows how a SharePoint Administrator using the `admin@contoso.com` account connects to the SharePoint admin center at `https://contoso-admin.sharepoint.com`.
 
 ### EXAMPLE 2
 
 ```powershell
 $username = "admin@contoso.sharepoint.com"
-$password = "password"
-$cred = New-Object -TypeName System.Management.Automation.PSCredential -argumentlist $userName, $(convertto-securestring $Password -asplaintext -force)
+$password = Read-Host -Prompt "Enter user password" -AsSecureString
+$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $userName, $password
 Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential $cred
 ```
 
-Example 2 shows how a SharePoint Online administrator with a username and password connects to a SharePoint Online Administration Center that has the URL `<https://contoso-admin.sharepoint.com.>`
+This example shows how a SharePoint Administrator connects to the SharePoint admin center at `https://contoso-admin.sharepoint.com` by creating a credential object from a username and password.
 
 ### EXAMPLE 3
 
 ```powershell
 Connect-SPOService -Url https://contoso-admin.sharepoint.com
 ```
 
-Prompts for credentials. This is required if the account is using multi-factor authentication.
+This example prompts for credentials. This approach is required when the account uses multi-factor authentication.
 
 ### EXAMPLE 4
 
 ```powershell
 Connect-SPOService -Url https://contoso-admin.sharepoint.com -Region ITAR
 ```
 
-Connects to a SharePoint Online Administration Center specifying the region.
+This example connects to the SharePoint admin center by specifying the authentication region.
 
 ### EXAMPLE 5
 
 ```powershell
 Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations
 ```
-Connecting to SPO Service with ModernAuth Flag.
+
+This example connects to the SharePoint admin center by using modern authentication.
 
 ### EXAMPLE 6
 
 ```powershell
 Connect-SPOService -Url https://contoso-admin.sharepoint.com -UseSystemBrowser $true
 ```
-Authenticates using the Microsoft Authentication Library (MSAL) and connects to the SharePoint Online Administration Center on successful authentication.
+
+This example authenticates by using the Microsoft Authentication Library (MSAL) and connects to the SharePoint admin center after authentication succeeds.
 
 ### EXAMPLE 7
 
 ```powershell
 $password = Read-Host -Prompt "Enter certificate password" -AsSecureString
-Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password
+Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificatePath C:\Certs\ContosoAppAuth.pfx -CertificatePassword $password
 ```
-Connect to the SharePoint Online service using an app identity and a certificate file path, with an optional password.
+
+This example connects to the SharePoint admin center by using an app identity and a certificate file path, with an optional certificate password.
 
 ### EXAMPLE 8
 
 ```powershell
-Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"
+Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -CertificateThumbprint "3FAAAA1111AAAAAAAAAAA2222AAAAAAAAAAAAAAA"
 ```
-Connect to the SharePoint Online service using an app identity and a certificate thumbprint.
+
+This example connects to the SharePoint admin center by using an app identity and a certificate thumbprint.
 
 ### EXAMPLE 9
 
 ```powershell
 $thumbprint = "3F2A5C9D4E7B8A1234567890ABCDEF1234567890"
 $cert = Get-ChildItem Cert:\LocalMachine\My\$thumbprint
-Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -Tenant 11111111-1111-1111-1111-111111111111 -Certificate $cert
+Connect-SPOService -Url https://contoso-admin.sharepoint.com -ClientId 00000000-0000-0000-0000-000000000000 -TenantId 11111111-1111-1111-1111-111111111111 -Certificate $cert
 ```
-Connect to the SharePoint Online service using an app identity and a certificate object.
+
+This example connects to the SharePoint admin center by using an app identity and a certificate object.
 
 ## PARAMETERS
 
 ### -AuthenticationUrl
 
 > Applicable: SharePoint Online
 
-Location for Microsoft Entra Cross-Tenant Authentication service. Can be optionally used if non-default Cross-Tenant Authentication Service is used.
+Specifies the URL for the Microsoft Entra cross-tenant authentication service. Use this parameter when a non-default cross-tenant authentication endpoint is required.
 
 ```yaml
 Type: System.String
@@ -169,7 +160,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-An X.509 certificate used during authentication.
+Specifies the X.509 certificate used for authentication.
 
 ```yaml
 Type: X509Certificate2
@@ -187,7 +178,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-The password for the certificate file.
+Specifies the password for the certificate file.
 
 ```yaml
 Type: SecureString
@@ -205,7 +196,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-The path to the local .pfx certificate file.
+Specifies the path to the local `.pfx` certificate file.
 
 ```yaml
 Type: String
@@ -223,7 +214,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-The thumbprint of the certificate in the current user's certificate store.
+Specifies the thumbprint of the certificate in the current user's certificate store.
 
 ```yaml
 Type: String
@@ -241,7 +232,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-The application's client ID.
+Specifies the client ID of the application.
 
 ```yaml
 Type: String
@@ -259,7 +250,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-Permits appending a client tag to existing client tag. Used optionally in the CSOM http traffic to identify used script or solution.
+Optionally adds a client tag to CSOM HTTP traffic to help identify the calling script or solution.
 
 ```yaml
 Type: System.String
@@ -277,7 +268,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-Specifies the credentials to use to connect. If no credentials are presented, a dialog will prompt for the credentials. The credentials must be those of a SharePoint Online administrator who can access the SharePoint Online Administration Center site.
+Specifies the credentials used to connect. If you do not provide credentials, you are prompted to enter them. The credentials must belong to an administrator who has access to the SharePoint admin center.
 
 ```yaml
 Type: Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind
@@ -295,9 +286,8 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-Ensures that SharePoint Online tenant administration cmdlets can connect to the service using modern TLS protocols.
-
-To use it you also need to provide the **AuthenticationUrl** parameter.
+Enables modern authentication when connecting to SharePoint administration cmdlets.
+When you use this parameter, you must also specify the `AuthenticationUrl` parameter.
 
 ```yaml
 Type: System.Boolean
@@ -315,11 +305,9 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-The valid values are: Default | ITAR | Germany | China
-
-The default value is "default".
-
-**Note**: The ITAR value is for GCC High and DoD tenancies only.
+Specifies the authentication region. Valid values are: `Default`, `ITAR`, `Germany`, and `China`.
+The default value is `Default`.
+**Note:** The `ITAR` value applies only to GCC High and DoD tenants.
 
 ```yaml
 Type: Microsoft.Online.SharePoint.PowerShell.AADCrossTenantAuthenticationLocation
@@ -337,7 +325,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-The tenant ID to connect to.
+Specifies the ID of the tenant to connect to.
 
 ```yaml
 Type: String
@@ -355,7 +343,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-Specifies the URL of the SharePoint Online Administration Center site.
+Specifies the URL of the SharePoint admin center.
 
 ```yaml
 Type: Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind
@@ -373,12 +361,12 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-Used to authenticate the user using the Microsoft Authentication Library (MSAL).
+Uses the Microsoft Authentication Library (MSAL) to authenticate the user by using the system browser.
 
 > [!NOTE]
 > To avoid adding the `-UseSystemBrowser` parameter every time you run `Connect-SPOService`, you can set a registry key instead.
 >
-> Set the `UseSystemBrowser` registry key (type `REG_DWORD`) at: 
+> Set the `UseSystemBrowser` registry key (type `REG_DWORD`) at:
 `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SPO\CMDLETS\`
 >
 > If either registry key is set to a non-zero integer value or `-UseSystemBrowser` parameter is set to `true`, authentication flow will use system browser for sign-in.
@@ -397,18 +385,23 @@ Accept wildcard characters: False
 
 ### CommonParameters
 
-This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
+This cmdlet supports the common parameters: `-Debug`, `-ErrorAction`, `-ErrorVariable`, `-InformationAction`, `-InformationVariable`, `-OutVariable`, `-OutBuffer`, `-PipelineVariable`, `-ProgressAction`, `-Verbose`, `-WarningAction`, and `-WarningVariable`. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
 
 ## INPUTS
 
+### Microsoft.Online.SharePoint.PowerShell.UrlCmdletPipeBind
+
+### Microsoft.Online.SharePoint.PowerShell.CredentialCmdletPipeBind
+
 ## OUTPUTS
 
+### System.Object
 ## NOTES
 
 ## RELATED LINKS
 
-[Introduction to the SharePoint Online management shell](https://support.office.com/en-us/article/introduction-to-the-sharepoint-online-management-shell-c16941c3-19b4-4710-8056-34c034493429)
+[Introduction to the SharePoint Online management shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell)
 
 [Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online)
 
-[Disconnect-SPOService](Disconnect-SPOService.md)
+[Disconnect-SPOService](./Disconnect-SPOService.md)