Set-AzDataLakeGen2ItemAclObject

參考

模組:: Az.Storage

建立/更新 DataLake gen2 專案 ACL 物件，可用於 Update-AzDataLakeGen2Item Cmdlet。

Syntax

Set-AzDataLakeGen2ItemAclObject
   [-EntityId <String>]
   [-DefaultScope]
   -Permission <String>
   [-InputObject <PSPathAccessControlEntry[]>]
   -AccessControlType <AccessControlType>
   [<CommonParameters>]

Description

Set-AzDataLakeGen2ItemAclObject Cmdlet 會建立/更新 DataLake gen2 專案 ACL 物件，該對象可用於 Update-AzDataLakeGen2Item Cmdlet。如果具有相同 AccessControlType/EntityId/DefaultScope 的新 ACL 專案不存在於輸入 ACL 中，則會建立新的 ACL 專案，否則會更新現有 ACL 專案的許可權。

範例

範例 1：使用 3 個 ACL 專案建立 ACL 物件，並在目錄上更新 ACL

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -Permission rwx -DefaultScope
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType group -Permission rw- -InputObject $acl 
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType other -Permission "rw-" -InputObject $acl
Update-AzDataLakeGen2Item -FileSystem "filesystem1" -Path "dir1/dir3" -ACL $acl

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group               
----                 -----------  ------          ------------         -----------  -----                -----               
dir1/dir3            True                         2020-03-23 09:34:31Z rwxrw-rw-+   $superuser           $superuser

此命令會建立具有 3 個 ACL 專案的 ACL 物件（使用 -InputObject 參數將 acl 專案新增至現有的 acl 物件），並更新目錄上的 ACL。

範例 2：建立具有 4 個 ACL 專案的 ACL 物件，以及更新現有 ACL 專案的許可權

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -Permission rwx -DefaultScope
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType group -Permission rw- -InputObject $acl 
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType other -Permission "rwt" -InputObject $acl
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -EntityId $id -Permission rwx -InputObject $acl 
$acl

DefaultScope AccessControlType EntityId                             Permissions
------------ ----------------- --------                             -----------
True         User                                                   rwx        
False        Group                                                  rw-        
False        Other                                                  rwt        
False        User              ********-****-****-****-************ rwx        

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -EntityId $id -Permission r-x -InputObject $acl 
$acl  

DefaultScope AccessControlType EntityId                             Permissions
------------ ----------------- --------                             -----------
True         User                                                   rwx        
False        Group                                                  rw-        
False        Other                                                  rw-        
False        User              ********-****-****-****-************ r-x

此命令會先建立具有 4 個 ACL 專案的 ACL 物件，然後以不同的許可權再次執行 Cmdlet，但現有 ACL 專案的 AccessControlType/EntityId/DefaultScope 相同。接著會更新 ACL 項目的許可權，但不會新增新的 ACL 專案。

參數

-AccessControlType

有四種類型：「user」會授與擁有者或具名使用者的許可權、「群組」將許可權授與擁有者群組或具名群組、「遮罩」會限制授與給具名使用者和群組成員的許可權，而「其他」會將許可權授與在任何其他專案中找不到的所有使用者。

Type:	AccessControlType
Accepted values:	User, Group, Mask, Other
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultScope

設定此參數以指出 ACE 屬於目錄的預設 ACL;否則範圍是隱含的，且 ACE 屬於存取 ACL。

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

-EntityId

使用者或群組標識碼。 AccessControlType “mask” 和 “other” 的專案會省略它。擁有者和擁有者群組也會省略使用者或群組標識符。

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

-InputObject

如果輸入 PSPathAccessControlEntry[] 物件，則會將新的 ACL 新增為輸入 PSPathAccessControlEntry[] 物件的新元素。

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

-Permission

許可權欄位是3個字元序列，第一個字元是『r』以授與讀取許可權，第二個字元是『w』以授與寫入許可權，而第三個字元是『x』以授與執行許可權。如果未授與存取權，則會使用『-』字元來表示許可權遭到拒絕。黏性位也受到支持，並且會根據其他類別的執行位是分別設定或未設定其他類別的執行位，以字母 t 或 T 表示其以字母 t 或 T 表示未設定的黏性位。

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

輸入

None

輸出

PSPathAccessControlEntry