We are proud to share our inclusion in the 2024 Gartner Magic Quadrant for Data Integration Tools. We believe this recognition reflects the differentiated business outcomes CData delivers to our customers.
Get the Report →Automate Box Integration Tasks from PowerShell
Are you in search of a quick and easy way to access Box data from PowerShell? This article demonstrates how to utilize the Box Cmdlets for tasks like connecting to Box data, automating operations, downloading data, and more.
The CData Cmdlets for Box are standard PowerShell cmdlets that make it easy to accomplish data cleansing, normalization, backup, and other integration tasks by enabling real-time and bidirectional access to Box.
PowerShell Cmdlets or ADO.NET Provider?
The Cmdlets are not only a PowerShell interface to Box, but also an SQL interface; this tutorial shows how to use both to create, retrieve, update, and delete Box data. We also show examples of the ADO.NET equivalent, which is possible with the CData ADO.NET Provider for Box. To access Box data from other .NET applications, like LINQPad, use the CData ADO.NET Provider for Box.
Once you have acquired the necessary connection properties, accessing Box data in PowerShell can be enabled in three steps.
Box uses the OAuth standard to authenticate. To authenticate to Box, you will need to obtain the OAuthClientId, OAuthClientSecret, and CallbackURL by registering an app. See the "Getting Started" chapter of the help documentation for a guide to using OAuth.
PowerShell
-
Install the module:
Install-Module BoxCmdlets
-
Connect:
$box = Connect-Box -OAuthClientId "$OAuthClientId" -OAuthClientSecret "$OAuthClientSecret" -CallbackURL "$CallbackURL"
-
Search for and retrieve data:
$id = "123" $files = Select-Box -Connection $box -Table "Files" -Where "Id = `'$Id`'" $files
You can also use the Invoke-Box cmdlet to execute SQL commands:
$files = Invoke-Box -Connection $box -Query 'SELECT * FROM Files WHERE Id = @Id' -Params @{'@Id'='123'}
ADO.NET
-
Load the provider's assembly:
[Reflection.Assembly]::LoadFile("C:\Program Files\CData\CData ADO.NET Provider for Box\lib\System.Data.CData.Box.dll")
-
Connect to Box:
$conn= New-Object System.Data.CData.Box.BoxConnection("OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;InitiateOAuth=GETANDREFRESH") $conn.Open()
-
Instantiate the BoxDataAdapter, execute an SQL query, and output the results:
$sql="SELECT Name, Size from Files" $da= New-Object System.Data.CData.Box.BoxDataAdapter($sql, $conn) $dt= New-Object System.Data.DataTable $da.Fill($dt) $dt.Rows | foreach { Write-Host $_.name $_.size }
Update Box Data
PowerShell
Update-Box -Connection $Box -Columns @('Name','Size') -Values @('MyName', 'MySize') -Table Files -Id "MyId"
ADO.NET
$cmd = New-Object System.Data.CData.Box.BoxCommand("UPDATE Files SET Id='123' WHERE Id = @myId", $conn)
$cmd.Parameters.Add((New-Object System.Data.CData.Box.BoxParameter("@myId","10456255-0015501366")))
$cmd.ExecuteNonQuery()
Insert Box Data
PowerShell
Add-Box -Connection $Box -Table Files -Columns @("Name", "Size") -Values @("MyName", "MySize")
ADO.NET
$cmd = New-Object System.Data.CData.Box.BoxCommand("INSERT INTO Files (Id) VALUES (@myId)", $conn)
$cmd.Parameters.Add((New-Object System.Data.CData.Box.BoxParameter("@myId","123")))
$cmd.ExecuteNonQuery()
Delete Box Data
PowerShell
Remove-Box -Connection $Box -Table "Files" -Id "MyId"
ADO.NET
$cmd = New-Object System.Data.CData.Box.BoxCommand("DELETE FROM Files WHERE Id=@myId", $conn)
$cmd.Parameters.Add((New-Object System.Data.CData.Box.BoxParameter("@myId","001d000000YBRseAAH")))
$cmd.ExecuteNonQuery()
CodeProject