docs/about_UserManagement.help.txt
|
TOPIC
about_usermanagement SHORT DESCRIPTION Managing AzureAdUsers, Groups, ResourceAccounts for use in CQs and AAs. LONG DESCRIPTION User Management CmdLets are covering a range of topics, from Analog Devices, Common Area Phones, Resource Accounts to Users and Groups. This page focuses on uncategorised CmdLets that supplement the User Management aspect. Where appropriate, individual about-pages have been created for them. Please see section 'See Also' for links to related topics. Finding Users, Groups or other objects is sometimes too complex for my taste. Using `Get-AzureAdUser -Searchstring "$UPN"` is fine, but sometimes I just want to bash in the UserPrincipalName or Group Name and get a result. Some helper functions that simplify input a bit and expand on the functionality of Callable Entity: CmdLets | Function | Description | | ---------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------------- | | `Find-AzureAdGroup` | Helper Function to find AzureAd Groups. Returns Objects if found. Simplifies Lookup and Search of Objects | | `Find-AzureAdUser` | Helper Function to find AzureAd Users. Returns Objects if found. Simplifies Lookup and Search of Objects | > [!Note] On first run, Find-AzureAdGroup (and other CmdLets that are working with AzureAd Groups) will load all Groups available in the Tenant into a Global variable. This is done as searches against AzureAd Groups are somewhat clunky and overall performance is improved when validating and looking up information. > <br />All global variables will be removed when closing the PowerShell window or disconnecting from the Tenant with `Disconnect-Me` Admin Roles Activating Admin Roles made easier. Please note that Privileged Access Groups are not yet integrated as there are no PowerShell commands available yet in the AzureAdPreview Module. This will be added as soon as possible. Commands are used with `Connect-Me`, but can be used on its own just as well. > [!NOTE] Please note , that Privileged Admin Groups are currently not covered by these CmdLets. This will be added as soon as they have been fully documented and PowerShell CmdLets are available for them. | Function | Description | | ------------------------------------------------------------: | ------------------------------------------------------------------------------------------------ | | `Disable-AzureAdAdminRole` | Disables Admin Roles assigned directly to the AccountId provided. | | `Enable-AzureAdAdminRole` | Enables Admin Roles assigned directly to the AccountId provided. | | `Get-AzureAdAdminRole` Admin Roles assigned to an AzureAdUser | | `Disable-MyAzureAdAdminRole` | Disables Admin Roles for the currently connected Administrator. | | `Enable-MyAzureAdAdminRole` | Enables Admin Roles for the currently connected Administrator. | | `Get-MyAzureAdAdminRole` Admin Roles assigned to the currently connected Administrator | Support CmdLet | Function | Description | | -----------------------------------------------------------: | ------------------------------------------------------------------------------------------- | | `Test-AzureAdGroup` | Testing whether the Group exists in AzureAd | | `Test-AzureAdUser` | | `Test-TeamsResourceAccount` | Testing whether a Resource Account exists in AzureAd | | `Test-TeamsUser` | Testing whether the User exists in SkypeOnline/Teams | EXAMPLES These CmdLets do not require explicit use cases reflected here. Please see the Examples for the individual CmdLets in their respective help files NOTE This page only lists the CmdLets that are not categorised further. See below for Callable Entities, Common Area Phones and Analog Devices, etc. TROUBLESHOOTING NOTE Thoroughly tested, but Unit-tests for these CmdLets are not yet available. There might be a few cases where the Output displays too much or too little. The Find-CmdLets took a while to properly be fine tuned. If you do not find something that you know is there, please let me know SEE ALSO - about_TeamsCallableEntity - about_TeamsCommonAreaPhone - about_TeamsAnalogDevice - about_TeamsResourceAccount - about_Licensing KEYWORDS - User, AzureAdUser, CsOnlineUser - Group, AzureAdGroup - Resource, Resource Account, CsOnlineApplicationInstance - Common Area Phone - Analog Device - IP Phone |