Updates

Nik Charlebois 2020-04-09 12:11:02 -04:00
Родитель a93f3d2852
Коммит c2463ef56e
69 изменённых файлов: 224 добавлений и 66 удалений

48
AADGroupsNamingPolicy.md Normal file

@ -0,0 +1,48 @@
# AADGroupsNamingPolicy
## Parameters
| Parameter | Attribute | DataType | Description | Allowed Values |
| --- | --- | --- | --- | --- |
| **IsSingleInstance** | Key | String | Only valid value is 'Yes'. |Yes|
| **PrefixSuffixNamingRequirement** | Write | String | Prefixes and suffixes to add to the group name. ||
| **CustomBlockedWordsList** | Write | StringArray[] | Comma delimited list of words that should be blocked from being included in groups' names. ||
| **Ensure** | Write | String | Specify if the Azure AD Groups Naming Policy should exist or not. |Present, Absent|
| **GlobalAdminAccount** | Required | PSCredential | Credentials of the Azure Active Directory Admin ||
# AADGroupsNamingPolicy
### Description
This resource configures an Azure Active Directory Group Naming Policy.
## Examples
### Example 1
This example is used to test new resources and showcase the usage of new resources being worked on.
It is not meant to use as a production baseline.
```powershell
Configuration Example
{
param(
[Parameter(Mandatory = $true)]
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
AADGroupsNamingPolicy GroupsNamingPolicy
{
CustomBlockedWordsList = @("CEO", "President");
GlobalAdminAccount = $credsGlobalAdmin;
IsSingleInstance = "Yes";
PrefixSuffixNamingRequirement = "[Title]Test[Company][GroupName][Office]Redmond";
}
}
}
```

59
AADGroupsSettings.md Normal file

@ -0,0 +1,59 @@
# AADGroupsSettings
## Parameters
| Parameter | Attribute | DataType | Description | Allowed Values |
| --- | --- | --- | --- | --- |
| **IsSingleInstance** | Key | String | Only valid value is 'Yes'. |Yes|
| **EnableGroupCreation** | Write | Boolean | The flag indicating whether Office 365 group creation is allowed in the directory by non-admin users. This setting does not require an Azure Active Directory Premium P1 license. ||
| **AllowGuestsToBeGroupOwner** | Write | Boolean | Boolean indicating whether or not a guest user can be an owner of groups. ||
| **AllowGuestsToAccessGroups** | Write | Boolean | Boolean indicating whether or not a guest user can have access to Office 365 groups content. This setting does not require an Azure Active Directory Premium P1 license. ||
| **GuestUsageGuidelinesUrl** | Write | String | The url of a link to the guest usage guidelines. ||
| **GroupCreationAllowedGroupName** | Write | String | Name of the security group for which the members are allowed to create Office 365 groups even when EnableGroupCreation == false. ||
| **AllowToAddGuests** | Write | Boolean | A boolean indicating whether or not is allowed to add guests to this directory. ||
| **UsageGuidelinesUrl** | Write | String | A link to the Group Usage Guidelines. ||
| **Ensure** | Write | String | Specify if the Azure AD Groups Naming Policy should exist or not. |Present, Absent|
| **GlobalAdminAccount** | Required | PSCredential | Credentials of the Azure Active Directory Admin ||
# AADGroupsNamingPolicy
### Description
This resource configures an Azure Active Directory Groups Settings.
## Examples
### Example 1
This example is used to test new resources and showcase the usage of new resources being worked on.
It is not meant to use as a production baseline.
```powershell
Configuration Example
{
param(
[Parameter(Mandatory = $true)]
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
AADGroupsSettings GeneralGroupsSettings
{
AllowGuestsToAccessGroups = $True;
AllowGuestsToBeGroupOwner = $True;
AllowToAddGuests = $True;
EnableGroupCreation = $True;
Ensure = "Present";
GlobalAdminAccount = $credsGlobalAdmin;
GroupCreationAllowedGroupName = "All Company";
GuestUsageGuidelinesUrl = "https://contoso.com/guestusage";
IsSingleInstance = "Yes";
UsageGuidelinesUrl = "https://contoso.com/usage";
}
}
}
```

@ -0,0 +1,51 @@
# AADMSGroupLifecyclePolicy
## Parameters
| Parameter | Attribute | DataType | Description | Allowed Values |
| --- | --- | --- | --- | --- |
| **IsSingleInstance** | Key | String | Only valid value is 'Yes'. |Yes|
| **GroupLifetimeInDays** | Required | UInt32 | The number of days a group can exist before it needs to be renewed. ||
| **ManagedGroupTypes** | Required | String | This parameter allows the admin to select which office 365 groups the policy will apply to. 'None' will create the policy in a disabled state. 'All' will apply the policy to every Office 365 group in the tenant. 'Selected' will allow the admin to choose specific Office 365 groups that the policy will apply to. |All, None, Selected|
| **AlternateNotificationEmails** | Required | StringArray[] | Notification emails for groups that have no owners will be sent to these email addresses. ||
| **Ensure** | Write | String | Specify if the Azure AD Groups Lifecycle Policy should exist or not. |Present, Absent|
| **GlobalAdminAccount** | Required | PSCredential | Credentials of the Azure Active Directory Admin ||
# AADMSGroupLifecyclePolicy
### Description
This resource configures an Azure Active Directory Group Lifecycle Policy (e.g. Expiration).
## Examples
### Example 1
This example is used to test new resources and showcase the usage of new resources being worked on.
It is not meant to use as a production baseline.
```powershell
Configuration Example
{
param(
[Parameter(Mandatory = $true)]
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
AADMSGroupLifecyclePolicy GroupLifecyclePolicy
{
AlternateNotificationEmails = @("john.smith@contoso.com");
Ensure = "Present";
GlobalAdminAccount = $credsGlobalAdmin;
GroupLifetimeInDays = 99;
IsSingleInstance = "Yes";
ManagedGroupTypes = "Selected";
}
}
}
```

@ -50,7 +50,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -32,7 +32,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -37,7 +37,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -92,7 +92,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -29,7 +29,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -64,7 +64,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -64,7 +64,7 @@ Configuration Example
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -48,7 +48,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -42,7 +42,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -29,7 +29,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -36,7 +36,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -34,7 +34,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -41,7 +41,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -37,7 +37,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -45,7 +45,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -42,7 +42,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -54,7 +54,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -32,7 +32,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
Node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -48,7 +48,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -37,7 +37,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -41,7 +41,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
Node localhost
{

@ -32,7 +32,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
Node localhost
{

@ -40,7 +40,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -36,7 +36,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -41,7 +41,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -46,7 +46,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -35,7 +35,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -49,7 +49,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -52,7 +52,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -28,7 +28,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -36,7 +36,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -34,7 +34,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -46,7 +46,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -48,7 +48,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -32,7 +32,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -35,7 +35,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -39,7 +39,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -33,7 +33,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -31,7 +31,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -26,7 +26,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -29,7 +29,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -33,7 +33,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -30,7 +30,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -38,7 +38,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -44,7 +44,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -43,7 +43,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -228,7 +228,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -29,7 +29,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -28,7 +28,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{

@ -29,7 +29,7 @@ Configuration Example
[PSCredential]
$credsGlobalAdmin
)
Import-DscResource -ModuleName Office365DSC
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{