Set-SPOApplication
Définit ou met à jour une ou plusieurs configurations d’une application SharePoint Embedded.
Syntaxe
Default (Par défaut)
Set-SPOApplication
[-OwningApplicationId] <Guid>
[[-SharingCapability] <SharingCapabilities>]
[[-OverrideTenantSharingCapability] <Boolean>]
[[-ItemMajorVersionLimit] <Int>]
[[-EnableAutoExpirationVersionTrim] <Boolean>]
[[-ExpireVersionsAfterDays] <Int>]
[[-FileTypesForVersionExpiration] <String[]>]
[[-RemoveVersionExpirationFileTypeOverride] <String[]>]
[<CommonParameters>]
Description
Set-SPOApplication L’applet de commande est utilisée pour définir les propriétés de configuration d’une application spécifique, déterminées par le OwningApplicationId.
Vous devez être un administrateur SharePoint Embedded pour exécuter cette applet de commande.
Remarque
La propriété OwningApplicationId pour Microsoft Loop est a187e399-0c36-4b98-8f04-1edc167a0996.
OwningApplicationId pour Microsoft Designer est 5e2795e3-ce8c-4cfb-b302-35fe5cd01597.
Pour inviter des personnes extérieures à votre organisation, assurez-vous que Microsoft Entra B2B est activé.
Exemples
Exemple 1
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $false
Cet exemple désactive la fonctionnalité de remplacement de partage, en alignant les paramètres de partage de cette application SharePoint Embedded sur la capacité de partage de SharePoint Online.
Exemple 2
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability Disabled
Cet exemple active le remplacement, en limitant le partage de fichiers au sein de l’application SharePoint Embedded aux utilisateurs internes de l’entreprise uniquement, quels que soient les paramètres de locataire SharePoint Online plus larges.
Exemple 3
Set-SPOTenant -EnableAzureADB2BIntegration $true
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability ExternalUserandGuestSharing
Cet exemple montre comment activer le partage de fichiers au sein de l’application SharePoint Embedded pour les utilisateurs externes. Notez que l’intégration B2B doit être activée pour autoriser les invitations d’invités aux applications SharePoint Embedded.
Exemple 4
Set-SPOApplication -OwningApplicationId 423poi45 -ItemMajorVersionLimit 1000
Cet exemple définit ItemMajorVersionLimit sur 1000.
Exemple 5
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $true
Cet exemple active le découpage automatique de l’historique des versions pour les conteneurs de l’application. Lorsque le découpage automatique est activé, ExpireVersionsAfterDays ils ItemMajorVersionLimit sont gérés automatiquement et ne peuvent pas être définis en même temps.
Exemple 6
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $false -ItemMajorVersionLimit 500 -ExpireVersionsAfterDays 180
Cet exemple désactive le découpage automatique et définit une stratégie de version manuelle. Quand EnableAutoExpirationVersionTrim est $false, les deux ItemMajorVersionLimit et ExpireVersionsAfterDays doivent être spécifiés.
Exemple 7
Set-SPOApplication -OwningApplicationId 423poi45 -ExpireVersionsAfterDays 365 -FileTypesForVersionExpiration "docx","xlsx"
Cet exemple applique la stratégie d’expiration de version aux types de fichiers spécifiés.
Exemple 8
Set-SPOApplication -OwningApplicationId 423poi45 -RemoveVersionExpirationFileTypeOverride "docx","xlsx"
Cet exemple supprime les remplacements d’expiration de version du type de fichier pour les types de fichiers spécifiés.
RemoveVersionExpirationFileTypeOverride Ne peut être combiné avec aucun autre paramètre de stratégie de version.
Paramètres
-EnableAutoExpirationVersionTrim
Active ou désactive le filtrage automatique de l’historique des versions des fichiers pour les conteneurs de l’application SharePoint Embedded.
-
$true- Les limites de l’historique des versions sont gérées automatiquement.ExpireVersionsAfterDaysetItemMajorVersionLimitne peuvent être spécifiés en même temps. -
$false- Une politique de version manuelle est utilisée. Les deuxItemMajorVersionLimitetExpireVersionsAfterDaysdoivent être spécifiés.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 5 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExpireVersionsAfterDays
Nombre de jours après lequel les versions de fichier expirent. La valeur 0 signifie que les versions n’expirent jamais. Sinon, la valeur doit être comprise entre 30 et 36500. Ce paramètre ne peut pas être utilisé quand est $true.EnableAutoExpirationVersionTrim
Propriétés du paramètre
| Type: | Int |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 6 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FileTypesForVersionExpiration
Types de fichiers dont la stratégie d’expiration de version doit être mise à jour. Le tableau ne peut pas être vide, et au moins un des EnableAutoExpirationVersionTrim, ItemMajorVersionLimitou ExpireVersionsAfterDays doit également être spécifié.
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: | 7 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ItemMajorVersionLimit
Ce paramètre est utilisé pour remplacer ItemMajorVersionLimit pour les types de conteneur. Les valeurs valides sont comprises entre 1 et 50000.
Propriétés du paramètre
| Type: | Int |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-OverrideTenantSharingCapability
Ce paramètre permet à l’application de définir indépendamment ses fonctionnalités de partage, en remplaçant les paramètres de niveau locataire de SharePoint Online. Options :
- False (par défaut) : l’application respecte la fonctionnalité de partage au niveau du locataire
- True : les paramètres de partage de l’application sont indépendants de la fonctionnalité de partage au niveau du locataire
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-OwningApplicationId
Ce paramètre spécifie l’ID de l’application SharePoint Embedded.
Propriétés du paramètre
| Type: | System.Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RemoveVersionExpirationFileTypeOverride
Le type de fichier version expire remplace à supprimer. Le tableau ne peut pas être vide. Ce paramètre est exclusif et ne peut pas être combiné avec FileTypesForVersionExpiration, EnableAutoExpirationVersionTrim, ItemMajorVersionLimitou ExpireVersionsAfterDays.
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: | 8 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SharingCapability
Détermine le niveau de partage disponible pour SharePoint Embedded Application.
Les valeurs valides sont les suivantes :
- ExternalUserAndGuestSharing (par défaut) : le partage d’utilisateurs externes (partage par e-mail) et le partage de liens invités sont tous deux activés.
- Désactivé : le partage d’utilisateurs externes (partage par e-mail) et le partage de liens invités sont tous deux désactivés.
- ExternalUserSharingOnly : le partage d’utilisateurs externes (partage par e-mail) est activé, mais le partage de liens invités est désactivé.
- ExistingExternalUserSharingOnly : seuls les invités figurent déjà dans l’annuaire de votre organisation.
Le paramètre par défaut est Aucun, ce qui signifie que l’application respecte les paramètres de partage au niveau du locataire SharePoint Online. Utilisez l’applet Get-SPOTenant de commande pour afficher ces paramètres.
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.TenantManagement.SharingCapabilities |
| Valeur par défaut: | None |
| Valeurs acceptées: | Disabled, ExternalUserSharingOnly, ExternalUserAndGuestSharing, ExistingExternalUserSharingOnly |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| 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.