New-SPOTenantApplyFileVersionPolicyJob
Colas un trabajo para aplicar la directiva de versión de archivo de nivel de inquilino en todos los sitios. Se requiere la licencia de Administración avanzada de SharePoint o la licencia de Copilot para ejecutar este cmdlet.
Nota:
Esta característica está actualmente en versión preliminar y es posible que no esté disponible en el inquilino.
Sintaxis
WithExistingVersionPolicy (valor predeterminado)
New-SPOTenantApplyFileVersionPolicyJob
[-TrimVersions]
[-SetVersionPolicy]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
WithVersionPolicy
New-SPOTenantApplyFileVersionPolicyJob
-VersionPolicy <SPOFileVersionPolicySettings>
[-TrimVersions]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CollectData
New-SPOTenantApplyFileVersionPolicyJob
[-CollectVersionData]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Colas un trabajo para aplicar la directiva de versión de archivo de nivel de inquilino en todos los sitios. El trabajo recorta las versiones de archivo existentes o establece la directiva de versiones para las bibliotecas de documentos existentes en función de la directiva de versión configurada en el nivel de inquilino.
Los siguientes tipos de sitio se excluyen del procesamiento:
- Sitios de solo lectura
- Sitios bloqueados
- Sitios archivados
- Sitios con herencia rota de la directiva de versión
Nota:
- Las versiones eliminadas con este cmdlet se eliminarán permanentemente y no se podrán recuperar de la papelera de reciclaje.
- Use
Get-SPOTenantVersionPolicypara confirmar la directiva de versión de archivo de nivel de inquilino antes de ejecutar el cmdlet para asegurarse de que coincide con la configuración prevista. También puede usar elGet-SPOTenantcmdlet y comprobar lasEnableAutoExpirationVersionTrimpropiedades ,MajorVersionLimit,ExpireVersionsAfterDaysyVersionPolicyFileTypeOverride. - Si la directiva de versión de nivel de inquilino cambia mientras el trabajo está en curso, el trabajo aplicará la directiva actualizada a los sitios restantes que aún no se han procesado. Los sitios que ya se han procesado no se volverán a evaluar ni actualizar.
- Solo se permite un trabajo por inquilino.
- Use
-CollectVersionDataprimero y espere a que el trabajo se complete antes de ejecutarseGet-SPOTenantApplyFileVersionPolicyJobImpactpara calcular el impacto de una directiva sin eliminar ninguna versión. - Cuando
-VersionPolicyse especifica, la directiva de versión de nivel de inquilino siempre se actualiza y-SetVersionPolicyno es necesaria. Opcionalmente, agregue-TrimVersionspara recortar también las versiones existentes.
Ejemplos
Ejemplo 1
New-SPOTenantApplyFileVersionPolicyJob -TrimVersions -SetVersionPolicy
En el ejemplo 1 se inicia un trabajo de directiva de aplicación de archivos de inquilino para recortar las versiones existentes y establecer la directiva de versión para las bibliotecas de documentos existentes en todos los sitios.
Ejemplo 2
New-SPOTenantApplyFileVersionPolicyJob -TrimVersions
En el ejemplo 2 se inicia un trabajo de directiva de aplicación de archivos de inquilino para recortar las versiones existentes de los archivos de las bibliotecas de documentos en todos los sitios.
Ejemplo 3
New-SPOTenantApplyFileVersionPolicyJob -SetVersionPolicy
En el ejemplo 3 se inicia un trabajo de directiva de versión de archivo de aplicación de inquilinos para establecer la directiva de versión para las bibliotecas de documentos existentes en todos los sitios.
Ejemplo 4
New-SPOTenantApplyFileVersionPolicyJob -CollectVersionData
En el ejemplo 4 se inicia un trabajo para recopilar datos de versión en todos los sitios. Una vez completado el trabajo, use Get-SPOTenantApplyFileVersionPolicyJobImpact para calcular el impacto de una directiva de versión sin eliminar ninguna versión.
Ejemplo 5
$policy = Get-SPOTenantVersionPolicy | Get-SPOVersionPolicyWithChanges -MajorVersionLimit 100
New-SPOTenantApplyFileVersionPolicyJob -TrimVersions -VersionPolicy $policy
En el ejemplo 5 se recupera la directiva de versión del inquilino actual, se modifica el límite de versión principal a 100 localmente y, a continuación, se inicia un trabajo de recorte con esa directiva modificada. La directiva de nivel de inquilino se actualiza antes de que comience el trabajo.
Parámetros
-CollectVersionData
Recopila datos de versión en todos los sitios para su uso con Get-SPOTenantApplyFileVersionPolicyJobImpact. Use este modificador para ejecutar un paso de recopilación de datos antes de decidir si se deben recortar las versiones y cómo. El trabajo no elimina ninguna versión. No se puede combinar con -VersionPolicy o -SetVersionPolicy.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
CollectData
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SetVersionPolicy
Establece la directiva de versión para las bibliotecas de documentos existentes en todos los sitios en función de la directiva de versión de archivo de nivel de inquilino. La directiva de versión se aplica a las nuevas versiones creadas en estas bibliotecas de documentos existentes.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
WithExistingVersionPolicy
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TrimVersions
Recorta las versiones existentes de los archivos de las bibliotecas de documentos en todos los sitios en función de la directiva de versión de archivos de nivel de inquilino.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
WithExistingVersionPolicy
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
WithVersionPolicy
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-VersionPolicy
La nueva directiva de versión que se va a aplicar al inquilino antes de iniciar el trabajo. Cuando se especifica, la directiva de nivel de inquilino siempre se actualiza y la directiva de versión se propaga a todos los sitios. Opcionalmente, puede combinar con -TrimVersions para recortar también las versiones existentes.
Use Get-SPOTenantVersionPolicy y Get-SPOVersionPolicyWithChanges para compilar este valor.
Propiedades de parámetro
| Tipo: | SPOFileVersionPolicySettings |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
WithVersionPolicy
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.