Set-TeamsProtectionPolicyRule
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet Set-TeamsProtectionPolicyRule para modificar las reglas de directiva de protección de Microsoft Teams.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default (Es el valor predeterminado).
Set-TeamsProtectionPolicyRule
[-Identity] <RuleIdParameter>
[-Comments <String>]
[-Confirm]
[-ExceptIfRecipientDomainIs <Word[]>]
[-ExceptIfSentTo <RecipientIdParameter[]>]
[-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
[-WhatIf]
[<CommonParameters>]
Description
Importante
Los distintos tipos de excepciones de destinatario usan lógica OR (el destinatario debe satisfacer cualquiera de las excepciones especificadas). Para obtener más información, vea Configurar ZAP para la protección de Teams en Defender para Office 365 plan 2.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs research.contoso.com
En este ejemplo se modifica la regla de directiva de protección de Teams existente excluyendo a los destinatarios del dominio research.contoso.com de ZAP para la protección de Teams.
Parámetros
-Comments
Aplicable: Exchange Online
El parámetro Comments especifica comentarios informativos para la regla como, por ejemplo, la regla que se usa o la forma como ha cambiado con el tiempo. La longitud del comentario no puede superar los 1024 caracteres.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Online
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExceptIfRecipientDomainIs
Aplicable: Exchange Online
El parámetro ExceptIfRecipientDomainIs especifica una excepción a ZAP para la protección de Teams que busca destinatarios de mensajes de Teams con direcciones de correo electrónico en los dominios especificados.
Para reemplazar todos los dominios existentes por los valores especificados, use la sintaxis siguiente: Domain1,Domain2,...DomainN.
Para agregar dominios sin afectar a otros valores existentes, use la sintaxis siguiente:
$DomainsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfRecipientDomainIs
$DomainsAdd += "Domain1","Domain2",..."DomainN"
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $DomainsAdd
Para quitar dominios sin afectar a otros valores existentes, use la sintaxis siguiente:
Ejecute los siguientes comandos para ver la lista existente de valores en orden:
$x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"$d = [System.Collections.ArrayList]($x.ExceptIfRecipientDomainIs)$dEl primer valor de la lista tiene el número de índice 0, el segundo tiene el número de índice 1, etc.
Use el número de índice para especificar el valor que se va a quitar. Por ejemplo, para quitar el séptimo valor de la lista, ejecute los siguientes comandos:
$d.RemoveAt(6)Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfRecipientDomainIs $d
Para vaciar la lista, use el valor $null para este parámetro.
Propiedades del parámetro
| Tipo: | Word[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExceptIfSentTo
Aplicable: Exchange Online
El parámetro ExceptIfSentTo especifica una excepción a ZAP para la protección de Teams que busca destinatarios de mensajes de Teams. Puede usar cualquier valor que identifique de forma exclusiva el destinatario. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre distintivo (DN)
- DN canónico
- GUID
Para reemplazar todos los destinatarios existentes por los valores especificados, use la sintaxis siguiente: "User1","User2",..."UserN".
Para agregar destinatarios sin afectar a otros valores existentes, use la sintaxis siguiente:
$UsersAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentTo
$UsersAdd += "User1","User2",..."UserN"
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $UsersAdd
Para quitar destinatarios sin afectar a otros valores existentes, use la sintaxis siguiente:
Ejecute los siguientes comandos para ver la lista existente de valores en orden:
$x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"$u = [System.Collections.ArrayList]($x.ExceptIfSentTo)$uEl primer valor de la lista tiene el número de índice 0, el segundo tiene el número de índice 1, etc.
Use el número de índice para especificar el valor que se va a quitar. Por ejemplo, para quitar el séptimo valor de la lista, ejecute los siguientes comandos:
$u.RemoveAt(6)Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $u
Para vaciar la lista, use el valor $null para este parámetro.
Propiedades del parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExceptIfSentToMemberOf
Aplicable: Exchange Online
El parámetro ExceptIfSentToMemberOf especifica una excepción a ZAP para la protección de Teams que busca mensajes de Teams enviados a miembros de grupos de distribución o grupos de seguridad habilitados para correo. Puede usar cualquier valor que identifique de forma exclusiva al grupo. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre distintivo (DN)
- DN canónico
- GUID
Para agregar grupos sin afectar a otros valores existentes, use la sintaxis siguiente:
$GroupsAdd = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" | select -Expand ExceptIfSentToMemberOf
$GroupsAdd += "Group1","Group2",..."GroupN"
Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentToMemberOf $GroupsAdd
Para quitar grupos sin afectar a otros valores existentes, use la sintaxis siguiente:
Ejecute los siguientes comandos para ver la lista existente de valores en orden:
$x = Get-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule"$g = [System.Collections.ArrayList]($x.ExceptIfSentToMemberOf)$gEl primer valor de la lista tiene el número de índice 0, el segundo tiene el número de índice 1, etc.
Use el número de índice para especificar el valor que se va a quitar. Por ejemplo, para quitar el séptimo valor de la lista, ejecute los siguientes comandos:
$g.RemoveAt(6)Set-TeamsProtectionPolicyRule -Identity "Teams Protection Policy Rule" -ExceptIfSentTo $g
Si quita el grupo después de crear la regla, no se realiza ninguna excepción para ZAP para Teams para los mensajes que se envían a los miembros del grupo.
Para vaciar la lista, use el valor $null para este parámetro.
Propiedades del parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Online
El parámetro Identity especifica la regla de directiva de protección de Teams que desea modificar. Solo hay una regla de directiva de protección de Teams en una organización denominada Regla de directiva de protección de Teams.
Propiedades del parámetro
| Tipo: | RuleIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Online
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.