Freigeben über


Add-VivaModuleFeaturePolicy

Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul v3.2.0 oder höher verfügbar. Weitere Informationen finden Sie unter Informationen zum Exchange Online PowerShell-Moduls.

Hinweis: Dieses Cmdlet ist Teil eines Features, das sich derzeit in einer geschlossenen privaten Vorschau befindet. Das Cmdlet funktioniert nur, wenn Ihr organization Mitglied der privaten Vorschau ist.

Verwenden Sie das Cmdlet Add-VivaModuleFeaturePolicy, um eine neue Zugriffsrichtlinie für ein bestimmtes Feature in Viva hinzuzufügen. Die Attribute der Richtlinie werden mithilfe der verschiedenen Parameter des Cmdlets definiert. Richtlinien werden verwendet, um den Zugriff auf das angegebene Feature für bestimmte Benutzer, Gruppen oder den gesamten Mandanten einzuschränken oder zu gewähren. Beachten Sie, dass die restriktivste Richtlinie für einen bestimmten Benutzer oder eine bestimmte Gruppe Priorität hat, wenn bestimmt wird, ob ein Feature aktiviert ist.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Add-VivaModuleFeaturePolicy
   -FeatureId <String>
   -IsFeatureEnabled <Boolean>
   -ModuleId <String>
   -Name <String>
   [-Confirm]
   [-GroupIds <String[]>]
   [-UserIds <String[]>]
   [-Everyone]
   [-ResultSize <Unlimited>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Verwenden Sie das Cmdlet Add-VivaModuleFeaturePolicy, um eine neue Zugriffsrichtlinie für ein bestimmtes Feature in Viva hinzuzufügen.

Sie müssen das Cmdlet Connect-ExchangeOnline verwenden, um sich zu authentifizieren.

Dieses Cmdlet erfordert die .NET Framework 4.7.2 oder höher.

Derzeit müssen Sie Mitglied der Rolle "Globale Administratoren" sein, um dieses Cmdlet ausführen zu können.

Weitere Informationen zu Administratorrollenberechtigungen in Azure Active Directory finden Sie unter Rollenvorlagen-IDs.

Beispiele

Beispiel 1

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone

In diesem Beispiel wird eine Richtlinie für das Reflektionsfeature in Viva Insights hinzugefügt. Die Richtlinie deaktiviert das Feature für alle Benutzer im organization.

Beispiel 2

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com

In diesem Beispiel wird eine Richtlinie für das Reflektionsfeature in Viva Insights hinzugefügt. Die Richtlinie deaktiviert das Feature für alle Benutzer in den angegebenen Gruppen.

Beispiel 3

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.com

In diesem Beispiel wird eine Richtlinie für das Reflektionsfeature in Viva Insights hinzugefügt. Die Richtlinie deaktiviert das Feature für die angegebenen Benutzer.

Beispiel 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 diesem Beispiel wird eine Richtlinie für das Reflektionsfeature in Viva Insights hinzugefügt. Die Richtlinie deaktiviert das Feature für die angegebenen Benutzer und Gruppenmitglieder.

Parameter

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Everyone

Die Option Jeder gibt an, dass die Richtlinie für alle Benutzer im organization gilt. Sie müssen keinen Wert für diese Option angeben.

Verwenden Sie diesen Schalter nicht mit den Parametern GroupIds oder UserIds.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FeatureId

Der Parameter FeatureId gibt das Feature im Viva-Modul an, für das Sie die Richtlinie hinzufügen möchten.

Um Details zu den Features in einem Viva-Modul anzuzeigen, die Featurezugriffssteuerungen unterstützen, verwenden Sie das Cmdlet Get-VivaModuleFeature. Der FeatureId-Wert wird in der Ausgabe des Cmdlets zurückgegeben.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-GroupIds

Der GroupIds-Parameter gibt die SMTP-Adressen (E-Mail-Adressen) der Gruppen an, für die die Richtlinie gilt. E-Mail-aktivierte AAD-Gruppen werden unterstützt. Mehrere Werte können durch Kommata getrennt eingegeben werden.

Sie können maximal 20 Benutzer oder Gruppen insgesamt angeben (20 Benutzer und keine Gruppen, 10 Benutzer und 10 Gruppen usw.).

Damit die Richtlinie auf alle Benutzer im organization angewendet wird, verwenden Sie die Option Jeder.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-IsFeatureEnabled

Der Parameter IsFeatureEnabled gibt an, ob das Feature durch die Richtlinie aktiviert wird. Gültige Werte sind:

  • $true: Das Feature wird durch die Richtlinie aktiviert.
  • $false: Das Feature ist durch die Richtlinie nicht aktiviert.
Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ModuleId

Der Parameter ModuleId gibt das Viva-Modul an, für das Sie die Featurerichtlinie hinzufügen möchten.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Name

Der Parameter Name gibt den Namen der Richtlinie an. Die Höchstlänge beträgt 256 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Gültige Zeichen sind englische Buchstaben, Zahlen, Kommas, Punkte und Leerzeichen.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserIds

Der Parameter UserIds gibt die Benutzerprinzipalnamen (UPNs) der Benutzer an, für die die Richtlinie gilt. Mehrere Werte können durch Kommata getrennt eingegeben werden.

Sie können maximal 20 Benutzer oder Gruppen insgesamt angeben (20 Benutzer und keine Gruppen, 10 Benutzer und 10 Gruppen usw.).

Damit die Richtlinie auf alle Benutzer im organization angewendet wird, verwenden Sie die Option Jeder.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online