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