Skip to content

Commit 5232c61

Browse files
authored
Merge pull request Azure#906 from msewaweru/install-msonline-update
MSOnline installation page - Deprecation update
2 parents 1f75a4e + ecfa847 commit 5232c61

File tree

1 file changed

+12
-53
lines changed

1 file changed

+12
-53
lines changed

docs-conceptual/azureadps-1.0/install-msonlinev1.md

+12-53
Original file line numberDiff line numberDiff line change
@@ -7,61 +7,26 @@ ms.workload: identity
77
ms.devlang: powershell
88
ms.topic: article
99
ms.date: 01/21/2022
10-
ms.author: rodejo
10+
ms.author: eunicewaweru
1111
ms.custom: posh-docs-conceptual
12-
ms.reviewer: rodejo
1312
---
1413
# Azure Active Directory (MSOnline)
1514

16-
You can use the Azure Active Directory Module for Windows PowerShell cmdlets for Azure AD administrative tasks such as user management, domain management and for configuring single sign-on.
17-
This topic includes information about how to install these cmdlets for use with your directory.
18-
19-
Please note that we will begin to deprecate this module when the functionality of this module is available in the newer [Azure Active Directory PowerShell for Graph](/powershell/azure/active-directory/install-adv2?view=azureadps-2.0&preserve-view=true) module. We advise customers who are creating new PowerShell scripts to use the newer module instead of this module.
15+
>[!IMPORTANT]
16+
> MSOnline is planned for deprecation on **March 30, 2024**. For more details on the deprecation plans, see the [deprecation update](https://techcommunity.microsoft.com/t5/microsoft-entra-azure-ad-blog/microsoft-entra-new-feature-and-change-announcements/ba-p/3796396). We encourage you to continue migrating to [Microsoft Graph PowerShell](/powershell/microsoftgraph/overview), which is the recommended module for interacting with Azure AD. In addition, Microsoft Graph PowerShell allows you access to all Microsoft Graph APIs and is available on PowerShell 7. For answers to frequent migration queries, see the [Migration FAQ](../azureadps-2.0/migration-faq.yml).
2017
18+
You can use MSOnline for Azure AD administrative tasks such as user management, domain management and for configuring single sign-on.
19+
This topic includes information about how to install these cmdlets for use with your directory.
2120

22-
## Install the Azure AD Module
21+
## Install MSOnline
2322

24-
The Azure AD Module is supported on the following Windows operating systems with the default version of Microsoft .NET Framework and Windows PowerShell: Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012, or Windows Server 2008 R2.
23+
MSonline is supported on the following Windows operating systems with the default version of Microsoft .NET Framework and Windows PowerShell: Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012, or Windows Server 2008 R2.
2524

2625
The easiest way to install the module is from the [PowerShell Gallery](https://www.powershellgallery.com/packages/MSOnline). You can install the module with the Install-Module cmdlet:
2726

2827
```powershell
2928
Install-Module MSOnline
3029
```
31-
## MSOnline Public Preview module
32-
33-
The MSOnline Public Preview release 1.1.130.0 is no longer available for download. If you are looking for the MSOL-Settings cmdlets to manage groups settings for Unified Groups, these are now available in the newer Azure AD PowerShell V2 Public Preview module, which can be found in the [Powershell Gallery for the Azure AD Preview module](https://www.powershellgallery.com/packages/AzureADPreview). You can install this module with the cmdlet
34-
35-
```powershell
36-
Install-Module AzureADPreview
37-
```
38-
39-
Note that the MSOL Settings cmdlets have been given a new name, more information about these cmdlets and how to use them can be found in [this article](/azure/active-directory/active-directory-accessmanagement-groups-settings-cmdlets).
40-
41-
**Important**
42-
43-
Effective October 20, 2014, the Azure Active Directory Module for Windows PowerShell (32-bit version) is discontinued.
44-
Support for the 32-bit version will no longer occur, and future updates to the Azure Active Directory Module will be released only for the 64-bit version.
45-
46-
We strongly recommend you install the 64-bit version to ensure future support and compatibility.
47-
48-
You can also access previous versions of the Azure AD module from the [Microsoft Azure Active Directory PowerShell Module Version Release History](https://social.technet.microsoft.com/wiki/contents/articles/28552.microsoft-azure-active-directory-powershell-module-version-release-history.aspx) on the TechNet Wiki.
49-
50-
51-
## Updating the Azure AD Module
52-
53-
You can run the **Get-Item** cmdlet to check the version of the DLL files of the module that you have currently installed:
54-
55-
```PowerShell
56-
(Get-item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion
57-
```
58-
59-
If the version number is lower than 1.0.8070.2, remove the existing version and re-install the module using the link in the previous section.
60-
Use **Add/Remove Programs** in Control Panel to remove **Azure Active Directory Module for Windows PowerShell**, or if you have an older installation, to remove **Microsoft Online Services Module for Windows PowerShell**.
61-
Uninstalling removes both the **MSOnline** and **MSOnlineExtended** modules.
62-
63-
The **Remove-Module** cmdlet removes the **MSOnline** cmdlets from the session but it does not uninstall the module.
64-
6530

6631
## Connect to Azure AD
6732

@@ -75,10 +40,10 @@ $Msolcred = Get-credential
7540
Connect-MsolService -Credential $MsolCred
7641
```
7742

78-
The first command prompts for credentials and stores them as $Msolcred.
79-
The next command uses those credentials as $Msolcred to connect to the service.
43+
The first command prompts for credentials and stores them as *$Msolcred*.
44+
The next command uses those credentials as *$Msolcred* to connect to the service.
8045

81-
To connect to a specific environment of Azure Active Directory, use the AzureEnvironment parameter, as follows:
46+
To connect to a specific environment of Azure Active Directory, use the **AzureEnvironment** parameter, as follows:
8247

8348
```powershell
8449
Connect-MsolService -AzureEnvironment "AzureGermanyCloud"
@@ -104,12 +69,6 @@ Notepad c:\MsolHelp\msolcmdlets.txt
10469

10570
* View the name, synopsis, description, detailed parameters, and any examples provided for a cmdlet, run the following command at the Windows PowerShell command prompt: `Get-Help <cmdlet-name> -Full`
10671

72+
## See also
10773

108-
## More about Windows PowerShell
109-
110-
Windows PowerShell is a task-based command-line shell and scripting language designed for system administration.
111-
Unlike most shells, which accept and return text, Windows PowerShell is built on top of the .NET Framework, and accepts and returns .NET Framework objects.
112-
Windows PowerShell introduces the concept of a cmdlet (pronounced "command-let"), a simple, single-function command-line tool built into the shell.
113-
Cmdlets have the following naming convention: a verb and noun separated by a dash (-), such as Get-Help, Get-Process, and Start-Service.
114-
Windows PowerShell includes more than one hundred basic core cmdlets.
115-
For more information about Windows PowerShell, see [Getting Started with Windows PowerShell](https://msdn.microsoft.com/powershell/scripting/getting-started/getting-started-with-windows-powershell).
74+
- [Install the Microsoft Graph PowerShell SDK](/powershell/microsoftgraph/installation?view=graph-powershell-1.0&preserve-view=true)

0 commit comments

Comments
 (0)