Get-SPOVersionPolicyWithChanges

ローカルで変更されたバージョン ポリシーのコピーを返します。

構文

Default (既定)

Get-SPOVersionPolicyWithChanges
    -VersionPolicy <SPOFileVersionPolicySettings>
    [-MajorVersionLimit <Int32>]
    [-ExpireVersionsAfterDays <Int32>]
    [-EnableAutoExpirationVersionTrim <Boolean>]
    [<CommonParameters>]

FileType

Get-SPOVersionPolicyWithChanges
    -VersionPolicy <SPOFileVersionPolicySettings>
    -FileType <String>
    [-MajorVersionLimit <Int32>]
    [-ExpireVersionsAfterDays <Int32>]
    [-EnableAutoExpirationVersionTrim <Boolean>]
    [<CommonParameters>]

FileTypeRemove

Get-SPOVersionPolicyWithChanges
    -VersionPolicy <SPOFileVersionPolicySettings>
    -FileType <String>
    [-Remove]
    [<CommonParameters>]

説明

指定されたバージョン ポリシーの変更されたコピーを返します。 このコマンドレットは、 Get-SPOTenantVersionPolicy のパイプラインで使用して、変更されたポリシーを構築して New-SPOTenantApplyFileVersionPolicyJob または Get-SPOTenantApplyFileVersionPolicyJobImpact に渡すことを目的としています。

-FileTypeを省略すると、既定のポリシー設定が変更されます。 -FileTypeを指定すると、その種類のファイルの種類ごとのオーバーライドが作成または更新されます。 サポートされているファイルの種類名については、「 SharePoint のファイルの種類のバージョン制限」を参照してください。

-Remove を -FileType で使用して、ファイルの種類ごとのオーバーライドを削除します。

例

例 1

Get-SPOTenantVersionPolicy | Get-SPOVersionPolicyWithChanges -MajorVersionLimit 100

現在のテナント バージョン ポリシーを取得し、既定のメジャー バージョン制限が 100 に変更されたコピーを返します。

例 2

Get-SPOTenantVersionPolicy | Get-SPOVersionPolicyWithChanges -FileType "video" -MajorVersionLimit 50 -ExpireVersionsAfterDays 180

現在のテナント バージョン ポリシーを取得し、メジャー バージョンが 50 に制限され、180 日後にバージョンが期限切れになる video ファイルのファイルの種類ごとのオーバーライドを含むコピーを返します。

例 3

Get-SPOTenantVersionPolicy | Get-SPOVersionPolicyWithChanges -FileType "video" -Remove

現在のテナント バージョン ポリシーを取得し、 video ファイルの種類の上書きが削除されたコピーを返すため、 video ファイルは既定のポリシーにフォールバックします。

パラメーター

-EnableAutoExpirationVersionTrim

$true の場合は、自動有効期限を使用します。このポリシーでは、Microsoft が有効期限のスケジュールを管理します。 $false の場合は、-MajorVersionLimit と -ExpireVersionsAfterDays で定義された手動の有効期限スケジュールを使用します。

EnableAutoExpirationVersionTrim が $true の場合、MajorVersionLimitは常に 500、ExpireVersionsAfterDaysは常に 30 です。 その結果、 -EnableAutoExpirationVersionTrim を $false から $true に切り替えると、 MajorVersionLimit は 500 に、 ExpireVersionsAfterDays は 30 に設定されます。

既定のポリシーまたは -FileType で指定されたファイルの種類に適用されます。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Default
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
FileType
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExpireVersionsAfterDays

バージョンの有効期限が切れるまでの日数。 時間ベースの有効期限を無効にするには、[ 0 ] に設定します。

ポリシーが $true に設定されている場合EnableAutoExpirationVersionTrim-ExpireVersionsAfterDaysを指定すると、エラーがスローされます。

既定のポリシーまたは -FileType で指定されたファイルの種類に適用されます。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Default
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
FileType
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-FileType

ファイルの種類ごとの上書きを作成、更新、または削除する必要があるファイルの種類名。 サポートされている値は "audio"、"video"、"outlookspst" です。 既定のポリシーを変更する場合は、このパラメーターを省略します。 詳細については、「 SharePoint のファイルの種類のバージョン制限」を参照してください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FileType
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
FileTypeRemove
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MajorVersionLimit

保持するメジャー バージョンの最大数。

ポリシーが $true に設定されている場合EnableAutoExpirationVersionTrim-ExpireVersionsAfterDaysを指定すると、エラーがスローされます。

既定のポリシーまたは -FileType で指定されたファイルの種類に適用されます。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Default
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
FileType
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Remove

-FileTypeで識別されるファイルの種類ごとのオーバーライドを削除します。 -FileType は、このスイッチの指定時に必要です。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FileTypeRemove
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VersionPolicy

変更するバージョン ポリシー オブジェクト。通常は Get-SPOTenantVersionPolicy からパイプされます。 元のオブジェクトは変更されません。要求された変更を含む新しいオブジェクトが返されます。

パラメーターのプロパティ

型:SPOFileVersionPolicySettings
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。

入力

Microsoft.Online.SharePoint.TenantAdministration.SPOFileVersionPolicySettings

出力

Microsoft.Online.SharePoint.TenantAdministration.SPOFileVersionPolicySettings

メモ

返されたポリシー オブジェクトを New-SPOTenantApplyFileVersionPolicyJob または Get-SPOTenantApplyFileVersionPolicyJobImpact に渡す前に、必ず確認して、意図した構成が反映されていることを確認してください。