Set-SPOFileArchivePolicy
Updates einer vorhandenen Dateiarchivrichtlinie.
Syntax
Default (Standard)
Set-SPOFileArchivePolicy
-PolicyId <Guid>
[-Name <String>]
[-PolicyType <SPOFileArchivePolicyType>]
[-LastAccessDateCriteria <Int32>]
[-FileTypeCriteria <String[]>]
[-IsWhatIfMode <Boolean>]
[-State <SPOFileArchivePolicyState>]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet aktualisiert die Eigenschaften einer vorhandenen Dateiarchivrichtlinie. Nur die angegebenen Parameter werden aktualisiert. alle anderen Eigenschaften bleiben unverändert. Sie können den Status nicht auf Active festlegen, es sei denn, policyType ist AllSites oder mindestens eine Website wurde der Richtlinie mithilfe von Add-SPOSiteToFileArchivePolicyhinzugefügt.
Hinweis
Dieses Cmdlet ist Teil der Dateiarchivrichtlinienfunktion, die sich derzeit in der Vorschau befindet.
Beispiele
Beispiel 1
Set-SPOFileArchivePolicy -PolicyId "a1b2c3d4-e5f6-7890-abcd-ef1234567890" -State "Active"
Aktiviert die angegebene Dateiarchivrichtlinie.
Beispiel 2
Set-SPOFileArchivePolicy -PolicyId "a1b2c3d4-e5f6-7890-abcd-ef1234567890" -Name "Updated Policy Name" -LastAccessDateCriteria 12
Updates den Anzeigenamen und ändert die Kriterien für das letzte Zugriffsdatum für die angegebene Richtlinie in 12 Monate.
Beispiel 3
Set-SPOFileArchivePolicy -PolicyId "a1b2c3d4-e5f6-7890-abcd-ef1234567890" -IsWhatIfMode $true
Aktiviert WhatIf den Modus für die angegebene Richtlinie. Zukünftige Richtlinienausführungen melden berechtigte Dateien, ohne sie zu archivieren.
Parameter
-FileTypeCriteria
Gibt ein aktualisiertes Array von Dateierweiterungen an, das in die Richtlinie eingeschlossen werden soll. Nur Dateien, die den angegebenen Erweiterungen entsprechen, werden für die Archivierung berücksichtigt. Verwenden Sie das Format mit Punktpräfix. Legen Sie auf fest $null , um alle Dateitypen einzuschließen.
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 |
-IsWhatIfMode
Gibt an, ob die Richtlinie im WhatIf Modus ausgeführt wird. Wenn die Richtlinie auf $truefestgelegt ist, wertet die Richtlinie aus, welche Dateien die Archivierungskriterien erfüllen, und meldet die Ergebnisse, archiviert jedoch keine Dateien. Wenn diese Einstellung auf $falsefestgelegt ist, archiviert die Richtlinie Dateien normal, wenn sie aktiv 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 |
-LastAccessDateCriteria
Gibt die aktualisierte Anzahl von Monaten seit dem letzten Zugriff auf eine Datei an, bevor sie für die Archivierung geeignet ist. Gültige Werte reichen von 6 bis 48.
Parametereigenschaften
| Typ: | Int32 |
| 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
Gibt einen aktualisierten Anzeigenamen für die Richtlinie an.
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
Gibt den eindeutigen Bezeichner (GUID) der zu aktualisierenden Richtlinie an.
Parametereigenschaften
| Typ: | Guid |
| 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 |
-PolicyType
Gibt den aktualisierten Richtlinientyp an. Akzeptierte Werte sind AllSites (zielt alle Websites im Mandanten) und SelectedSites (ziele nur Websites, die der Richtlinie explizit hinzugefügt wurden).
Parametereigenschaften
| Typ: | SPOFileArchivePolicyType |
| Standardwert: | None |
| Zulässige Werte: | AllSites, SelectedSites |
| 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 |
-State
Gibt den aktualisierten Status der Richtlinie an. Akzeptierte Werte sind Active und Inactive. Eine Richtlinie kann nicht auf festgelegt werden, Active es sei denn, ihr PolicyType ist AllSites oder mindestens eine Website hinzugefügt wurde.
Parametereigenschaften
| Typ: | SPOFileArchivePolicyState |
| Standardwert: | None |
| Zulässige Werte: | Active, Inactive |
| 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 |
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.