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.
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 parametri del cmdlet. I criteri vengono usati per limitare o concedere l'accesso alla funzionalità specificata per utenti, gruppi o l'intero tenant specifici.
- È possibile assegnare fino a 10 criteri per funzionalità. Un altro criterio per funzionalità 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à è abilitata. Se un utente ha più criteri assegnati per una funzionalità (direttamente come utente o membro di un gruppo), si applicano i criteri più restrittivi.
- 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
Default (impostazione predefinita).
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-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.
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 nell Microsoft Entra ID, vedere ID modello di ruolo.
Importante
Microsoft sostiene fortemente il principio dei privilegi minimi. L'assegnazione degli account solo alle autorizzazioni minime necessarie per eseguire le attività consente di ridurre i rischi per la sicurezza e di rafforzare la protezione complessiva dell'organizzazione. Amministratore globale è un ruolo con privilegi elevati che in genere si limita agli scenari di emergenza o quando non è possibile usare un ruolo diverso.
Esempio
Esempio 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone
In 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-f72095d4e9c3
In 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.com
In 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.com
In 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 -ModuleId PeopleSkills -FeatureId ShowAISkills -Name SoftDisableShowAISkillsPolicy -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false -UserIds user1@contoso.com,user2@contoso.com
In questo esempio viene aggiunto un criterio per la funzionalità ShowAISkills in Viva Skills. Il criterio abilita la funzionalità per gli utenti specificati, consente i controlli utente e gli utenti sono stati disattivati per impostazione predefinita (criterio Soft Disable).
Parametri
-Confirm
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Everyone
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-FeatureId
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-GroupIds
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IsFeatureEnabled
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IsUserControlEnabled
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.3.0-Preview1 o successiva.
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à.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IsUserOptedInByDefault
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.8.0-Preview2 o successiva.
Il parametro IsUserOptedInByDefault specifica se gli utenti sono optato per impostazione predefinita dai criteri. I valori validi sono:
- $true: per impostazione predefinita, gli utenti sono optato per il criterio se l'utente non ha impostato una preferenza.
- $false: per impostazione predefinita, gli utenti vengono disattivati dal criterio se l'utente non ha impostato una preferenza.
Questo parametro è facoltativo e può essere usato per ignorare il valore predefinito di consenso esplicito dell'utente impostato nei metadati della funzionalità.
Questo parametro può essere impostato solo quando il parametro IsUserControlEnabled è impostato su $true.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ModuleId
Applicabile: Exchange Online
Il parametro ModuleId consente di specificare il modulo Viva per cui si desidera aggiungere i criteri di funzionalità.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ResultSize
Applicabile: Exchange Online
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UserIds
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.