Public/Drive/Update-GSTeamDrive.ps1
|
function Update-GSTeamDrive { <# .SYNOPSIS Update metatdata for a Team Drive .DESCRIPTION Update metatdata for a Team Drive .PARAMETER TeamDriveId The unique Id of the Team Drive to update .PARAMETER User The user to create the Team Drive for (must have permissions to create Team Drives) .PARAMETER Name The name of the Team Drive .PARAMETER CanAddChildren Whether the current user can add children to folders in this Team Drive .PARAMETER CanChangeTeamDriveBackground Whether the current user can change the background of this Team Drive .PARAMETER CanComment Whether the current user can comment on files in this Team Drive .PARAMETER CanCopy Whether the current user can copy files in this Team Drive .PARAMETER CanDeleteTeamDrive Whether the current user can delete this Team Drive. Attempting to delete the Team Drive may still fail if there are untrashed items inside the Team Drive .PARAMETER CanDownload Whether the current user can download files in this Team Drive .PARAMETER CanEdit Whether the current user can edit files in this Team Drive .PARAMETER CanListChildren Whether the current user can list the children of folders in this Team Drive .PARAMETER CanManageMembers Whether the current user can add members to this Team Drive or remove them or change their role .PARAMETER CanReadRevisions Whether the current user can read the revisions resource of files in this Team Drive .PARAMETER CanRemoveChildren Whether the current user can remove children from folders in this Team Drive .PARAMETER CanRename Whether the current user can rename files or folders in this Team Drive .PARAMETER CanRenameTeamDrive Whether the current user can rename this Team Drive .PARAMETER CanShare Whether the current user can share files or folders in this Team Drive .EXAMPLE Update-GSTeamDrive -TeamDriveId '0AJ8Xjq3FcdCKUk9PVA' -Name "HR Document Repo" Updated the Team Drive with a new name, "HR Document Repo" #> [cmdletbinding()] Param ( [parameter(Mandatory = $true,Position = 0)] [String] $TeamDriveId, [parameter(Mandatory = $false,Position = 0,ValueFromPipelineByPropertyName = $true)] [Alias('Owner','PrimaryEmail','UserKey','Mail')] [string] $User = $Script:PSGSuite.AdminEmail, [parameter(Mandatory = $false)] [String] $Name, [parameter(Mandatory = $false)] [Switch] $CanAddChildren, [parameter(Mandatory = $false)] [Switch] $CanChangeTeamDriveBackground, [parameter(Mandatory = $false)] [Switch] $CanComment, [parameter(Mandatory = $false)] [Switch] $CanCopy, [parameter(Mandatory = $false)] [Switch] $CanDeleteTeamDrive, [parameter(Mandatory = $false)] [Switch] $CanDownload, [parameter(Mandatory = $false)] [Switch] $CanEdit, [parameter(Mandatory = $false)] [Switch] $CanListChildren, [parameter(Mandatory = $false)] [Switch] $CanManageMembers, [parameter(Mandatory = $false)] [Switch] $CanReadRevisions, [parameter(Mandatory = $false)] [Switch] $CanRemoveChildren, [parameter(Mandatory = $false)] [Switch] $CanRename, [parameter(Mandatory = $false)] [Switch] $CanRenameTeamDrive, [parameter(Mandatory = $false)] [Switch] $CanShare ) Begin { if ($User -ceq 'me') { $User = $Script:PSGSuite.AdminEmail } elseif ($User -notlike "*@*.*") { $User = "$($User)@$($Script:PSGSuite.Domain)" } $serviceParams = @{ Scope = 'https://www.googleapis.com/auth/drive' ServiceType = 'Google.Apis.Drive.v3.DriveService' User = $User } $service = New-GoogleService @serviceParams } Process { try { $body = New-Object 'Google.Apis.Drive.v3.Data.TeamDrive' $capabilities = New-Object 'Google.Apis.Drive.v3.Data.TeamDrive+CapabilitiesData' foreach ($key in $PSBoundParameters.Keys) { switch ($key) { Default { if ($capabilities.PSObject.Properties.Name -contains $key) { $capabilities.$key = $PSBoundParameters[$key] } elseif ($body.PSObject.Properties.Name -contains $key) { $body.$key = $PSBoundParameters[$key] } } } } $body.Capabilities = $capabilities $request = $service.Teamdrives.Update($body,$TeamDriveId) Write-Verbose "Updating Team Drive '$Name' for user '$User'" $request.Execute() | Select-Object @{N = "User";E = {$User}},* } catch { if ($ErrorActionPreference -eq 'Stop') { $PSCmdlet.ThrowTerminatingError($_) } else { Write-Error $_ } } } } |