Condividi tramite

Add-VivaModuleFeaturePolicy

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online

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 -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

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 -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.

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