1
0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00

NEW FEATURE: M365_BUILDER() (Microsoft 365 builder) (#2365)

Co-authored-by: Tom Limoncelli <tlimoncelli@stackoverflow.com>
This commit is contained in:
Julius Rickert
2023-05-17 16:38:24 +02:00
committed by GitHub
parent 835ea8817a
commit 08cdba4a79
3 changed files with 247 additions and 0 deletions

View File

@ -0,0 +1,70 @@
---
name: M365_BUILDER
parameters:
- label
- mx
- autodiscover
- dkim
- skypeForBusiness
- mdm
- domainGUID
- initialDomain
parameters_object: true
parameter_types:
label: string?
mx: boolean?
autodiscover: boolean?
dkim: boolean?
skypeForBusiness: boolean?
mdm: boolean?
domainGUID: string?
initialDomain: string?
---
DNSControl offers a `M365_BUILDER` which can be used to simply set up Microsoft 365 for a domain in an opinionated way.
It defaults to a setup without support for legacy Skype for Business applications.
It doesn't set up SPF or DMARC. See [`SPF_BUILDER`](/language-reference/record-modifiers/dmarc_builder) and [`DMARC_BUILDER`](/language-reference/record-modifiers/spf_builder).
## Example
### Simple example
{% code title="dnsconfig.js" %}
```javascript
M365_BUILDER({
initialDomain: 'example.onmicrosoft.com',
});
```
{% endcode %}
This sets up `MX` records, Autodiscover, and DKIM.
### Advanced example
{% code title="dnsconfig.js" %}
```javascript
M365_BUILDER({
label: 'test',
mx: false,
autodiscover: false,
dkim: false,
mdm: true,
domainGUID: 'test-example-com', // Can be automatically derived in this case, if example.com is the context.
initialDomain: 'example.onmicrosoft.com',
});
```
{% endcode %}
This sets up Mobile Device Management only.
### Parameters
* `label` The label of the Microsoft 365 domain, useful if it is a subdomain (default: `'@'`)
* `mx` Set an `MX` record? (default: `true`)
* `autodiscover` Set Autodiscover `CNAME` record? (default: `true`)
* `dkim` Set DKIM `CNAME` records? (default: `true`)
* `skypeForBusiness` Set Skype for Business/Microsoft Teams records? (default: `false`)
* `mdm` Set Mobile Device Management records? (default: `false`)
* `domainGUID` The GUID of _this_ Microsoft 365 domain (default: `<label>.<context>` with `.` replaced by `-`, no default if domain contains dashes)
* `initialDomain` The initial domain of your Microsoft 365 tenant/account, ends in `onmicrosoft.com`