Update-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.
Verwenden Sie das Cmdlet Update-VivaModuleFeaturePolicy, um eine Zugriffsrichtlinie für ein Feature in einem Viva-Modul in Viva zu aktualisieren.
- Sie können eine Richtlinie für einen bestimmten Benutzer oder eine gruppe nicht aktualisieren, um den gesamten Mandanten einzuschließen, wenn bereits eine Richtlinie für den gesamten Mandanten für das Feature vorhanden ist. Es wird nur eine mandantenweite Richtlinie unterstützt.
- 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 aktiviert ist. Wenn einem Benutzer mehrere Richtlinien für ein Feature zugewiesen sind (direkt als Benutzer oder Mitglied einer Gruppe), gilt die restriktivste Richtlinie.
- 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
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-Everyone <Boolean>]
[-IsFeatureEnabled <Boolean>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-GroupIds <String[]>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Beschreibung
Verwenden Sie das Cmdlet Update-VivaModuleFeaturePolicy, um eine Zugriffsrichtlinie für ein Feature in einem Viva-Modul in Viva zu aktualisieren.
Dieses Cmdlet aktualisiert die Attribute der richtlinie, die Sie angeben. Zu diesen Attributen gehören:
- Der Richtlinienname (Name-Parameter).
- Gibt an, ob die Richtlinie das Feature (IsFeatureEnabled-Parameter) aktiviert.
- Gibt an, ob die Richtlinie Benutzersteuerelemente aktiviert (IsUserControlEnabled-Parameter, gilt nur für eine Featurerichtlinie).
- Für wen die Richtlinie gilt (die Parameter UserIds und GroupIds oder der Parameter Everyone).
Sie können diese Attribute unabhängig voneinander aktualisieren. Wenn Sie beispielsweise den Parameter Name angeben, aber nicht den Parameter IsFeatureEnabled, wird der Name der Richtlinie aktualisiert, aber ob die Richtlinie das Feature aktiviert, bleibt unverändert.
Wichtig: Werte, die Sie für die Parameter UserIds und/oder GroupIds oder den Parameter Everyone angeben, überschreiben alle vorhandenen Benutzer oder Gruppen. Um die vorhandenen Benutzer und Gruppen beizubehalten, müssen Sie diese vorhandenen Benutzer oder Gruppen sowie alle zusätzlichen Benutzer oder Gruppen angeben, die Sie hinzufügen möchten. Wenn vorhandene Benutzer oder Gruppen nicht in den Befehl eingeschlossen werden, werden diese spezifischen Benutzer oder Gruppen effektiv aus der Richtlinie entfernt. Weitere Informationen finden Sie in den Beispielen.
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
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $falseIn diesem Beispiel wird der Name der angegebenen Richtlinie aktualisiert und so festgelegt, dass die Richtlinie das Feature nicht aktiviert.
Beispiel 2
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.comIn diesem Beispiel wird aktualisiert, für wen die angegebene Richtlinie gilt. Die Richtlinie gilt jetzt nur für die angegebenen Gruppen und überschreibt die Benutzer und Gruppen, für die die Richtlinie angewendet wurde.
Beispiel 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.comIn diesem Beispiel wird aktualisiert, für wen die angegebene Richtlinie gilt. Die Richtlinie gilt jetzt nur für die angegebenen Benutzer und überschreibt die Benutzer und Gruppen, auf die die Richtlinie angewendet wurde.
Beispiel 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.comIn diesem Beispiel wird der Name der angegebenen Richtlinie aktualisiert, so dass die Richtlinie das Feature aktiviert und aktualisiert, für wen die Richtlinie gilt. Die Richtlinie gilt jetzt nur für die angegebenen Benutzer und Gruppen und überschreibt die Benutzer und Gruppen, für die die Richtlinie angewendet wurde.
Beispiel 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $falseIn diesem Beispiel wird eine Richtlinie für das ShowAISkills-Feature in Viva Skills aktualisiert. Die Richtlinie aktiviert das Feature für die Benutzer, die zuvor der Richtlinie hinzugefügt wurden, lässt Benutzersteuerelemente zu und deaktiviert Benutzer standardmäßig (Richtlinie für die vorläufige Deaktivierung).
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 (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.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-Everyone
Der Parameter Everyone gibt an, dass die aktualisierte Richtlinie für alle Benutzer im organization gilt. Gültige Werte sind:
- $true: Die Richtlinie gilt für alle Benutzer. Dies ist der einzige nützliche Wert für diesen Parameter.
- $false: Verwenden Sie diesen Wert nicht.
Wenn Sie nicht aktualisieren möchten, für wen die Richtlinie gilt, verwenden Sie diesen Parameter nicht.
Verwenden Sie diesen Parameter nicht mit den Parametern GroupIds oder UserIds.
| Typ: | Boolean |
| 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 der Richtlinie an, die Sie aktualisieren 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.
Wenn Sie nicht aktualisieren möchten, für wen die Richtlinie gilt, verwenden Sie diesen Parameter nicht.
Die Werte, die Sie für diesen Parameter oder den Parameter UserIds angeben, ersetzen alle vorhandenen Gruppen. Um die vorhandenen Gruppen beizubehalten, schließen Sie sie zusammen mit allen neuen Benutzern oder Gruppen ein, die Sie angeben.
Sie können maximal 20 Benutzer oder Gruppen insgesamt angeben (20 Benutzer und keine Gruppen, 10 Benutzer und 10 Gruppen usw.).
Damit die aktualisierte Richtlinie für alle Benutzer im organization gilt, verwenden Sie den Parameter Jeder mit dem Wert $true.
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 |
-IsFeatureEnabled
Der Parameter IsFeatureEnabled gibt an, ob das Feature durch die aktualisierte Richtlinie aktiviert wird. Gültige Werte sind:
- $true: Das Feature wird durch die Richtlinie aktiviert.
- $false: Das Feature ist durch die Richtlinie nicht aktiviert.
Wenn Sie nicht aktualisieren möchten, ob das Feature durch die Richtlinie aktiviert ist, verwenden Sie diesen Parameter nicht.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-IsUserControlEnabled
Hinweis: Dieser Parameter ist in Version 3.3.0 oder höher des Moduls verfügbar. Wenn das Feature Benutzersteuerelemente für die Deaktivierung unterstützt, stellen Sie sicher, dass Sie beim Erstellen der Richtlinie den Parameter IsUserControlEnabled festlegen. Andernfalls verwenden Benutzersteuerelemente für die Richtlinie den Standardzustand für das Feature.
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.
Wenn Sie nicht aktualisieren möchten, ob das Benutzersteuerelement durch die Richtlinie aktiviert ist, verwenden Sie diesen Parameter nicht.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-IsUserOptedInByDefault
Dieser Parameter ist in Version 3.8.0-Preview2 oder höher des Moduls verfügbar.
Der Parameter IsUser OptInByDefault gibt an, ob Benutzer standardmäßig von der Richtlinie aktiviert werden. Gültige Werte sind:
- $true: Standardmäßig werden Benutzer durch die Richtlinie angemeldet, wenn der Benutzer keine Einstellung festgelegt hat.
- $false: Standardmäßig werden Benutzer von der Richtlinie abgemeldet, wenn der Benutzer keine Einstellung festgelegt hat.
Dieser Parameter ist optional und kann verwendet werden, um den in den Featuremetadaten festgelegten Standardwert für die Benutzeranmeldung außer Kraft zu setzen.
Dieser Parameter kann nur festgelegt werden, wenn der IsUserControlEnabled-Parameter auf $true festgelegt ist.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-ModuleId
Der Parameter ModuleId gibt das Viva Modul der Richtlinie an, die Sie aktualisieren möchten.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-Name
Der Name-Parameter gibt den aktualisierten Namen für die 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.
Wenn Sie den Namen der Richtlinie nicht aktualisieren möchten, verwenden Sie diesen Parameter nicht.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Exchange Online |
-PolicyId
Der Parameter PolicyId gibt die Richtlinie für das Feature im Viva Modul an, das Sie aktualisieren möchten.
Verwenden Sie das Cmdlet Get-VivaModuleFeaturePolicy, um Details zu den Richtlinien für ein Feature in einem Viva-Modul anzuzeigen. Der PolicyId-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 |
-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) von Benutzern an, für die die aktualisierte Richtlinie gilt. Mehrere Werte können durch Kommata getrennt eingegeben werden.
Wenn Sie nicht aktualisieren möchten, für wen die Richtlinie gilt, verwenden Sie diesen Parameter nicht.
Die Werte, die Sie für diesen Parameter oder den GroupIds-Parameter angeben, ersetzen alle vorhandenen Benutzer. Um die vorhandenen Benutzer beizubehalten, schließen Sie sie zusammen mit allen neuen Benutzern oder Gruppen ein, die Sie angeben.
Sie können maximal 20 Benutzer oder Gruppen insgesamt angeben (20 Benutzer und keine Gruppen, 10 Benutzer und 10 Gruppen usw.).
Damit die aktualisierte Richtlinie für alle Benutzer im organization gilt, verwenden Sie den Parameter Jeder mit dem Wert $true.
| 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 |