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: il supporto per le categorie è disponibile nella versione 3.5.0-Preview2 o successiva del modulo, ma non sono attualmente disponibili categorie in Viva. La documentazione verrà aggiornata quando le categorie sono disponibili.
Usare il cmdlet Add-VivaModuleFeaturePolicy per aggiungere un nuovo criterio di accesso per una funzionalità specifica o una categoria in Viva. Gli attributi dei criteri vengono definiti usando i parametri del cmdlet. I criteri vengono usati per limitare o concedere l'accesso alla funzionalità o alla categoria specificata per utenti, gruppi o l'intero tenant specifici.
- È possibile assegnare fino a 10 criteri per funzionalità/categoria. Un altro criterio per funzionalità/categoria può essere assegnato all'intero tenant.
- I criteri assegnati a un utente o a un gruppo specifico hanno la priorità sui criteri assegnati all'intero tenant quando si determina se una funzionalità o una categoria è abilitata. Se a un utente sono assegnati più criteri per una funzionalità o una categoria (direttamente come utente o membro di un gruppo), si applicano i criteri più restrittivi.
- Se una categoria è disabilitata dai criteri di categoria, tutte le funzionalità della categoria vengono disabilitate indipendentemente dai criteri impostati a livello di funzionalità.
- È possibile aggiornare i controlli utente solo a livello di criteri di funzionalità, non a livello di criteri di categoria.
- Alcune funzionalità supportano solo criteri che si applicano all'intero tenant, non a utenti o gruppi specifici. È possibile fare riferimento agli ambiti dei criteri supportati per una funzionalità usando il cmdlet Get-VivaModuleFeature .
Alcune funzionalità includono l'opzione per i controlli utente (rifiuto esplicito dell'utente). Fare riferimento alla documentazione della funzionalità per verificare se i controlli utente sono disponibili per la funzionalità per cui si intende impostare un criterio.
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]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Add-VivaModuleFeaturePolicy
-CategoryId <String>
-IsCategoryEnabled <Boolean>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Descrizione
Usare il cmdlet Add-VivaModuleFeaturePolicy per aggiungere un nuovo criterio di accesso per una funzionalità o una categoria specifica in Viva.
Il supporto per le categorie è disponibile nella versione 3.5.0-Preview2 o successiva del modulo.
È necessario usare il cmdlet Connect-ExchangeOnline per eseguire l'autenticazione.
Questo cmdlet richiede .NET Framework 4.7.2 o versione successiva.
Attualmente, è necessario essere un membro del ruolo Amministratori globali o i ruoli assegnati a livello di funzionalità per eseguire questo cmdlet.
Per altre informazioni sui ruoli assegnati a livello di funzionalità, vedere Funzionalità disponibili per la gestione degli accessi alle funzionalità.
Per altre informazioni sulle autorizzazioni del ruolo di amministratore in Microsoft Entra ID, vedere ID modello di ruolo.
Importante
Microsoft consiglia di usare i ruoli con il minor numero di autorizzazioni. L'uso di account con autorizzazioni inferiori consente di migliorare la sicurezza per l'organizzazione. Amministratore globale è un ruolo con privilegi elevati che deve essere limitato agli scenari di emergenza quando non è possibile usare un ruolo esistente.
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.com,57680382-61a5-4378-85ad-f72095d4e9c3In 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,57680382-61a5-4378-85ad-f72095d4e9c3 -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.
Esempio 5
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -EveryoneIn questo esempio vengono aggiunti criteri per la <category_id> categoria in Viva. Il criterio disabilita la categoria (in effetti tutte le funzionalità della categoria) per tutti gli utenti dell'organizzazione.
Esempio 6
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3In questo esempio vengono aggiunti criteri per la <category_id> categoria in Viva. Il criterio disabilita la categoria (in effetti tutte le funzionalità della categoria) per tutti gli utenti nei gruppi specificati.
Esempio 7
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.comIn questo esempio vengono aggiunti criteri per la <category_id> categoria in Viva. Il criterio disabilita la categoria (in effetti tutte le funzionalità della categoria) per gli utenti specificati.
Esempio 8
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name UsersAndGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comIn questo esempio vengono aggiunti criteri per la <category_id> categoria in Viva. Il criterio disabilita la categoria (in effetti tutte le funzionalità della categoria) per gli utenti e i membri del gruppo specificati.
Esempio 9
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -EveryoneIn questo esempio viene aggiunto un criterio per la <category_id> categoria in Viva in cui il nome del criterio è con spazi. Il criterio disabilita la categoria (in effetti tutte le funzionalità della categoria) per tutti gli utenti dell'organizzazione.
Parametri
-CategoryId
Questo parametro è disponibile nella versione 3.5.0-Preview2 o successiva del modulo.
Nota: attualmente non sono disponibili categorie in Viva. La documentazione verrà aggiornata quando le categorie sono disponibili.
Il parametro CategoryId specifica la categoria Viva per cui si desidera aggiungere i criteri.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.
Questo cmdlet ha una pausa predefinita, quindi usare -Confirm:$false per ignorare la conferma.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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à di 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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-GroupIds
Il parametro GroupIds consente di specificare gli indirizzi di posta elettronica o gli ID oggetto gruppo di sicurezza (GUID) dei gruppi a cui si applicano i criteri aggiornati. Sono supportati i gruppi di Microsoft Entra abilitati alla posta elettronica e non abilitati alla 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.
Nota: nella versione 3.5.1-Preview2 o successiva del modulo questo parametro supporta gli ID oggetto gruppo di sicurezza (GUID). Le versioni precedenti del modulo accettano solo indirizzi di posta elettronica per questo parametro.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-IsCategoryEnabled
Questo parametro è disponibile nella versione 3.5.0-Preview2 o successiva del modulo.
Nota: attualmente non sono disponibili categorie in Viva. La documentazione verrà aggiornata quando le categorie sono disponibili.
Il parametro IsCategoryEnabled specifica se la categoria è abilitata o meno dai criteri. I valori validi sono:
- $true: la categoria è abilitata dai criteri.
- $false: la categoria non è abilitata dai criteri.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-IsUserControlEnabled
Questo parametro è disponibile nella versione 3.3.0 o successiva del modulo.
Il parametro IsUserControlEnabled specifica se il controllo utente è abilitato dai criteri. I valori validi sono:
- $true: il controllo utente è abilitato dai criteri. Gli utenti possono rifiutare esplicitamente la funzionalità.
- $false: il controllo utente non è abilitato dai criteri. Gli utenti non possono scegliere la funzionalità.
Solo le funzionalità che consentono agli amministratori di abilitare e disabilitare i controlli utente in base ai criteri possono usare questo parametro. Se la funzionalità non supporta gli amministratori che attivano l'attivazione/ disattivazione dei controlli utente, viene applicato il valore predefinito. Per altre informazioni, vedere la documentazione sulle funzionalità.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ModuleId
Il parametro ModuleId consente di specificare il modulo Viva per cui si desidera aggiungere i criteri di funzionalità.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |
-ResultSize
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Tipo: | Unlimited |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Online |