New-TeamsProtectionPolicy
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet New-TeamsProtectionPolicy para crear directivas de protección de Microsoft Teams.
Nota: Si la directiva ya existe (el cmdlet Get-TeamsProtectionPolicy devuelve la salida), no puede usar este cmdlet.
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 (valor predeterminado)
New-TeamsProtectionPolicy
[-Name] <String>
[-Confirm]
[-HighConfidencePhishQuarantineTag <String>]
[-MalwareQuarantineTag <String>]
[-Organization <OrganizationIdParameter>]
[-WhatIf]
[-ZapEnabled <Boolean>]
[<CommonParameters>]
Description
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
New-TeamsProtectionPolicy -Name "Teams Protection Policy"
En este ejemplo se crea la directiva de protección de Teams con los valores predeterminados.
Parámetros
-Confirm
Aplicable: Exchange Online
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 de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-HighConfidencePhishQuarantineTag
Aplicable: Exchange Online
El parámetro HighConfidencePhishQuarantineTag especifica la directiva de cuarentena que se usa para los mensajes que zap para Teams pone en cuarentena como suplantación de identidad de alta confianza. Puede usar cualquier valor que identifique de forma única la directiva de cuarentena. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Las directivas de cuarentena definen lo que los usuarios pueden hacer para los mensajes en cuarentena y si los usuarios reciben notificaciones de cuarentena. Para obtener más información sobre las directivas de cuarentena, consulte Directivas de cuarentena.
Si no usa este parámetro, la directiva de cuarentena predeterminada que se usa se denomina AdminOnlyAccessPolicy. Para obtener más información sobre esta directiva de cuarentena, consulte Anatomía de una directiva de cuarentena.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MalwareQuarantineTag
Aplicable: Exchange Online
El parámetro MalwareQuarantineTag especifica la directiva de cuarentena que se usa para los mensajes que ZAP para Teams pone en cuarentena como malware. Puede usar cualquier valor que identifique de forma única la directiva de cuarentena. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Las directivas de cuarentena definen lo que los usuarios pueden hacer para los mensajes en cuarentena y si los usuarios reciben notificaciones de cuarentena. Para obtener más información sobre las directivas de cuarentena, consulte Directivas de cuarentena.
Si no usa este parámetro, la directiva de cuarentena predeterminada que se usa se denomina AdminOnlyAccessPolicy. Para obtener más información sobre esta directiva de cuarentena, consulte Anatomía de una directiva de cuarentena.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Aplicable: Exchange Online
El parámetro Name especifica el nombre único de la directiva de protección de Teams. Si el valor contiene espacios, escríbalo entre comillas. El nombre predeterminado de la directiva de protección de Teams en una organización es Directiva de protección de Teams. Se recomienda usar este valor.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Organization
Aplicable: Exchange Online
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | OrganizationIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| 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 de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ZapEnabled
Aplicable: Exchange Online
El parámetro ZapEnabled especifica si se debe habilitar la purga automática de cero horas (ZAP) para el malware y los mensajes de suplantación de identidad de alta confianza en los mensajes de Teams. Los valores admitidos son:
- $true: ZAP para malware y mensajes de suplantación de identidad de alta confianza en Teams está habilitado. Este valor es el predeterminado.
- $false: ZAP para malware y mensajes de suplantación de identidad de alta confianza en Teams está deshabilitado.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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.