Add-VivaModuleFeaturePolicy
Questo cmdlet è disponibile solo nel modulo PowerShell di Exchange Online versione 3.2.0 o successiva. Per ulteriori informazioni, vedere Informazioni sul modulo PowerShell di Exchange Online.
Usa il cmdlet Add-VivaModuleFeaturePolicy per aggiungere un nuovo criterio di accesso per una funzione specifica in Viva. Gli attributi del criterio vengono definiti utilizzando i parametri del cmdlet. I criteri vengono usati per limitare o concedere l'accesso alla funzionalità specificata a utenti, gruppi specifici o all'intero tenant.
- È possibile assegnare fino a 10 criteri per ogni funzionalità. È possibile assegnare un criterio aggiuntivo per funzionalità all'intero tenant.
- I criteri assegnati a un utente o un gruppo specifico hanno priorità rispetto ai criteri assegnati all'intero tenant nel determinare se una funzionalità è abilitata. Se a un utente sono assegnati più criteri per una funzionalità (direttamente come utente o membro di un gruppo), viene applicato il criterio più restrittivo.
- 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 funzione utilizzando il cmdlet Get-VivaModuleFeature .
Alcune funzionalità includono l'opzione per i controlli utente (rifiuto esplicito dell'utente). Fai riferimento alla documentazione della funzionalità per verificare se sono disponibili controlli utente per la quale intendi 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
Usa il cmdlet Add-VivaModuleFeaturePolicy per aggiungere un nuovo criterio di accesso per una funzione 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, per eseguire questo cmdlet, è necessario essere un membro del ruolo Amministratori globali o dei ruoli assegnati a livello di funzionalità.
Per altre informazioni sui ruoli assegnati a livello di funzionalità, vedere Funzionalità disponibili per Gestione dell'accesso alle funzionalità.
Per altre informazioni sulle autorizzazioni del ruolo di amministratore in Microsoft Entra ID, vedere ID modello di ruolo.
Importante
Microsoft sostiene con forza il principio del privilegio minimo. Assegnare agli account solo le autorizzazioni minime necessarie per eseguire le attività consente di ridurre i rischi per la sicurezza e rafforzare la protezione complessiva dell'organizzazione. L'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
Questo esempio aggiunge 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
Questo esempio aggiunge 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
Questo esempio aggiunge 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
Questo esempio aggiunge 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
Questo esempio aggiunge un criterio per la funzionalità ShowAISkills in Viva Skills. Il criterio abilita la funzionalità per gli utenti specificati, consente i controlli utente e ha rifiutato esplicitamente gli utenti per impostazione predefinita (criterio di disabilitazione temporanea).
Parametri
-Confirm
Applicabile: Exchange Online
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma 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, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.
Questo cmdlet ha una pausa incorporata, quindi è consigliabile 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 Tutti specifica che il criterio si applica 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à del modulo Viva per cui si desidera aggiungere il criterio.
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.
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 del 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 il criterio a tutti gli utenti dell'organizzazione, usare l'opzione Tutti.
Nota: nella versione 3.5.1-Preview2 o successiva del modulo, questo parametro supporta gli ID oggetto del gruppo di sicurezza (GUID). Le versioni precedenti del modulo accettano solo indirizzi e-mail 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 dal criterio.
- $false: la funzionalità non è abilitata dal criterio.
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 consente di specificare se il controllo utente è abilitato dal criterio. 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 tramite criteri possono usare questo parametro. Se la funzionalità non supporta gli amministratori che attivano o disattivano i controlli utente, viene applicato il valore predefinito. Per altre informazioni, vedere la documentazione della 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 stati inclusi per impostazione predefinita dal criterio. I valori validi sono:
- $true: Per impostazione predefinita, gli utenti vengono inclusi dal criterio se l'utente non ha impostato una preferenza.
- $false: Per impostazione predefinita, gli utenti vengono esclusi dal criterio se l'utente non ha impostato una preferenza.
Questo parametro è facoltativo e può essere usato per sostituire il valore di consenso esplicito dell'utente predefinito 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 vogliono aggiungere i criteri delle 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 inglesi, numeri, virgole, punti e spazi.
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 delle entità utente (UPN) degli utenti a cui si applica il criterio. È 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 il criterio a tutti gli utenti dell'organizzazione, usare l'opzione Tutti.
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 mostra le operazioni eseguite dal comando senza apportare modifiche. 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.