New-TeamsProtectionPolicy
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez l’applet de commande New-TeamsProtectionPolicy pour créer des stratégies de protection Microsoft Teams.
Remarque : si la stratégie existe déjà (l’applet de commande Get-TeamsProtectionPolicy renvoie la sortie), vous ne pouvez pas utiliser cette applet de commande.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
New-TeamsProtectionPolicy
[-Name] <String>
[-Confirm]
[-HighConfidencePhishQuarantineTag <String>]
[-MalwareQuarantineTag <String>]
[-Organization <OrganizationIdParameter>]
[-WhatIf]
[-ZapEnabled <Boolean>]
[<CommonParameters>]
Description
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
New-TeamsProtectionPolicy -Name "Teams Protection Policy"
Cet exemple crée la stratégie de protection Teams avec les valeurs par défaut.
Paramètres
-Confirm
Applicable : Exchange Online
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-HighConfidencePhishQuarantineTag
Applicable : Exchange Online
Le paramètre HighConfidencePhishQuarantineTag spécifie la stratégie de quarantaine utilisée pour les messages mis en quarantaine en tant qu’hameçonnage à haut niveau de confiance par ZAP for Teams. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie de quarantaine. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Les stratégies de quarantaine définissent ce que les utilisateurs sont en mesure de faire pour les messages mis en quarantaine et si les utilisateurs reçoivent des notifications de quarantaine. Pour plus d’informations sur les stratégies de quarantaine, consultez Stratégies de quarantaine.
Si vous n’utilisez pas ce paramètre, la stratégie de quarantaine par défaut utilisée est nommée AdminOnlyAccessPolicy. Pour plus d’informations sur cette stratégie de quarantaine, voir Anatomie d’une stratégie de quarantaine.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MalwareQuarantineTag
Applicable : Exchange Online
Le paramètre MalwareQuarantineTag spécifie la stratégie de quarantaine utilisée pour les messages mis en quarantaine en tant que programmes malveillants par ZAP pour Teams. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie de quarantaine. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Les stratégies de quarantaine définissent ce que les utilisateurs sont en mesure de faire pour les messages mis en quarantaine et si les utilisateurs reçoivent des notifications de quarantaine. Pour plus d’informations sur les stratégies de quarantaine, consultez Stratégies de quarantaine.
Si vous n’utilisez pas ce paramètre, la stratégie de quarantaine par défaut utilisée est nommée AdminOnlyAccessPolicy. Pour plus d’informations sur cette stratégie de quarantaine, voir Anatomie d’une stratégie de quarantaine.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Online
Le paramètre Nom spécifie le nom unique de la stratégie de protection Teams. Si la valeur contient des espaces, mettez le nom entre guillemets. Le nom par défaut de la stratégie de protection Teams dans une organisation est Stratégie de protection Teams. Nous vous recommandons d’utiliser cette valeur.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Organization
Applicable : Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | OrganizationIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online
Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ZapEnabled
Applicable : Exchange Online
Le paramètre ZapEnabled spécifie s’il faut activer la purge automatique zero-hour (ZAP) pour les messages de programme malveillant et de phishing à haut niveau de confiance dans les messages Teams. Les valeurs valides sont les suivantes :
- $true : ZAP pour les programmes malveillants et les messages d’hameçonnage à haut niveau de confiance dans Teams est activé. Cette valeur est la valeur par défaut.
- $false : ZAP pour les programmes malveillants et les messages d’hameçonnage à haut niveau de confiance dans Teams est désactivé.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.