|
| 1 | +--- |
| 2 | +external help file: Microsoft.Exchange.TransportMailControl-Help.xml |
| 3 | +online version: https://docs.microsoft.com/powershell/module/exchange/get-configanalyzerpolicyrecommendation |
| 4 | +applicable: Exchange Online, Exchange Online Protection |
| 5 | +title: Get-ConfigAnalyzerPolicyRecommendation |
| 6 | +schema: 2.0.0 |
| 7 | +author: chrisda |
| 8 | +ms.author: chrisda |
| 9 | +ms.reviewer: |
| 10 | +monikerRange: "exchonline-ps || eop-ps" |
| 11 | +--- |
| 12 | +# Get-ConfigAnalyzerPolicyRecommendation |
| 13 | + |
| 14 | +## SYNOPSIS |
| 15 | +This cmdlet is available only in the cloud-based service. |
| 16 | + |
| 17 | +Use the Get-ConfigAnalyzerPolicyRecommendation cmdlet to policies (and the corresponding users) who have settings configured that fall below the suggested values for Standard and Strict preset security policies. |
| 18 | + |
| 19 | +**Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Use the Exchange Online PowerShell V2 module](https://docs.microsoft.com/powershell/exchange/exchange-online-powershell-v2). |
| 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 | +Get-ConfigAnalyzerPolicyRecommendation -RecommendedPolicyType <RecommendedPolicyType> |
| 27 | + [[-Identity] <ConfigAnalyzerPolicyRecommendationIdParameter>] |
| 28 | + [-IsAppliedToDisabled] |
| 29 | + [<CommonParameters>] |
| 30 | +``` |
| 31 | + |
| 32 | +## DESCRIPTION |
| 33 | +You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions). |
| 34 | + |
| 35 | +## EXAMPLES |
| 36 | + |
| 37 | +### Example 1 |
| 38 | +```powershell |
| 39 | +Get-ConfigAnalyzerPolicyRecommendation -RecommendedPolicyType Strict |
| 40 | +``` |
| 41 | + |
| 42 | +{{ Add example description here }} |
| 43 | + |
| 44 | +## PARAMETERS |
| 45 | + |
| 46 | +### -RecommendedPolicyType |
| 47 | +The RecommendedPolicyType parameter specifies the preset security policy. Valid values are: |
| 48 | + |
| 49 | +- Standard |
| 50 | +- Strict |
| 51 | + |
| 52 | +```yaml |
| 53 | +Type: RecommendedPolicyType |
| 54 | +Parameter Sets: (All) |
| 55 | +Aliases: |
| 56 | +Applicable: Exchange Online, Exchange Online Protection |
| 57 | + |
| 58 | +Required: True |
| 59 | +Position: Named |
| 60 | +Default value: None |
| 61 | +Accept pipeline input: False |
| 62 | +Accept wildcard characters: False |
| 63 | +``` |
| 64 | +
|
| 65 | +### -Identity |
| 66 | +This parameter is reserved for internal Microsoft use. |
| 67 | +
|
| 68 | +```yaml |
| 69 | +Type: ConfigAnalyzerPolicyRecommendationIdParameter |
| 70 | +Parameter Sets: (All) |
| 71 | +Aliases: |
| 72 | +Applicable: Exchange Online, Exchange Online Protection |
| 73 | + |
| 74 | +Required: False |
| 75 | +Position: 0 |
| 76 | +Default value: None |
| 77 | +Accept pipeline input: True (ByPropertyName, ByValue) |
| 78 | +Accept wildcard characters: False |
| 79 | +``` |
| 80 | +
|
| 81 | +### -IsAppliedToDisabled |
| 82 | +The IsAppliedToDisabled switch filters the results by policies that aren't applied to anyone. You don't need to specify a value with this switch. |
| 83 | +
|
| 84 | +If you don't use this switch, the results include policies that are applied to users and policies that aren't applied to anyone. |
| 85 | +
|
| 86 | +```yaml |
| 87 | +Type: SwitchParameter |
| 88 | +Parameter Sets: (All) |
| 89 | +Aliases: |
| 90 | +Applicable: Exchange Online, Exchange Online Protection |
| 91 | + |
| 92 | +Required: False |
| 93 | +Position: Named |
| 94 | +Default value: None |
| 95 | +Accept pipeline input: False |
| 96 | +Accept wildcard characters: False |
| 97 | +``` |
| 98 | +
|
| 99 | +### CommonParameters |
| 100 | +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). |
| 101 | +
|
| 102 | +## INPUTS |
| 103 | +
|
| 104 | +### |
| 105 | +
|
| 106 | +## OUTPUTS |
| 107 | +
|
| 108 | +### |
| 109 | +
|
| 110 | +## NOTES |
| 111 | +
|
| 112 | +## RELATED LINKS |
| 113 | +
|
0 commit comments