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:
70
documentation/functions/record/M365_BUILDER.md
Normal file
70
documentation/functions/record/M365_BUILDER.md
Normal 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`
|
Reference in New Issue
Block a user