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.

Input

None

Output

System.Object