< Back

Remove-GcsBucketAcl

Mon Jan 13, 2020 11:42 pm

NAME Remove-GcsBucketAcl



SYNOPSIS

Removes an access control from a Google Cloud Storage bucket.





SYNTAX

Remove-GcsBucketAcl [-Name] <string> -User <string> [<CommonParameters>]



Remove-GcsBucketAcl [-Name] <string> -Group <string> [<CommonParameters>]



Remove-GcsBucketAcl [-Name] <string> -Domain <string> [<CommonParameters>]



Remove-GcsBucketAcl [-Name] <string> -ProjectNumber <string> -ProjectRole <string> [<CommonParameters>]



Remove-GcsBucketAcl [-Name] <string> [-AllUsers <SwitchParameter>] [<CommonParameters>]



Remove-GcsBucketAcl [-Name] <string> [-AllAuthenticatedUsers <SwitchParameter>] [<CommonParameters>]





DESCRIPTION

Removes an access control from a Google Cloud Storage bucket for an entity. Entity can be user ID, user email

address, project team, group ID, group email address, all users or all authenticated users. The roles that can be

assigned to an entity are Reader, Writer and Owner. User must have access to the bucket. Assumes the entity

already have an access control for the bucket.





PARAMETERS

-Name <string>

The name of the bucket that the access control will be removed from.



Required? true

Position? 0

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Bucket <string>

The name of the bucket that the access control will be removed from.



This is an alias of the Name parameter.



Required? true

Position? 0

Default value

Accept pipeline input? false

Accept wildcard characters? false



-User <string>

The user holding the access control. This can either be an email or a user ID.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-UserId <string>

The user holding the access control. This can either be an email or a user ID.



This is an alias of the User parameter.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-UserEmail <string>

The user holding the access control. This can either be an email or a user ID.



This is an alias of the User parameter.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Group <string>

The group holding the access control. This can either be an email or an ID.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-GroupId <string>

The group holding the access control. This can either be an email or an ID.



This is an alias of the Group parameter.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-GroupEmail <string>

The group holding the access control. This can either be an email or an ID.



This is an alias of the Group parameter.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Domain <string>

The domain holding the access control.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ProjectNumber <string>

The project number of the project holding the access control. This is used in conjunction with -ProjectRole

parameter to specify a project team.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ProjectRole <string>

The project role (in the project specified by -ProjectNumber) holding the access control.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-AllUsers <SwitchParameter>

If set, the access control will be for all user.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-AllAuthenticatedUsers <SwitchParameter>

If set, the access control will be for all authenticated user.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



---------- EXAMPLE 1 ----------



PS C:\\> Remove-GcsBucketAcl -Bucket "my-bucket" -User user@example.com



Removes access control to bucket "my-bucket" for user user@example.com.

---------- EXAMPLE 2 ----------



PS C:\\> Remove-GcsBucketAcl -Bucket "my-bucket" -Domain example.com



Removes access control to bucket "my-bucket" for the domain example.com.

---------- EXAMPLE 3 ----------



PS C:\\> Remove-GcsBucketAcl -Bucket "my-bucket" -AllUsers



Removes access control to bucket "my-bucket" for all users.

---------- EXAMPLE 4 ----------



PS C:\\> Remove-GcsBucketAcl -Bucket "my-bucket" -ProjectRole Owners -ProjectNumber 3423432



Removes access control to bucket "my-bucket" for all owners of project 3423432.



RELATED LINKS

[Access Control Lists (ACLs)] (https://cloud.google.com/storage/docs/a ... trol/lists)

[Bucket Access Controls] (https://cloud.google.com/storage/docs/j ... ssControls)