|
| 1 | +--- |
| 2 | +external help file: Microsoft.Exchange.Management.RestApiClient.dll-Help.xml |
| 3 | +Module Name: ExchangeOnlineManagement |
| 4 | +online version: https://docs.microsoft.com/powershell/module/exchange/set-ownerlessgrouppolicy |
| 5 | +applicable: Exchange Online |
| 6 | +title: Set-OwnerlessGroupPolicy |
| 7 | +schema: 2.0.0 |
| 8 | +author: chrisda |
| 9 | +ms.author: chrisda |
| 10 | +--- |
| 11 | + |
| 12 | +# Set-OwnerlessGroupPolicy |
| 13 | + |
| 14 | +## SYNOPSIS |
| 15 | +This cmdlet is available only in the Exchange Online PowerShell V2 module. For more information, see [About the Exchange Online PowerShell V2 module](https://docs.microsoft.com/powershell/exchange/exchange-online-powershell-v2). |
| 16 | + |
| 17 | +**Note**: This cmdlet is available only in version 2.0.5-Preview1 or later of the EXO V2 module. |
| 18 | + |
| 19 | +Use the Set-OwnerlessGroupPolicy cmdlet to modify the ownerless group policy in Exchange Online. |
| 20 | + |
| 21 | +For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax). |
| 22 | + |
| 23 | +## SYNTAX |
| 24 | + |
| 25 | +``` |
| 26 | +Set-OwnerlessGroupPolicy -Enabled <Boolean> -NoOfWeeksToNotify <Int32> -MaxNoOfMembersToNotify <Int32> -SenderEmailAddress <String> |
| 27 | + [-EnabledGroupIds <String[]>] |
| 28 | + [-ResultSize <Unlimited>] |
| 29 | + [<CommonParameters>] |
| 30 | +``` |
| 31 | + |
| 32 | +## DESCRIPTION |
| 33 | +Use this cmdlet to enable or disable the ownerless group policy for Microsoft 365 Groups in your organization. You can also configure additional policy settings, including sender email address, the number of weeks that you want to notify active members of ownerless groups, and the number of members within a ownerless group that you want to notify. Optionally, you can also specify the Microsoft 365 Groups that you want to enable this policy on. |
| 34 | + |
| 35 | +## EXAMPLES |
| 36 | + |
| 37 | +### Example 1 |
| 38 | +```powershell |
| 39 | + Set-OwnerlessGroupPolicy -Enabled $true -SenderEmailAddress [email protected] -NoOfWeeksToNotify 5 -MaxNoOfMembersToNotify 5 -EnabledGroupIds 1b390686-a8fc-4a2d-b31f-62670552fc99, 4596bdbe-d3c9-4d7b-aa34-a811b76a1366 |
| 40 | +``` |
| 41 | + |
| 42 | +This example configures the ownerless group policy with the specified settings. |
| 43 | + |
| 44 | +## PARAMETERS |
| 45 | + |
| 46 | +### -Enabled |
| 47 | +The Enabled parameter enables or disables the ownerless group policy. Valid values are: |
| 48 | + |
| 49 | +- $true: The policy is enabled. |
| 50 | +- $false: The policy is disabled. |
| 51 | + |
| 52 | +```yaml |
| 53 | +Type: Boolean |
| 54 | +Parameter Sets: (All) |
| 55 | +Aliases: |
| 56 | +Applicable: Exchange Online |
| 57 | + |
| 58 | +Required: True |
| 59 | +Position: Named |
| 60 | +Default value: None |
| 61 | +Accept pipeline input: False |
| 62 | +Accept wildcard characters: False |
| 63 | +``` |
| 64 | +
|
| 65 | +### -MaxNoOfMembersToNotify |
| 66 | +The MaxNoOfMembersToNotify parameter specifies the maximum number of active members to notify in a ownerless group. A valid value is an integer from 1 to 90. |
| 67 | +
|
| 68 | +```yaml |
| 69 | +Type: Int32 |
| 70 | +Parameter Sets: (All) |
| 71 | +Aliases: |
| 72 | +Applicable: Exchange Online |
| 73 | + |
| 74 | +Required: True |
| 75 | +Position: Named |
| 76 | +Default value: None |
| 77 | +Accept pipeline input: False |
| 78 | +Accept wildcard characters: False |
| 79 | +``` |
| 80 | +
|
| 81 | +### -NoOfWeeksToNotify |
| 82 | +The NoOfWeeksToNotify parameter specifies the number of weeks to notify the active members specified by the MaxNoOfMembersToNotify parameter. A valid value is an integer from 1 to 7. |
| 83 | +
|
| 84 | +```yaml |
| 85 | +Type: Int32 |
| 86 | +Parameter Sets: (All) |
| 87 | +Aliases: |
| 88 | +Applicable: Exchange Online |
| 89 | + |
| 90 | +Required: True |
| 91 | +Position: Named |
| 92 | +Default value: None |
| 93 | +Accept pipeline input: False |
| 94 | +Accept wildcard characters: False |
| 95 | +``` |
| 96 | +
|
| 97 | +### -SenderEmailAddress |
| 98 | +The SenderEmailAddress specifies the From address to use for notification messages. |
| 99 | +
|
| 100 | +```yaml |
| 101 | +Type: String |
| 102 | +Parameter Sets: (All) |
| 103 | +Aliases: |
| 104 | +Applicable: Exchange Online |
| 105 | + |
| 106 | +Required: True |
| 107 | +Position: Named |
| 108 | +Default value: None |
| 109 | +Accept pipeline input: False |
| 110 | +Accept wildcard characters: False |
| 111 | +``` |
| 112 | +
|
| 113 | +### -EnabledGroupIds |
| 114 | +The EnabledGroupIds parameter specifies a list of groups to enable the policy on if you don't want to enable the policy on all groups in your organization. You can specify a maximum of 10 group GUIDs separated by commas. |
| 115 | +
|
| 116 | +```yaml |
| 117 | +Type: String[] |
| 118 | +Parameter Sets: (All) |
| 119 | +Aliases: |
| 120 | +Applicable: Exchange Online |
| 121 | + |
| 122 | +Required: False |
| 123 | +Position: Named |
| 124 | +Default value: None |
| 125 | +Accept pipeline input: False |
| 126 | +Accept wildcard characters: False |
| 127 | +``` |
| 128 | +
|
| 129 | +### -ResultSize |
| 130 | +This parameter is reserved for internal Microsoft use. |
| 131 | +
|
| 132 | +```yaml |
| 133 | +Type: Unlimited |
| 134 | +Parameter Sets: (All) |
| 135 | +Aliases: |
| 136 | +Applicable: Exchange Online |
| 137 | + |
| 138 | +Required: False |
| 139 | +Position: Named |
| 140 | +Default value: None |
| 141 | +Accept pipeline input: False |
| 142 | +Accept wildcard characters: False |
| 143 | +``` |
| 144 | +
|
| 145 | +### CommonParameters |
| 146 | +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216). |
| 147 | +
|
| 148 | +## INPUTS |
| 149 | +
|
| 150 | +### |
| 151 | +
|
| 152 | +## OUTPUTS |
| 153 | +
|
| 154 | +### |
| 155 | +
|
| 156 | +## NOTES |
| 157 | +
|
| 158 | +## RELATED LINKS |
0 commit comments