New-CustomPermissions
カスタム権限のアドホック保護ポリシーを作成します。
構文
Default (既定)
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
説明
New-CustomPermissions コマンドレットは、変数として格納し、ラベル付けコマンドレット Set-FileLabel を実行するときにファイルを保護するために使用するカスタムアクセス許可のアドホック保護ポリシー オブジェクトを作成します。
適用されるラベルが保護設定用に構成されている場合、アドホック保護ポリシーのカスタムアクセス許可がラベルの保護設定を置き換えます。
例
例 1 - 1 人のユーザーのアドホック保護ポリシー オブジェクトの作成
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com -Permissions Viewer
このコマンドは、 user1 from の contoso.com Review のアクセス許可からの使用権限を付与するアドホック保護ポリシーオブジェクトを作成し、このポリシーを permissions という名前の変数に格納します。 このアドホック保護ポリシーを使用して、ファイルに保護を適用できます。
このコマンドの出力は表示されません。
例 2 - 有効期限のある、複数のユーザー用のアドホック保護ポリシーオブジェクトを作成する
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
このコマンドは、さまざまな組織のユーザーにレビュー担当者のアクセス許可からの使用権限を付与するアドホック保護ポリシー オブジェクトを作成し、有効期限も適用します。 アドホック保護ポリシー オブジェクトは、permissions という名前の変数に格納され、この変数を使用して、この保護をファイルに適用できます。
このコマンドの出力は表示されません。
パラメーター
-ExpirationDate
アドホック保護ポリシーの有効期限を指定します。
この有効期限を過ぎると、指定したユーザーはファイルにアクセスできなくなります。 ただし、所有者とスーパー ユーザーは、有効期限に達した後でも、常にファイルにアクセスできます。
パラメーターのプロパティ
| 型: | DateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Permissions
通常は一緒に使用される使用権限をグループ化するアクセス許可レベルを指定します。 このパラメータと Users パラメータを使用して、指定したユーザーに使用権限を付与します。
各アクセス許可レベルに含まれる個々の使用権限については、「 アクセス許可レベルに含まれる権限」を参照してください。
パラメーターのプロパティ
| 型: | Permissions |
| 規定値: | None |
| 指定可能な値: | Viewer, Reviewer, CoAuthor, CoOwner |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Users
ファイルを使用する権限を持つユーザーを指定します。 このパラメータと Permission パラメータを使用して、指定したユーザーまたはグループに権限を付与します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |