Skip to content

Publish main to live 09/27/2024, 3:30 PM #12141

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 18 commits into from
Sep 27, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ The ListType parameter specifies the list to view. Valid values are:
- FileHash
- Sender
- Url
- IP

```yaml
Type: ListType
Expand All @@ -96,6 +97,7 @@ The Entry parameter filters the results based on the ListType parameter value. V
- FileHash: The exact SHA256 file hash value.
- Sender: The exact domain or email address value.
- Url: The exact URL value.
- IP: IPv6 addresses only. Single IPv6 addresses in colon-hexadecimal or zero-compression format or CIDR IPv6 ranges from 1 to 128.

This value is shown in the Value property of the entry in the output of the Get-TenantAllowBlockListItems cmdlet.

Expand Down
19 changes: 16 additions & 3 deletions exchange/exchange-ps/exchange/New-TenantAllowBlockListItems.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,16 +82,27 @@ The Entries parameter specifies the values that you want to add to the Tenant Al
- FileHash: Use the SHA256 hash value of the file. In Windows, you can find the SHA256 hash value by running the following command in a Command Prompt: `certutil.exe -hashfile "<Path>\<Filename>" SHA256`. An example value is `768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3`.
- Sender: A domain or email address value. For example, `contoso.com` or `michelle@contoso.com`.
- URL: Use IPv4 or IPv6 addresses or hostnames. Wildcards (* and ~) are supported in hostnames. Protocols, TCP/UDP ports, or user credentials are not supported. For details, see [URL syntax for the Tenant Allow/Block List](https://learn.microsoft.com/defender-office-365/tenant-allow-block-list-urls-configure#url-syntax-for-the-tenant-allowblock-list).
- IP: IPv6 addresses only:

• Single IPv6 addresses in colon-hexadecimal format (for example, 2001:0db8:85a3:0000:0000:8a2e:0370:7334).

• Single IPv6 addresses in zero-compression format (for example, 2001:db8::1 for 2001:0db8:0000:0000:0000:0000:0000:0001).

• CIDR IPv6 ranges from 1 to 128 (for example, 2001:0db8::/32).

To enter multiple values, use the following syntax: `"Value1","Value2",..."ValueN"`.

For senders, files, and URLs the maximum number of allow entries for each type is 500, and the maximum number of block entries for each type is 500 (1000 entries total for each type).
Entry limits for each list subtype (sender, URL, file, or IP address):

- **Exchange Online Protection**: The maximum number of allow entries is 500, and the maximum number of block entries is 500.
- **Defender for Office 365 Plan 1**: The maximum number of allow entries is 1000, and the maximum number of block entries is 1000.
- **Defender for Office 365 Plan 2**: The maximum number of allow entries is 5000, and the maximum number of block entries is 10000.

The maximum number of characters in a file entry is 64 and the maximum number of characters in a URL entry is 250.

You can't mix value types (file, sender, or URL) or allow and block actions in the same command.
You can't mix value types (sender, URL, file, or IP address) or allow and block actions in the same command.

In most cases, you can't modify the URL, file, or sender values after you create the entry. The only exception is allow URL entries for phishing simulations (ListType = URL, ListSubType = AdvancedDelivery).
In most cases, you can't modify the sender, URL, file, or IP address values after you create the entry. The only exception is URL allow entries for phishing simulations (ListType = URL, ListSubType = AdvancedDelivery).

```yaml
Type: String[]
Expand Down Expand Up @@ -135,6 +146,7 @@ The ListType parameter specifies the type of entry to add. Valid values are:
- FileHash
- Sender
- Url
- IP

```yaml
Type: ListType
Expand All @@ -156,6 +168,7 @@ This switch is available to use in the following scenarios:

- With the Block switch.
- With the Allow switch where the ListType parameter value is URL and the ListSubType parameter value is AdvancedDelivery.
- With the Allow switch where the ListType parameter value is IP.

You can't use this switch with the ExpirationDate or RemoveAfter parameter.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,10 +63,11 @@ The Entries parameter specifies the entries that you want to remove based on the
- FileHash: The exact SHA256 file hash value.
- Sender domains and email addresses: The exact domain or email address value.
- Url: The exact URL value.
- IP: IPv6 addresses only. Single IPv6 addresses in colon-hexadecimal or zero-compression format or CIDR IPv6 ranges from 1 to 128.

This value is shown in the Value property of the entry in the output of the Get-TenantAllowBlockListItems cmdlet.

You can't mix value types (file, sender, or URL) or allow and block actions in the same command.
You can't mix value types (sender, URL, file, or IP address) or allow and block actions in the same command.

You can't use this parameter with the Ids parameter.

Expand Down Expand Up @@ -109,6 +110,7 @@ The ListType parameter specifies the type of entry that you want to remove. Vali
- FileHash
- Sender
- Url
- IP

```yaml
Type: ListType
Expand Down
12 changes: 9 additions & 3 deletions exchange/exchange-ps/exchange/Set-TenantAllowBlockListItems.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Set-TenantAllowBlockListItems -Entries <String[]> -ListType <ListType>
```

## DESCRIPTION
In most cases, you can't modify the URL, file, or sender values of an existing entry. The only exception is allow URL entries for phishing simulations (Action = Allow, ListType = URL, and ListSubType = AdvancedDelivery). For more information about allowing URLs for phishing simulations, see [Configure the advanced delivery policy for third-party phishing simulations and email delivery to SecOps mailboxes](https://learn.microsoft.com/defender-office-365/advanced-delivery-policy-configure).
In most cases, you can't modify the sender, URL, file, or IP address values after you create the entry. The only exception is URL allow entries for phishing simulations (ListType = URL, ListSubType = AdvancedDelivery). For more information about allowing URLs for phishing simulations, see [Configure the advanced delivery policy for third-party phishing simulations and email delivery to SecOps mailboxes](https://learn.microsoft.com/defender-office-365/advanced-delivery-policy-configure).

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://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).

Expand Down Expand Up @@ -77,10 +77,11 @@ The Entries parameter specifies the entries that you want to modify based on the
- FileHash: The exact SHA256 file hash value.
- Sender domains and email addresses: The exact domain or email address value.
- Url: The exact URL value.
- IP: IPv6 addresses only. Single IPv6 addresses in colon-hexadecimal or zero-compression format or CIDR IPv6 ranges from 1 to 128.

This value is shown in the Value property of the entry in the output of the Get-TenantAllowBlockListItems cmdlet.

You can't mix value types (file, sender, or URL) or allow and block actions in the same command.
You can't mix value types (sender, URL, file, or IP address) or allow and block actions in the same command.

You can't use this parameter with the Ids parameter.

Expand Down Expand Up @@ -122,6 +123,7 @@ The ListType parameter specifies the type of entry that you want to modify. Vali
- FileHash
- Sender
- Url
- IP

Use the Entries or Ids parameter with this parameter to identify the entry itself.

Expand All @@ -141,7 +143,11 @@ Accept wildcard characters: False
### -NoExpiration
The NoExpiration switch specifies that the entry should never expire. You don't need to specify a value with this switch.

This switch is available to use with block entries or with url allow entries where the ListSubType parameter value is AdvancedDelivery.
This switch is available to use with the following types of entries:

- Block entries.
- URL allow entries where the ListSubType parameter value is AdvancedDelivery.
- IP address allow entries.

You can't use this switch with the ExpirationDate parameter.

Expand Down
39 changes: 36 additions & 3 deletions teams/teams-ps/teams/Get-CsTeamsAIPolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@ Get-CsTeamsAIPolicy

## DESCRIPTION

The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs.

This cmdlet retrieves all Teams AI policies for current tenant.

## EXAMPLES
Expand All @@ -36,6 +38,37 @@ Retrieves Teams AI policies, shows "EnrollFace" and "EnrollVoice" values.

## PARAMETERS

### -Identity
Identity of the Teams AI policy.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Filter
Enables you to use wildcard characters when indicating the policy (or policies) to be returned.
To return a collection of all the per-user policies, use this syntax: -Filter "tag:*".

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters
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/?LinkID=113216).

Expand All @@ -47,8 +80,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable

[New-CsTeamsAIPolicy](New-CsTeamsAIPolicy.md)

[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.yml)
[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.md)

[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.yml)
[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.md)

[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.yml)
[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.md)
8 changes: 5 additions & 3 deletions teams/teams-ps/teams/Grant-CsTeamsAIPolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@ Grant-CsTeamsAIPolicy [[-PolicyName] <String>] [-Global] [-Force] [<CommonParame

## DESCRIPTION

The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs.

This cmdlet applies an instance of the Teams AI policy to users or groups in a tenant.

Passes in the `Identity` of the policy instance in the `PolicyName` parameter and the user identifier in the `Identity` parameter or the group name in the `Group` parameter. One of either `Identity` or `Group` needs to be passed.
Expand Down Expand Up @@ -183,8 +185,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable

[New-CsTeamsAIPolicy](New-CsTeamsAIPolicy.md)

[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.yml)
[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.md)

[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.yml)
[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.md)

[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.yml)
[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.md)
42 changes: 37 additions & 5 deletions teams/teams-ps/teams/New-CsTeamsAIPolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@ New-CsTeamsAIPolicy -Identity <String>
```

## DESCRIPTION

The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs.

This cmdlet creates a Teams AI policy. If you get an error that the policy already exists, it means that the policy already exists for your tenant. In this case, run Get-CsTeamsAIPolicy.

## EXAMPLES
Expand All @@ -33,7 +36,6 @@ PS C:\> New-CsTeamsAIPolicy -Identity Test
Creates a new Teams AI policy with the specified identity.
The newly created policy with value will be printed on success.


## PARAMETERS

### -Identity
Expand All @@ -51,15 +53,45 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -EnrollFace
Policy value of the Teams AI EnrollFace policy. EnrollFace controls user access to user face enrollment in the Teams app settings.

```yaml
Type: Boolean
Parameter Sets: ("Enabled","Disabled")
Aliases:

Required: True
Position: Named
Default value: Enabled
Accept pipeline input: False
Accept wildcard characters: False
```

### -EnrollVoice
Policy value of the Teams AI EnrollVoice policy. EnrollVoice controls user access to user voice enrollment in the Teams app settings.

```yaml
Type: Boolean
Parameter Sets: ("Enabled","Disabled")
Aliases:

Required: True
Position: Named
Default value: Enabled
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters
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/?LinkID=113216).


## RELATED LINKS
[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.yml)
[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.md)

[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.yml)
[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.md)

[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.yml)
[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.md)

[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.yml)
[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.md)
10 changes: 6 additions & 4 deletions teams/teams-ps/teams/Remove-CsTeamsAIPolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,13 @@ This cmdlet deletes a Teams AI policy.
## SYNTAX

```
Remove-CsTeamsAIPolicy -Identity <String>
Remove-CsTeamsAIPolicy -Identity <String>
```

## DESCRIPTION

The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs.

This cmdlet deletes a Teams AI policy with the specified identity string.

## EXAMPLES
Expand Down Expand Up @@ -62,8 +64,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable

[New-CsTeamsAIPolicy](New-CsTeamsAIPolicy.md)

[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.yml)
[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.md)

[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.yml)
[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.md)

[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.yml)
[Set-CsTeamsAIPolicy](Set-CsTeamsAIPolicy.md)
8 changes: 5 additions & 3 deletions teams/teams-ps/teams/Set-CsTeamsAIPolicy.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ Set-CsTeamsAIPolicy

## DESCRIPTION

The new csTeamsAIPolicy will replace the existing enrollment settings in csTeamsMeetingPolicy, providing enhanced flexibility and control for Teams meeting administrators. Unlike the current single setting, EnrollUserOverride, which applies to both face and voice enrollment, the new policy introduces two distinct settings: EnrollFace and EnrollVoice. These can be individually set to Enabled or Disabled, offering more granular control over biometric enrollments. In addition to improving the management of face and voice data, the csTeamsAIPolicy is designed to support future AI-related settings in Teams, making it a scalable solution for evolving needs.

This cmdlet sets the Teams AI policy EnrollFace and EnrollVoice value for the tenant. The values of EnrollFace and EnrollVoice can be set to "Enabled" or "Disabled".

## EXAMPLES
Expand Down Expand Up @@ -114,8 +116,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable

[New-CsTeamsAIPolicy](New-CsTeamsAIPolicy.md)

[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.yml)
[Remove-CsTeamsAIPolicy](Remove-CsTeamsAIPolicy.md)

[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.yml)
[Get-CsTeamsAIPolicy](Get-CsTeamsAIPolicy.md)

[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.yml)
[Grant-CsTeamsAIPolicy](Grant-CsTeamsAIPolicy.md)
Loading