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: Unterstützung für Kategorien ist in Version 3.5.0-Preview2 oder höher des Moduls verfügbar, aber in Viva sind derzeit keine Kategorien verfügbar. Wir aktualisieren die Dokumentation, wenn Kategorien verfügbar sind.
Verwenden Sie das Cmdlet Add-VivaModuleFeaturePolicy, um eine neue Zugriffsrichtlinie für ein bestimmtes Feature oder eine Kategorie in Viva hinzuzufügen. Die Attribute der Richtlinie werden mithilfe der Cmdlet-Parameter definiert. Richtlinien werden verwendet, um den Zugriff auf das angegebene Feature oder die kategorie für bestimmte Benutzer, Gruppen oder den gesamten Mandanten einzuschränken oder zu gewähren.
- Sie können bis zu 10 Richtlinien pro Feature/Kategorie zuweisen. Eine zusätzliche Richtlinie pro Feature/Kategorie kann dem gesamten Mandanten zugewiesen werden.
- Richtlinien, die einem bestimmten Benutzer oder einer bestimmten Gruppe zugewiesen sind, haben Vorrang vor der Richtlinie, die dem gesamten Mandanten zugewiesen ist, wenn bestimmt wird, ob ein Feature/eine Kategorie aktiviert ist. Wenn einem Benutzer mehrere Richtlinien für ein Feature/eine Kategorie (direkt als Benutzer oder Mitglied einer Gruppe) zugewiesen sind, gilt die restriktivste Richtlinie.
- Wenn eine Kategorie durch Kategorierichtlinien deaktiviert wird, werden alle Features unter der Kategorie deaktiviert, unabhängig von den Richtlinien, die auf Featureebene festgelegt wurden.
- Sie können Benutzersteuerelemente nur auf Featurerichtlinienebene aktualisieren, nicht auf der Ebene der Kategorierichtlinie.
- Einige Features unterstützen nur Richtlinien, die für den gesamten Mandanten gelten, nicht für bestimmte Benutzer oder Gruppen. Sie können auf unterstützte Richtlinienbereiche für ein Feature verweisen, indem Sie das Cmdlet Get-VivaModuleFeature verwenden.
Einige Features umfassen die Option für Benutzersteuerelemente (Benutzer opt out). In der Featuredokumentation erfahren Sie, ob Benutzersteuerelemente für das Feature verfügbar sind, für das Sie eine Richtlinie festlegen möchten.
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]
[-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>] Beschreibung
Verwenden Sie das Cmdlet Add-VivaModuleFeaturePolicy, um eine neue Zugriffsrichtlinie für ein bestimmtes Feature oder eine bestimmte Kategorie in Viva hinzuzufügen.
Die Unterstützung für Kategorien ist in Version 3.5.0-Preview2 oder höher des Moduls verfügbar.
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" oder der Rollen sein, die auf Featureebene zugewiesen wurden, um dieses Cmdlet ausführen zu können.
Weitere Informationen zu zugewiesenen Rollen auf Featureebene finden Sie unter Verfügbare Features für die Featurezugriffsverwaltung.
Weitere Informationen zu Administratorrollenberechtigungen in Microsoft Entra ID finden Sie unter Rollenvorlagen-IDs.
Wichtig
Microsoft empfiehlt die Verwendung von Rollen mit den wenigsten Berechtigungen. Die Verwendung von Konten mit niedrigeren Berechtigungen trägt zur Verbesserung der Sicherheit für Ihre organization bei. Globaler Administrator ist eine hoch privilegierte Rolle, die auf Notfallszenarien beschränkt werden sollte, wenn Sie keine vorhandene Rolle verwenden können.
Beispiele
Beispiel 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -EveryoneIn 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,57680382-61a5-4378-85ad-f72095d4e9c3In 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.comIn 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,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comIn 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.
Beispiel 5
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -EveryoneIn diesem Beispiel wird eine Richtlinie für die <category_id> Kategorie in Viva hinzugefügt. Die Richtlinie deaktiviert die Kategorie (praktisch alle Features unter der Kategorie) für alle Benutzer im organization.
Beispiel 6
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3In diesem Beispiel wird eine Richtlinie für die <category_id> Kategorie in Viva hinzugefügt. Die Richtlinie deaktiviert die Kategorie (praktisch alle Features unter der Kategorie) für alle Benutzer in den angegebenen Gruppen.
Beispiel 7
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.comIn diesem Beispiel wird eine Richtlinie für die <category_id> Kategorie in Viva hinzugefügt. Die Richtlinie deaktiviert die Kategorie (praktisch alle Features unter der Kategorie) für die angegebenen Benutzer.
Beispiel 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 diesem Beispiel wird eine Richtlinie für die <category_id> Kategorie in Viva hinzugefügt. Die Richtlinie deaktiviert die Kategorie (praktisch alle Features unter der Kategorie) für die angegebenen Benutzer und Gruppenmitglieder.
Beispiel 9
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -EveryoneIn diesem Beispiel wird eine Richtlinie für die <category_id> Kategorie in Viva hinzugefügt, wobei der Richtlinienname leer ist. Die Richtlinie deaktiviert die Kategorie (praktisch alle Features unter der Kategorie) für alle Benutzer im organization.
Parameter
-CategoryId
Dieser Parameter ist in Version 3.5.0-Preview2 oder höher des Moduls verfügbar.
Hinweis: Derzeit sind keine Kategorien in Viva verfügbar. Wir aktualisieren die Dokumentation, wenn Kategorien verfügbar sind.
Der CategoryId-Parameter gibt die Viva Kategorie an, für die Sie die Richtlinie hinzufügen möchten.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise 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.
Dieses Cmdlet verfügt über eine integrierte Pause. Verwenden Sie -Confirm:$false daher , um die Bestätigung zu überspringen.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-FeatureId
Der Parameter FeatureId gibt das Feature im Viva Modul an, für das Sie die Richtlinie hinzufügen möchten.
Verwenden Sie das Cmdlet Get-VivaModuleFeature, um Details zu den Features in einem Viva-Modul anzuzeigen, die Zugriffssteuerungen für Features unterstützen. Der FeatureId-Wert wird in der Ausgabe des Cmdlets zurückgegeben.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-GroupIds
Der GroupIds-Parameter gibt die E-Mail-Adressen oder Sicherheitsgruppenobjekt-IDs (GUIDs) von Gruppen an, für die die aktualisierte Richtlinie gilt. Sowohl E-Mail-aktivierte als auch nicht E-Mail-aktivierte Microsoft Entra 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.
Hinweis: In Version 3.5.1-Preview2 oder höher des Moduls unterstützt dieser Parameter Sicherheitsgruppenobjekt-IDs (GUIDs). Frühere Versionen des Moduls akzeptieren nur E-Mail-Adressen für diesen Parameter.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-IsCategoryEnabled
Dieser Parameter ist in Version 3.5.0-Preview2 oder höher des Moduls verfügbar.
Hinweis: Derzeit sind keine Kategorien in Viva verfügbar. Wir aktualisieren die Dokumentation, wenn Kategorien verfügbar sind.
Der Parameter IsCategoryEnabled gibt an, ob die Kategorie durch die Richtlinie aktiviert wird. Gültige Werte sind:
- $true: Die Kategorie wird durch die Richtlinie aktiviert.
- $false: Die Kategorie ist durch die Richtlinie nicht aktiviert.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | 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.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-IsUserControlEnabled
Dieser Parameter ist in Version 3.3.0 oder höher des Moduls verfügbar.
Der Parameter IsUserControlEnabled gibt an, ob die Benutzersteuerung durch die Richtlinie aktiviert wird. Gültige Werte sind:
- $true: Die Benutzersteuerung wird durch die Richtlinie aktiviert. Benutzer können das Feature deaktivieren.
- $false: Die Benutzersteuerung ist durch die Richtlinie nicht aktiviert. Benutzer können das Feature nicht auswählen.
Nur Features, die administratoren das Aktivieren und Deaktivieren von Benutzersteuerelementen per Richtlinie ermöglichen, können diesen Parameter verwenden. Wenn das Feature das Umschalten von Benutzersteuerelementen durch Administratoren nicht unterstützt, gilt der Standardwert. Weitere Informationen finden Sie in der Featuredokumentation.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-ModuleId
Der Parameter ModuleId gibt die Viva Modul an, für das Sie die Featurerichtlinie hinzufügen möchten.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | 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.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-ResultSize
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
| Typ: | Unlimited |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | 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.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | 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.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |