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>]
説明
指定されたバージョン ポリシーの変更されたコピーを返します。 このコマンドレットは、New-SPOTenantApplyFileVersionPolicyJobまたはGet-SPOTenantApplyFileVersionPolicyJobImpactに渡すことができる変更されたポリシーを構築するために、Get-SPOTenantVersionPolicyを含むパイプラインで使用することを目的としています。
-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 に設定します。
ポリシーが EnableAutoExpirationVersionTrim に設定されている場合に-ExpireVersionsAfterDays$true指定すると、エラーがスローされます。
既定のポリシーまたは -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
保持するメジャー バージョンの最大数。
ポリシーが EnableAutoExpirationVersionTrim に設定されている場合に-ExpireVersionsAfterDays$true指定すると、エラーがスローされます。
既定のポリシーまたは -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に渡す前に、返されたポリシー オブジェクトを常に確認して、目的の構成が反映されていることを確認します。