4 Start Graph as‐a‐code configuration - dcasota/m365-scripts GitHub Wiki

The organization profile can be edited by user interface or by Microsoft Graph.

I haven't found out how to change all parameters. Actually modifying the technical account email address seems to be possible only.

By User Interface in Microsoft 365 Admin Center

  1. Go to the Microsoft 365 admin center https://admin.microsoft.com
  2. In the left-hand navigation pane, select the Show All ellipsis … icon to display all the navigation menu options.
  3. In the left-hand navigation pane, select Settings and then select Org settings.
  4. On the Org settings page, select the Organization profile tab.
  5. On the Organization profile tab, the settings are segregated by group, such as Custom themes and Organization information. Select the appropriate group, make your edits, and then save the group. Repeat this process for each group of settings as needed.

image

By Azure Powershell

  1. connect-azaccount
  2. Ensure that the Az.resources module is installed.
  3. show the main properties by get-az-adorganization. image
  4. List the same properties as in the user interface.
(get-azadorganization).DisplayName
(get-azadorganization).Street
(get-azadorganization).Apartment
(get-azadorganization).City
(get-azadorganization).State
(get-azadorganization).PostalCode
(get-azadorganization).CountryLetterCode
(get-azadorganization).BusinessPhone
(get-azadorganization).TechnicalNotificationMail
(get-azadorganization).PreferredLanguage

There is no set-azadorganization or update-azadorganization module. An update can be accomplished by using Microsoft Graph.

First, check that you have the right permissions to accomplish an update task, see https://learn.microsoft.com/en-us/graph/api/organization-update?view=graph-rest-1.0&tabs=powershell.

Change permissions e.g. using Microsoft Graph Explorer https://developer.microsoft.com/en-us/graph/graph-explorer.

Here a code snippet which updates the technicalNotificationMail address.

install-module -name Az
connect-azaccount

$organizationId=(get-azadorganization).Id

# Use Microsoft Graph
install-module -name Microsoft.Graph
Import-Module Microsoft.Graph.Identity.DirectoryManagement

# Accept the api
Connect-MgGraph -Scopes "Organization.ReadWrite.All"

# specifiy the parameters
$params = @{
technicalNotificationMails = @("[email protected]")
}

# update
Update-MgOrganization -OrganizationId $organizationId -BodyParameter $params

Updating all the parameters doesn't seem to work. The issue message is that parameters e.g. city, preferredLanguage, etc. are read-only. I haven't found out which permissions are necessary to modify those parameters as well.

$params = @{
displayName = @("Your Display Name")
street = @("your Street and Number)
city = @("Your city")
state = @("your state")
postalCode = @("4000")
countryLetterCode = @("CH")
technicalNotificationMails = @("[email protected]")
preferredLanguage = @("en")
}

Retrieve all service principal from the directory

connect-azaccount

get-azADServicePrincipal

DisplayName                                             Id                                   AppId
-----------                                             --                                   -----
Microsoft Workplace Search Service                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Exchange Online Protection                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Bing                                                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office Online Service LEGACY                            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
AAD Request Verification Service - PROD                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Substrate Instant Revocation Pipeline                   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Office 365 Portal                             xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office365DirectorySynchronizationService                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Device Management Checkin                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
IpLicensingService                                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft SharePoint Online - SharePoint Home           xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
O365 Secure Score                                       xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Device Registration Service                             xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Intune API                                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Azure Portal                                            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office365 Shell SS-Server Default                       xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office 365 Exchange Online                              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Windows AutoPilot Service API                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Intune SCCM Connector                         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft People Cards Service                          xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Narada Notification Service                             xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Azure Credential Configuration Endpoint Service         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
SPAuthEvent                                             xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Azure Workflow                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
M365 License Manager                                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
My Profile                                              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Graph Command Line Tools                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
M365 Admin Services                                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
MCAPI Authorization Prod                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OneProfile Service                                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
SharePoint Framework Azure AD Helper                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Information Protection Sync Service           xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Billing RP                                              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Connectors                                              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Graph Change Tracking                         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Windows Azure Active Directory                          xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office 365 SharePoint Online                            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OfficeServicesManager                                   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
SharePoint Online Web Client Extensibility Isolated     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Approval Management                           xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Device Management EMM API                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office 365 Management APIs                              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office Shredding Service                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
IAM Supportability                                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Graph Explorer                                          xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
SharePoint Notification Service                         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Service Trust                                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft App Access Panel                              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Configuration Manager Microservice                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OCaaS Worker Services                                   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
AADReporting                                            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office365 Zoom                                          xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Intune Advanced Threat Protection Integration xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Azure ESTS Service                                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OCaaS Experience Management Service                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
IPSubstrate                                             xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
PPE-DataResidencyService                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
CompliancePolicy                                        xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Cortana Runtime Service                                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Intune                                        xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
O365 LinkedIn Connection                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Intune Service Discovery                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Graph                                         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Azure DevOps                                            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office 365 Search Service                               xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Commerce Accounts Service                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OneNote                                                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
SharePoint Home Notifier                                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
DeploymentScheduler                                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
WindowsUpdate-Service                                   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Intune CMDeviceService                                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office 365 Information Protection                       xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft 365 Security and Compliance Center            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OCaaS Client Interaction Service                        xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Media Analysis and Transformation Service               xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
o365.servicecommunications.microsoft.com                xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OfficeClientService                                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Request Approvals Read Platform                         xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Windows Azure Service Management API                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office 365 Configure                                    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft password reset service                        xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Cortana at Work Service                                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Office365 Shell WCSS-Server Default                     xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
ComplianceWorkbenchApp                                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
SharePoint Online Web Client Extensibility              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Power BI Service                                        xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Azure MFA StrongAuthenticationService                   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
AzureSupportCenter                                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
OMSAuthorizationServicePROD                             xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Skype for Business Online                               xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
AAD App Management                                      xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Substrate-FileWatcher                                   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
PushChannel                                             xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Windows Store for Business                              xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft.SMIT                                          xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Signup                                                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
CPIM Service                                            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Mobile Application Management                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Graph Connector Service                                 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
MS-PIM                                                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
Microsoft Azure AD Identity Protection                  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…
O365 Demeter                                            xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx xxxxxxxx-xxxx-xxx…