Add-VivaModuleFeaturePolicy
Questo cmdlet è disponibile solo nel modulo Exchange Online PowerShell versione 3.2.0 o successiva. Per altre informazioni, vedere Informazioni sul modulo Exchange Online PowerShell.
Nota: questo cmdlet fa parte di una funzionalità attualmente disponibile in un'anteprima privata chiusa. Il cmdlet non funzionerà a meno che l'organizzazione non sia membro dell'anteprima privata.
Usare il cmdlet Add-VivaModuleFeaturePolicy per aggiungere un nuovo criterio di accesso per una funzionalità specifica in Viva. Gli attributi dei criteri vengono definiti usando i vari parametri del cmdlet. I criteri vengono usati per limitare o concedere l'accesso alla funzionalità specificata per utenti, gruppi o l'intero tenant specifici. Si noti che i criteri più restrittivi per un determinato utente o gruppo hanno la priorità quando si determina se una funzionalità è abilitata.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-GroupIds <String[]>]
[-UserIds <String[]>]
[-Everyone]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>] Descrizione
Usare il cmdlet Add-VivaModuleFeaturePolicy per aggiungere un nuovo criterio di accesso per una funzionalità specifica in Viva.
È necessario usare il cmdlet Connect-ExchangeOnline per eseguire l'autenticazione.
Questo cmdlet richiede .NET Framework 4.7.2 o versione successiva.
Per eseguire questo cmdlet, è attualmente necessario essere membri del ruolo Amministratori globali.
Per altre informazioni sulle autorizzazioni dei ruoli di amministratore in Azure Active Directory, vedere ID modello di ruolo.
Esempio
Esempio 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -EveryoneIn questo esempio viene aggiunto un criterio per la funzionalità Reflection in Viva Insights. Il criterio disabilita la funzionalità per tutti gli utenti dell'organizzazione.
Esempio 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.comIn questo esempio viene aggiunto un criterio per la funzionalità Reflection in Viva Insights. Il criterio disabilita la funzionalità per tutti gli utenti nei gruppi specificati.
Esempio 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.comIn questo esempio viene aggiunto un criterio per la funzionalità Reflection in Viva Insights. Il criterio disabilita la funzionalità per gli utenti specificati.
Esempio 4
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com -UserIds user1@contoso.com,user2@contoso.comIn questo esempio viene aggiunto un criterio per la funzionalità Reflection in Viva Insights. Il criterio disabilita la funzionalità per gli utenti e i membri del gruppo specificati.
Parametri
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Everyone
L'opzione Everyone specifica che i criteri si applicano a tutti gli utenti dell'organizzazione. Con questa opzione non è necessario specificare alcun valore.
Non usare questa opzione con i parametri GroupIds o UserIds.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-FeatureId
Il parametro FeatureId consente di specificare la funzionalità nel modulo Viva per cui si desidera aggiungere i criteri.
Per visualizzare i dettagli sulle funzionalità in un modulo Viva che supportano i controlli di accesso alle funzionalità, usare il cmdlet Get-VivaModuleFeature. Il valore FeatureId viene restituito nell'output del cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupIds
Il parametro GroupIds consente di specificare gli indirizzi SMTP (indirizzi di posta elettronica) dei gruppi a cui si applicano i criteri. Sono supportati i gruppi AAD abilitati per la posta elettronica. È possibile immettere più valori separati da virgole.
È possibile specificare un massimo di 20 utenti o gruppi totali (20 utenti e nessun gruppo, 10 utenti e 10 gruppi e così via).
Per applicare i criteri a tutti gli utenti dell'organizzazione, usare il commutatore Everyone.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsFeatureEnabled
Il parametro IsFeatureEnabled consente di specificare se la funzionalità è abilitata o meno dal criterio. I valori validi sono:
- $true: la funzionalità è abilitata dai criteri.
- $false: la funzionalità non è abilitata dai criteri.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
Il parametro ModuleId specifica il modulo Viva per cui si desidera aggiungere i criteri di funzionalità.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Il parametro Name consente di specificare il nome dei criteri. La lunghezza massima è 256 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
I caratteri validi sono lettere, numeri, virgole, punti e spazi inglesi.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserIds
Il parametro UserIds consente di specificare i nomi dell'entità utente (UPN) degli utenti a cui si applicano i criteri. È possibile immettere più valori separati da virgole.
È possibile specificare un massimo di 20 utenti o gruppi totali (20 utenti e nessun gruppo, 10 utenti e 10 gruppi e così via).
Per applicare i criteri a tutti gli utenti dell'organizzazione, usare il commutatore Everyone.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
Collegamenti correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per