New-CustomPermissions

  • リファレンス
モジュール:
PurviewInformationProtection

カスタムアクセス許可のアドホック保護ポリシーを作成します。

構文

New-CustomPermissions
   -Users <String[]>
   -Permissions <Permissions>
   [-ExpirationDate <DateTime>]
   [<CommonParameters>]

説明

New-CustomPermissions コマンドレットは、変数として格納するカスタムアクセス許可のアドホック保護ポリシー オブジェクトを作成し、ラベル付けコマンドレット Set-FileLabel を実行するときに使用してファイルまたはファイルを保護します。

適用されるラベルが保護設定用に構成されている場合、アドホック保護ポリシーのカスタム アクセス許可によって、ラベルの保護設定が置き換えられます。

例

例 1 - 1 人のユーザーのアドホック保護ポリシー オブジェクトを作成する

PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com -Permissions Viewer

このコマンドは、レビュー担当者のアクセス許可からuser1 contoso.com 使用権限を付与し、このポリシーを 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

アドホック保護ポリシーの有効期限を指定します。

この有効期限が切れた後、指定されたユーザーはファイルまたはファイルにアクセスできなくなります。 ただし、有効期限に達した後でも、所有者とスーパー ユーザーは常にファイルにアクセスできます。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Permissions

一般的に一緒に使用される使用権限をグループ化するアクセス許可レベルを指定します。 指定したユーザーに使用権限を付与するには、このパラメーターと Users パラメーターを使用します。

各アクセス許可レベルに含まれる個々の使用権限を確認するには、「権限レベル に含まれる権限」を参照してください。

Type:Permissions
Accepted values:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Users

ファイルまたはファイルを使用する権限を持つユーザーを指定します。 このパラメーターと Permission パラメーターを使用して、指定したユーザーまたはグループに権限を付与します。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

System.Object