Connect-MsolService

Updated: July 30, 2015

Applies To: Azure, Office 365, Windows Intune

The Connect-MsolService cmdlet will attempt to initiate a connection with Microsoft Azure Active Directory. The caller must provide their credential through a PSCredential object.

Connect-MsolService [-Credential <PSCredential>] [<CommonParameters>]

    -Credential <PSCredential>
        The credential to use for connecting to Office 365.
        
        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".

There are a couple of ways that you can connect to the online service. The first is to simply run the cmdlet and you will be prompted for credentials. The second is to supply the credentials as a variable ($cred is used below) and then specify that variable when connecting. The following examples demonstrate further.

This command attempts to initiate a connection. Since no credential is provided, the user is prompted to enter a username and password.

Connect-MsolService

This command attempts to initiate a connection to AzureChinaCloud with Microsoft Azure Active Directory using the credential provided previously provided as $Cred. The credential must be of the type PSCredential, which is typically retrieved through the Get-Credential cmdlet.

Connect-MsolService -Credential $Cred -AzureEnvironment AzureChinaCloud

There are several other places you can get more information and help. These include:

• Azure Active Directory Forum

• Azure AD Community Information Center

• Azure Active Directory Community scripts

Manage Azure Active Directory by using Windows PowerShell