Update-VivaModuleFeaturePolicy
Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul, Version 3.2.0 oder höher, verfügbar. Weitere Informationen finden Sie unter Informationen zum PowerShell-Modul von Exchange Online.
Verwenden Sie das Update-VivaModuleFeaturePolicy Cmdlet, 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 bestimmte 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 festgestellt 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 enthalten die Option zur Benutzersteuerung (Benutzerabmeldung). Lesen Sie in der Featuredokumentation, 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
Default (Standard)
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 Update-VivaModuleFeaturePolicy Cmdlet, um eine Zugriffsrichtlinie für ein Feature in einem Viva-Modul in Viva zu aktualisieren.
Dieses Cmdlet aktualisiert die Attribute der von Ihnen angegebenen Richtlinie. Zu diesen Attributen gehören:
- Der Richtlinienname (Name-Parameter).
- Gibt an, ob die Richtlinie das Feature aktiviert oder nicht (IsFeatureEnabled-Parameter).
- Gibt an, ob die Richtlinie Benutzersteuerelemente aktiviert (Parameter IsUserControlEnabled, gilt nur für eine Featurerichtlinie).
- Für wen die Richtlinie gilt (die Parameter UserIds und GroupIds oder der Parameter Jeder).
Sie können diese Attribute unabhängig voneinander aktualisieren. Wenn Sie beispielsweise den Name-Parameter, aber nicht den Parameter IsFeatureEnabled angeben, bleibt der Name der Richtlinie aktualisiert, aber unabhängig davon, ob die Richtlinie das Feature aktiviert oder nicht, bleibt unverändert.
Wichtig: Werte, die Sie für die Parameter UserIds und/oder GroupIds oder Everyone angeben, überschreiben alle vorhandenen Benutzer oder Gruppen. Um die vorhandenen Benutzer und Gruppen beizubehalten, müssen Sie diese vorhandenen Benutzer oder Gruppen und alle zusätzlichen Benutzer oder Gruppen angeben, die Sie hinzufügen möchten. Wenn vorhandene Benutzer oder Gruppen nicht in den Befehl einbezogen 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 für die Authentifizierung verwenden.
Für dieses Cmdlet ist mindestens .NET Framework 4.7.2 erforderlich.
Derzeit müssen Sie der Rolle "Globale Administratoren" oder den Rollen angehören, die auf Featureebene zugewiesen wurden, um dieses Cmdlet auszuführen.
Weitere Informationen zu zugewiesenen Rollen auf Featureebene finden Sie unter Verfügbare Funktionen für die Verwaltung des Featurezugriffs.
Weitere Informationen zu Administratorrollenberechtigungen in Microsoft Entra ID finden Sie unter Rollenvorlagen-IDs.
Wichtig
Microsoft setzt sich nachdrücklich für das Prinzip der geringsten Privilegien ein. Wenn Sie Konten nur die minimalen Berechtigungen zuweisen, die für die Ausführung ihrer Aufgaben erforderlich sind, tragen Sie zur Verringerung der Sicherheitsrisiken bei und stärken den allgemeinen Schutz Ihrer Organization. Globale Administratorrolle ist eine hoch privilegierte Rolle, die Sie in der Regel auf Notfallszenarien beschränken oder wenn Sie keine andere Rolle verwenden können.
Beispiele
Beispiel 1
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false
In diesem Beispiel wird der Name der angegebenen Richtlinie aktualisiert und bewirkt, 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.com
In diesem Beispiel wird aktualisiert, für wen die angegebene Richtlinie gilt. Die Richtlinie gilt jetzt nur noch für die angegebenen Gruppen und überschreibt die Benutzer und Gruppen, für die die Richtlinie bisher galt.
Beispiel 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com
In 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, für die die Richtlinie bisher galt.
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.com
In diesem Beispiel wird der Name der angegebenen Richtlinie aktualisiert, sodass die Richtlinie das Feature aktiviert und für wen die Richtlinie gilt. Die Richtlinie gilt jetzt nur noch für die angegebenen Benutzer und Gruppen, wobei die Benutzer und Gruppen überschrieben werden, für die die Richtlinie bisher galt.
Beispiel 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
Dieses Beispiel aktualisiert eine Richtlinie für das ShowAISkills-Feature in Viva Skills. Die Richtlinie aktiviert das Feature für die Benutzer, die zuvor der Richtlinie hinzugefügt wurden, ermöglicht Benutzersteuerelemente und deaktiviert Benutzer standardmäßig (Richtlinie für vorläufiges Deaktivieren).
Parameter
-Confirm
Anwendbar: Exchange Online
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.
- 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 die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Everyone
Anwendbar: Exchange Online
Der Parameter "Jeder" gibt an, dass die aktualisierte Richtlinie für alle Benutzer in der organization gilt. Gültige Werte sind:
- $true: Die Richtlinie gilt für alle Benutzer. Dies ist der einzige sinnvolle 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 zusammen mit den GroupIds- oder UserIds-Parametern.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FeatureId
Anwendbar: Exchange Online
Der FeatureId-Parameter gibt das Feature im Viva-Modul der Richtlinie an, die Sie aktualisieren möchten.
Um Details zu den Features in einem Viva-Modul anzuzeigen, die Featurezugriffssteuerungen unterstützen, verwenden Sie das Get-VivaModuleFeature Cmdlet. Der FeatureId-Wert wird in der Ausgabe des Cmdlets zurückgegeben.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-GroupIds
Anwendbar: Exchange Online
Der Parameter GroupIds gibt die E-Mail-Adressen oder Sicherheitsgruppenobjekt-IDs (GUIDs) von Gruppen an, für die die aktualisierte Richtlinie gilt. Es werden sowohl E-Mail-aktivierte als auch nicht E-Mail-aktivierte Microsoft Entra-Gruppen 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 UserIds-Parameter 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 bis zu 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IsFeatureEnabled
Anwendbar: Exchange Online
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: Dieses Feature wurde von der Richtlinie nicht aktiviert.
Wenn Sie nicht aktualisieren möchten, ob das Feature durch die Richtlinie aktiviert ist, verwenden Sie diesen Parameter nicht.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IsUserControlEnabled
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.3.0-Preview1 oder höher verfügbar. Wenn das Feature Benutzersteuerelemente zum Deaktivieren unterstützt, stellen Sie sicher, dass Sie beim Erstellen der Richtlinie den Parameter IsUserControlEnabled festlegen. Andernfalls verwenden die Benutzersteuerelemente für die Richtlinie den Standardstatus 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 wird durch die Richtlinie nicht aktiviert. Benutzer können das Feature nicht deaktivieren.
Nur Features, die es Administratoren ermöglichen, Benutzersteuerelemente nach Richtlinie zu aktivieren und zu deaktivieren, können diesen Parameter verwenden. Wenn das Feature keine Administratoren unterstützt, die Benutzersteuerelemente umschalten, gilt der Standardwert. Weitere Informationen hierzu finden Sie in der Dokumentation zu diesem Feature.
Wenn Sie nicht aktualisieren möchten, ob das Benutzersteuerelement durch die Richtlinie aktiviert ist, verwenden Sie diesen Parameter nicht.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IsUserOptedInByDefault
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.8.0-Preview2 oder höher verfügbar.
Der Parameter IsUserOptedInByDefault gibt an, ob Benutzer standardmäßig von der Richtlinie angemeldet werden. Gültige Werte sind:
- $true: Standardmäßig werden Benutzer von der Richtlinie registriert, 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 Benutzeropt-in zu überschreiben.
Dieser Parameter kann nur festgelegt werden, wenn der Parameter IsUserControlEnabled auf $true festgelegt ist.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ModuleId
Anwendbar: Exchange Online
Der Parameter ModuleId gibt das Viva-Modul der Richtlinie an, die Sie aktualisieren möchten.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Anwendbar: Exchange Online
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PolicyId
Anwendbar: Exchange Online
Der PolicyId-Parameter gibt die Richtlinie für das Feature im Viva-Modul an, das Sie aktualisieren möchten.
Um Details zu den Richtlinien für ein Feature in einem Viva-Modul anzuzeigen, verwenden Sie das Get-VivaModuleFeaturePolicy Cmdlet. Der PolicyId-Wert wird in der Ausgabe des Cmdlets zurückgegeben.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ResultSize
Anwendbar: Exchange Online
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | Unlimited |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserIds
Anwendbar: Exchange Online
Der Parameter UserIds gibt die Benutzerprinzipalnamen (UPNs) der Benutzer 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 Parameter GroupIds 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 bis zu 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Online
Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.