Set-SPOFileArchivePolicy
Aggiornamenti di un criterio di archiviazione file esistente.
Sintassi
Default (Impostazione predefinita)
Set-SPOFileArchivePolicy
-PolicyId <Guid>
[-Name <String>]
[-PolicyType <SPOFileArchivePolicyType>]
[-LastAccessDateCriteria <Int32>]
[-FileTypeCriteria <String[]>]
[-FileTypeExclusionCriteria <String[]>]
[-IsWhatIfMode <Boolean>]
[-State <SPOFileArchivePolicyState>]
[<CommonParameters>]
Descrizione
Questo cmdlet aggiorna le proprietà di un criterio di archiviazione file esistente. Verranno aggiornati solo i parametri specificati. Tutte le altre proprietà rimangono invariate.
Per attivare un SelectedSites criterio, è necessario che almeno un sito sia stato aggiunto come inclusione usando Add-SPOSiteToFileArchivePolicy senza -Exclude. I siti esclusi non soddisfano questo requisito. Lo stesso requisito si applica quando si modifica un criterio attivo AllSites o AllODBSites .SelectedSites Un AllSites criterio OR AllODBSites non richiede l'attivazione dei siti inclusi in modo esplicito.
Nota
Questo cmdlet fa parte della funzionalità dei criteri di archiviazione file attualmente disponibile in anteprima.
Esempio
Esempio 1
Set-SPOFileArchivePolicy -PolicyId "a1b2c3d4-e5f6-7890-abcd-ef1234567890" -State "Active"
Attiva il criterio di archiviazione file specificato.
Esempio 2
Set-SPOFileArchivePolicy -PolicyId "a1b2c3d4-e5f6-7890-abcd-ef1234567890" -Name "Updated Policy Name" -LastAccessDateCriteria 12
Aggiornamenti il nome visualizzato e modifica i criteri dell'ultima data di accesso a 12 mesi per il criterio specificato.
Esempio 3
Set-SPOFileArchivePolicy -PolicyId "a1b2c3d4-e5f6-7890-abcd-ef1234567890" -IsWhatIfMode $true
Abilita WhatIf la modalità nei criteri specificati. Le esecuzioni future dei criteri segnaleranno i file idonei senza archiviarli.
Parametri
-FileTypeCriteria
Specifica una matrice aggiornata di estensioni di file da includere nel criterio, in formato con prefisso (ad esempio, .docx). Solo i file che corrispondono alle estensioni specificate vengono considerati per l'archiviazione.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-FileTypeExclusionCriteria
Specifica una matrice aggiornata di estensioni di file da escludere dal criterio, in formato con prefisso (ad esempio, .docx). I Files corrispondenti alle estensioni specificate non vengono archiviati.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IsWhatIfMode
Specifica se il criterio viene eseguito in WhatIf modalità. Se impostato su $true, il criterio valuterà quali file soddisfano i criteri di archiviazione e segnalerà i risultati, ma non archivierà effettivamente alcun file. Se impostato su $false, il criterio archivia i file normalmente quando è attivo.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-LastAccessDateCriteria
Specifica il numero aggiornato di mesi dall'ultimo accesso a un file prima che diventi idoneo per l'archiviazione. I valori validi sono compresi tra 6 e 48.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica un nome visualizzato aggiornato per il criterio.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PolicyId
Specifica l'identificatore univoco (GUID) dei criteri da aggiornare.
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PolicyType
Specifica il tipo di criterio aggiornato. I valori accettati sono:
-
AllSites: il criterio si applica a tutti i siti di SharePoint nel tenant. -
AllODBSites: il criterio si applica a tutti i siti di OneDrive for Business nel tenant. -
SelectedSites: il criterio si applica solo ai siti aggiunti in modo esplicito.
La modifica di un sito attivo AllSites o AllODBSites di un criterio richiede SelectedSites almeno un sito incluso. I siti esclusi non soddisfano questo requisito.
Proprietà dei parametri
| Tipo: | SPOFileArchivePolicyType |
| Valore predefinito: | None |
| Valori accettati: | AllSites, SelectedSites, AllODBSites |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-State
Specifica lo stato aggiornato del criterio. I valori accettati sono Active e Inactive. Un SelectedSites criterio richiede almeno un sito incluso prima di poter essere impostato su Active; i siti esclusi non soddisfano questo requisito. È possibile attivare un AllSites criterio OR AllODBSites senza includere esplicitamente i siti.
Proprietà dei parametri
| Tipo: | SPOFileArchivePolicyState |
| Valore predefinito: | None |
| Valori accettati: | Active, Inactive |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.