Check-PurviewConfig
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie das Check-PurviewConfig Cmdlet, um die Konfigurationseinstellungen Ihrer organization in Microsoft Purview zu überprüfen und zu überprüfen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Check-PurviewConfig
[[-CaseHoldPolicyNameOrId] <String>]
[[-CaseId] <String>]
[[-Component] <PurviewConfigComponent>]
[-Confirm]
[[-DateTimeUTC] <String>]
[[-DeviceName] <String>]
[[-File] <String>]
[[-FileAsBytes] <Byte[]>]
[[-IncidentId] <String>]
[[-ItemId] <String>]
[[-MessageId] <String>]
[[-Organization] <OrganizationIdParameter>]
[[-PolicyName] <String>]
[-RecipientAddress]
[[-RecordId] <String>]
[[-RuleName] <String>]
[[-SenderAddress] <SmtpAddress>]
[[-SharepointItemUniqueId] <String>]
[[-SharepointSiteId] <String>]
[[-SiteUrl] <String>]
[[-SitIdentity] <String>]
[[-TestCases] <String[]>]
[[-Theme] <PurviewConfigTheme>]
[[-UserPrincipalName] <SmtpAddress>]
[-WhatIf]
[[-Workload] <String>]
[<CommonParameters>]
Beschreibung
Verwenden Sie das Check-PurviewConfig Cmdlet, um Microsoft Information Protection Diagnosetestfälle für Ihre organization auszuführen und die Ergebnisse zu überprüfen.
Administratoren mit der zugewiesenen Rolle "Organisationskonfiguration" verfügen über die erforderlichen Berechtigungen, um dieses Cmdlet auszuführen.
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
Check-PurviewConfig
In diesem Beispiel werden alle Microsoft Information Protection-Testfälle ausgeführt, für die keine zusätzlichen Parameter erforderlich sind.
Beispiel 2
Check-PurviewConfig -Component Encryption
In diesem Beispiel werden alle Testfälle für die Verschlüsselungskomponente ausgeführt.
Beispiel 3
Check-PurviewConfig -Component Encryption -Theme LicenseAvailability
In diesem Beispiel werden alle Fälle für das Design "LicenseAvailability" in der Verschlüsselungskomponente ausgeführt.
Beispiel 4
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels" -UserPrincipalName sathya@contoso.onmicrosoft.com
In diesem Beispiel wird der Testfall mit dem Namen MipLabels_EnabledEntities_ScopedLabels ausgeführt, für den ein UserPrincipalName-Wert erforderlich ist.
Beispiel 5
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels","MipLabels_EnabledEntities_CompareSyncStatus" -UserPrincipalName sathya@contoso.onmicrosoft.com
In diesem Beispiel werden die angegebenen Testfälle ausgeführt. Für den MipLabels_EnabledEntities_ScopedLabels Testfall ist ein Wert "UserPrincipalName" erforderlich.
Parameter
-CaseHoldPolicyNameOrId
Anwendbar: Sicherheit & Compliance
{{ Fill CaseHoldPolicyNameOrId Description }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CaseId
Anwendbar: Sicherheit & Compliance
{{ Fill CaseId Description }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Component
Anwendbar: Sicherheit & Compliance
Der Parameter Component gibt die Komponente an, die im Testfall analysiert werden soll. Gültige Werte sind:
- DLP
- DLPAlerts
- Verschlüsselung
- MIPLabels
Parametereigenschaften
| Typ: | PurviewConfigComponent |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: Sicherheit & Compliance
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 |
-DateTimeUTC
Anwendbar: Sicherheit & Compliance
DateTimeUTC gibt das Datum und die Uhrzeit des Testfalls in koordinierter Weltzeit (UTC) an. Beispiel: "2025-06-05 14:30:00".
Dieser Parameter ist für die folgenden TestCases-Werte erforderlich:
- DlpAlerts_CheckAlertsCreated
- DlpAlerts_FindAlertForActivity
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DeviceName
Anwendbar: Sicherheit & Compliance
{{ Fill DeviceName Description }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-File
Anwendbar: Sicherheit & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FileAsBytes
Anwendbar: Sicherheit & Compliance
{{ Fill FileAsBytes Description }}
Parametereigenschaften
| Typ: | Byte[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 4 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IncidentId
Anwendbar: Sicherheit & Compliance
Der Parameter IncidentId gibt den im Testfall zu analysierenden Incident an.
Sie können einen Wert für diesen Parameter in Überwachungsprotokollsuchen finden, gefiltert nach dem Vorgang DLPRuleMatch in der IncidentId-Eigenschaft.
Dieser Parameter ist für den TestCases-Wert DlpAlerts_FindAlertForActivity erforderlich.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 3 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ItemId
Anwendbar: Sicherheit & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 4 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MessageId
Anwendbar: Sicherheit & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 5 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Organization
Anwendbar: Sicherheit & Compliance
{{ Organisationsbeschreibung ausfüllen }}
Parametereigenschaften
| Typ: | OrganizationIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 10 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PolicyName
Anwendbar: Sicherheit & Compliance
{{ Fill PolicyName Description }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 8 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RecipientAddress
Anwendbar: Sicherheit & Compliance
{{ Fill RecipientAddress Description }}
Parametereigenschaften
| Typ: | SmtpAddress |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 9 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RecordId
Anwendbar: Sicherheit & Compliance
Der Parameter RuleName gibt den Datensatz an, der im Testfall analysiert werden soll.
Sie finden einen Wert für diesen Parameter im Aktivitäts-Explorer, gefiltert nach dem Aktivitätstyp DLPRuleMatch in der RecordId-Eigenschaft.
Dieser Parameter ist optional, wobei der TestCases-Wert DlpAlerts_FindAlertForActivity ist.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 6 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RuleName
Anwendbar: Sicherheit & Compliance
Der Parameter RuleName gibt die im Testfall zu analysierende DLP-Regel an.
Dieser Parameter ist optional mit dem TestCases-Wert DlpAlerts_CheckAlertsCreated.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 7 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SenderAddress
Anwendbar: Sicherheit & Compliance
{{ Fill SenderAddress Description }}
Parametereigenschaften
| Typ: | SmtpAddress |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 12 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SharepointItemUniqueId
Anwendbar: Sicherheit & Compliance
{{ Fill SharepointItemUniqueId Description }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 13 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SharepointSiteId
Anwendbar: Sicherheit & Compliance
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 14 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SiteUrl
Anwendbar: Sicherheit & Compliance
{{ SiteURL-Beschreibung ausfüllen }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 15 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SitIdentity
Anwendbar: Sicherheit & Compliance
{{ Fill SitIdentity Description }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 16 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-TestCases
Anwendbar: Sicherheit & Compliance
Der Parameter TestCases gibt den Namen des zu analysierenden Testfalls an. In der folgenden Liste werden die verfügbaren Testfälle und die erforderlichen Parameter beschrieben:
- Encryption_EvaluationDetails: Überprüft die E-Mail-Verschlüsselungsbewertungsdetails. Es sind keine weiteren Parameter erforderlich. Führt Test-IRMConfiguration Cmdlet im Rahmen seiner Prüfungen aus.
- Encryption_LicenseAvailability: Überprüft die Konfigurationen der E-Mail-Verschlüsselung. Es sind keine weiteren Parameter erforderlich. Führt im Rahmen der Prüfungen die Cmdlets Get-IRMConfiguration, Get-RMSTemplate, Get-TransportRule und Get-JournalRule aus.
- MipLabels_EnabledEntities_ScopedLabels: Zeigt die Bezeichnungen und Bezeichnungseinstellungen an, die für einen Benutzer gelten. Erfordert den Parameter "UserPrincipalName". Führt Get-Label und Get-LabelPolicy Cmdlets im Rahmen der Prüfungen aus.
- MipLabels_LicenseAvailability: Überprüft, ob das MIP-Bezeichnungsfeature aktiviert ist. Keine weiteren Parameter erforderlich.
- DlpAlerts_CheckAlertsCreated: Überprüft die DLP-Regelkonfiguration für Warnungen, die in den letzten 5 Tagen erstellt wurden. Erfordert den DateTimeUTC-Parameter. Der Parameter RuleName ist optional.
- DlpAlerts_FindAlertForActivity: Identifiziert fehlende Warnungen für eine Aktivität. Erfordert den DateTimeUTC-Parameter. Die Parameter IncidentId und RecordId sind optional.
- DLP_ScopedEntities: Gibt alle DLP-Richtlinien und -Regeln zurück, die für einen Benutzer oder eine Website gelten. Erfordert den Parameter "Workload". Die Parameter SiteUrl und UserPrincipalName sind optional.
Es können mehrere Werte durch Kommata getrennt angegeben werden.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 8 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Theme
Anwendbar: Sicherheit & Compliance
Der Design-Parameterfilter gibt an, welche im Testfall analysiert werden sollen. Gültige Werte sind:
- EnabledEntities
- EvaluationDetails
- LicenseAvailability
Parametereigenschaften
| Typ: | PurviewConfigTheme |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 9 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserPrincipalName
Anwendbar: Sicherheit & Compliance
Der Parameter UserPrincipalName gibt das Benutzerkonto an, sathya@contoso.onmicrosoft.comdas im Testfall analysiert werden soll (z. B. ).
- Erforderlich für den TestCases-Wert MipLabels_EnabledEntities_ScopedLabels.
- Optional für den TestCases-Wert DLP_ScopedEntities.
Parametereigenschaften
| Typ: | SmtpAddress |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 10 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Sicherheit & Compliance
Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.
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 |
-Workload
Anwendbar: Sicherheit & Compliance
Der Parameter Workload gibt die Dienstworkload an. Wertwerte:
- Endpunktgeräte
- Exchange
- OneDriveForBusiness
- SharePoint
- Teams
Dieser Parameter ist für den TestCases-Wert DLP_ScopedEntities erforderlich.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 11 |
| 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.