New-ComplianceCase
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie das New-ComplianceCase Cmdlet, um eDiscovery-Fälle im Microsoft Purview-Complianceportal zu erstellen. Sie verwenden eDiscovery-Fälle, um Inhaltsspeicherorte in die Warteschleife zu setzen, dem Fall zugeordnete Inhaltssuchen durchzuführen und Suchergebnisse zu exportieren.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Hinweis
In der Cloud hat dieses Cmdlet die folgenden Anforderungen:
- Version 3.9.0 oder höher des Exchange Online PowerShell-Moduls (August 2025).
- Verwenden Sie den Parameter EnableSearchOnlySession , wenn Sie den Befehl Connect-IPPSSession ausführen, um eine Verbindung mit Security & Compliance PowerShell herzustellen.
Syntax
Default (Standard)
New-ComplianceCase
[-Name] <String>
[-CaseType <ComplianceCaseType>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-ExternalId <String>]
[-SecondaryCaseType <String>]
[-SourceCaseType <String>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Um dieses Cmdlet in Security & Compliance PowerShell zu verwenden, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.
Beispiele
Beispiel 1
New-ComplianceCase -Name "Fabrikam Litigation"
In diesem Beispiel wird ein neuer eDiscovery Standard-Fall mit dem Namen Fabrikam Litigation erstellt.
Beispiel 2
New-ComplianceCase -Name "Coho Case 03082020" -CaseType AdvancedEdiscovery -ExternalId "SaraDavis v. Coho Winery"
In diesem Beispiel wird ein neuer eDiscovery Premium-Fall mit dem Namen "Coho Case 03082020" erstellt, und die optionale Fall-ID "SaraDavis v. Coho Winery".
Parameter
-CaseType
Anwendbar: Sicherheit & Compliance
Der Parameter CaseType gibt den Typ des Compliancefalls an, den Sie erstellen möchten. Gültige Werte sind:
- AdvancedEdiscovery: eDiscovery Premium-Fälle werden verwendet, um rechtliche oder andere Arten von Untersuchungen zu verwalten.
- ComplianceClassifier: Diese Art von Fall entspricht einem trainierbaren Classifier.
- ComplianceWorkspace: Dieser Wert ist für die interne Verwendung durch Microsoft reserviert.
- DataInvestigation: Datenuntersuchungsfälle werden verwendet, um Vorfälle von Datenlecks zu untersuchen.
- DSR: Anfragen betroffener Personen (Data Subject Request, DSR) werden verwendet, um Untersuchungen zu DSR-Anfragen (DSGVO) zu verwalten.
- eDiscovery: eDiscovery-Fälle (auch als eDiscovery-Standard bezeichnet) werden verwendet, um rechtliche oder andere Arten von Untersuchungen zu verwalten. Dieser Wert ist der Standardwert.
- InsiderRisk: Insider-Risikofälle werden verwendet, um Insider-Risikomanagementfälle zu verwalten. In der Regel werden Insider-Risikomanagementfälle manuell im Microsoft Purview-Complianceportal erstellt, um Aktivitäten basierend auf einer Risikowarnung weiter zu untersuchen.
- InternalInvestigation: Dieser Wert ist für die interne Verwendung durch Microsoft reserviert.
- SupervisionPolicy: Diese Art von Fall entspricht der Kommunikations-Compliance-Richtlinie.
Parametereigenschaften
| Typ: | ComplianceCaseType |
| 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 |
-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 |
-Description
Anwendbar: Sicherheit & Compliance
Der Description-Parameter gibt eine Beschreibung für den Compliancefall an. Die Höchstlänge beträgt 256 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
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 |
-DomainController
Anwendbar: Sicherheit & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | Fqdn |
| 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 |
-ExternalId
Anwendbar: Sicherheit & Compliance
Der Parameter ExternalId gibt eine optionale ID oder externe Fallnummer an, die Sie dem neuen Compliancefall zuordnen können.
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 |
-Name
Anwendbar: Sicherheit & Compliance
Der Name-Parameter gibt den eindeutigen Namen des Compliancefalls an. Die Höchstlänge beträgt 64 Zeichen. Wenn der Wert Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SecondaryCaseType
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: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SourceCaseType
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: | Named |
| 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 |
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.