{"id":25718,"date":"2018-10-22T18:42:55","date_gmt":"2018-10-22T14:42:55","guid":{"rendered":"https:\/\/www.msp360.com\/resources\/?page_id=25718"},"modified":"2020-09-08T14:33:35","modified_gmt":"2020-09-08T10:33:35","slug":"powershell","status":"publish","type":"page","link":"https:\/\/www.msp360.com\/resources\/documentation\/cli-api\/msp360-explorer\/powershell\/","title":{"rendered":"CloudBerry Explorer PowerShell Snap-in"},"content":{"rendered":"

CloudBerry Explorer offers PowerShell extension to manage file operations across Amazon Simple Storage Service (Amazon S3), Amazon Glacier and file system. Windows PowerShell is a command-line shell that helps IT professionals to easily control system and accelerate automation. It includes several system administration utilities, improved navigation of common management data such as the registry, certificate store, or WMI, etc.<\/p>\n

What is good about PowerShell and CloudBerry Explorer Snap-in?<\/b><\/p>\n

PowerShell Snap-in allows using the majority of Amazon S3 functionality. You can combine CloudBerry Explorer commands with PowerShell commands. PowerShell is designed to operate with .Net objects, so you are not limited to command syntax. You can write complicated scripts with loops and conditions. You can schedule periodical tasks like data backup or cleanup.<\/p>\n

\n
\n
PowerShell Snap-in is provided as-is. We don't offer support for this feature.<\/div>\n<\/div>\n
<\/div>\n<\/blockquote>\n

Supported Storage Providers:<\/b>\u00a0Amazon S3, Amazon Glacier, S3 compatible storage providers.<\/p>\n

This is an example of copying files from local disk to S3 bucket:<\/p>\n

Example:<\/b><\/p>\n

The file results.xls will be copied to the S3 bucket.<\/p>\n

$s3 = Get-CloudS3Connection -Key $key -Secret $secret\r\n$destination = $s3 | Select-CloudFolder -path \"myBucket\/weeklyreport\"\r\n$src = Get-CloudFilesystemConnection | Select-CloudFolder \"c:\\sales\\\"\r\n$src | Copy-CloudItem $destination -filter \"results.xls\"<\/code><\/pre>\n
This can be scheduled for every weekend to copy files into S3 storage (for safety reason for Example).<\/p>\n
Example:<\/b><\/p>\n
This will copy all files and folders from c:\\workdata\\ to S3 bucket \"myBucket\". A new directory named by date like 2008_11_01 will be created.<\/p>\n
$new_folder_format = Get-Date -uformat \"%Y_%m_%d\"\r\n$s3 = Get-CloudS3Connection -Key $key -Secret $secret\r\n$destination = $s3 | Select-CloudFolder -path \"myBucket\" | Add-CloudFolder $new_folder_format\r\n$src = Get-CloudFilesystemConnection | Select-CloudFolder -path \"c:\\workdata\\\"\r\n$src | Copy-CloudItem $destination -filter \"*\"<\/code><\/pre>\n
Commands<\/h2>\n
USING SSE-C IN AMAZON S3<\/b><\/p>\n
You can use Server Side Encryption with Customer-provided key (SSE-C) when uploading files to Amazon S3 and manage already SSE-C encrypted S3 files.<\/p>\n
There are new parameters:<\/p>\n
-DestinationSseCustomerKey<\/b>\u00a0(alias:\u00a0-DstSSEKey<\/b>) \u2013 defines an encryption key for copy, move or rename operation. This key is needed if you want to encrypt files with SSE-C.<\/p>\n
-SourceSseCustomerKey<\/b>\u00a0(alias:\u00a0-SrcSSEKey<\/b>) \u2013 defines an encryption key to download from Amazon S3 or edit file\u2019s settings for file(s) encrypted with SSE-C.<\/p>\n
Note:<\/b>\u00a0for the operations such as \"local to S3\" and \"S3 to local\" you need to specify only one key: -DstSSEKey for upload; -SrcSSEKey for download. For the operations such as \u201cS3 to S3\u201d or rename on S3 you can use two keys and they can be different \u2013 it allows you to modify the SSE-C key for already encrypted files.<\/p>\n
These parameters were added to the following commands:<\/p>\n
Copy-CloudItem
\nMove-CloudItem
\nRename-CloudItem
\nSet-CloudItemStorageClass (backward compatibility: Set-CloudStorageClass)
\nAdd-CloudItemHeaders
\nGet-CloudItemHeaders<\/p>\n
There is a new command:<\/p>\n
Set-CloudItemServerSideEncryption\u00a0<\/b>\u2013 allows to set or change the SSE settings for existing S3 file (e.g. set\/reset SSE-C encryption; reset any SSE encryption; switch SSE to SSE-C, or vice versa)<\/p>\n
Example: Upload to Amazon S3 with SSE-C<\/b><\/p>\n
1. Generate a 256-bit encryption key (256-bit key for AES-256) \u2013 this example demonstrates key generation using password-based key derivation functionality PBKDF2.<\/p>\n
$iterations = 100000\r\n$salt = [byte[]] (1,2,3,4,5,6,7,8)\r\n$password = \"My$Super9Password\"<\/span>\r\n$binaryKey=(New-Object System.Security.Cryptography.Rfc2898DeriveBytes([System.Text.Encoding]::UTF8.GetBytes($password), $salt, $iterations)).GetBytes(32)<\/code><\/pre>\n
IMPORTANT NOTE: $password is just an example value. Make sure to use your character sequence.<\/span><\/p>\n
2. Copy data from local to Amazon S3 with SSE-C using generated key:
\n$source | Copy-CloudItem $dest\u00a0-DstSSEkey $binaryKey<\/b>\u00a0-filter *<\/code>
\nwhere $source is a local folder, $dest is Amazon S3 bucket (folder). For example:<\/p>\n
$source = Get-CloudFilesystemConnection | Select-CloudFolder \"C:\\Company\\DailyReports\"\r\n$s3 = Get-CloudS3Connection -k yourAccessKey -s yourSecretKey\r\n$dest = $s3 | Select-CloudItem \"mycompany\/reports\"<\/code><\/pre>\n
Example: Download SSE-C encrypted file from Amazon S3<\/b>
\n$dest | Copy-CloudItem $source\u00a0-SrcSSEKey $binaryKey<\/b>\u00a0-filter \"monthlyReport-Jul2014.docx\"<\/code>
\nTo move files, just replace Copy-CloudItem with\u00a0Move-CloudItem.<\/b><\/p>\n
Example: Rename existing SSE-C encrypted file with keeping encryption with the same key<\/b>
\n$dest | Rename-CloudItem \u2013name \"monthlyReport-Jul2014.docx\" -newname \"monthlyReport-Aug2014.docx\"\u00a0-SrcSSEKey $binaryKey -DstSSEKey $binaryKey<\/b><\/code>
\nExample: Copy existing SSE-C encrypted file inside S3 with keeping encryption with the same key<\/b>
\n$dest | Copy-CloudItem $dest2 -filter \u201cmonthlyReport-Jul2014.docx\u201d\u00a0-SrcSSEkey $binaryKey -DstSSEkey $binaryKey<\/b><\/code>
\nExample: Set or change SSE-C encryption for existing S3 file<\/b><\/p>\n
Encrypt non-encrypted S3 file with SSE-C<\/u>
\n$dest | Set-CloudItemServerSideEncryption -filter \u201cmonthlyReport-May2014.docx\u201d\u00a0-DstSSEkey $binaryKey<\/b><\/code>
\nEncrypt non-encrypted S3 file with SSE<\/u>
\n$dest | Set-CloudItemServerSideEncryption -filter \u201cmonthlyReport-Apr2014.docx\u201d\u00a0-SSE<\/b><\/code>
\nDecrypt SSE-C encrypted S3 file (i.e. reset SSE-C)<\/u>
\n$dest | Set-CloudItemServerSideEncryption -filter \u201cmonthlyReport-May2014.docx\u201d\u00a0-SrcSSEKey $binaryKey<\/b><\/code>
\nReset SSE encryption for S3 file<\/u>
\n$dest | Set-CloudItemServerSideEncryption -filter \u201cmonthlyReport-Apr2014.docx\u201d\u00a0-SSE:$false<\/b><\/code>
\nExample: Change Storage Class for SSE-C encrypted file<\/b>
\n$dest | Set-CloudItemStorageClass -filter \u201cmonthlyReport-May2014.docx\u201d\u00a0-SrcSSEKey $binaryKey<\/b><\/code>
\nUPLOAD TO AMAZON GLACIER<\/b><\/p>\n
You can set the connection to your Amazon Glacier account, set connection options, upload files to Amazon Glacier and set filters for files to upload. Also, you can restore data from Amazon Glacier using PowerShell commands. Check out the Examples below:<\/p>\n
Example: Uploading to Amazon Glacier<\/b><\/p>\n
# Add snap-in
\nadd-pssnapin CloudBerryLab.Explorer.PSSnapIn<\/code>
\n# Enable logging and specify the path
\nSet-Logging -LogPath \"C:\\Users\\user1\\AppData\\Local\\CloudBerry S3 Explorer PRO\\Logs\\PowerShell.log\" -LogLevel Info<\/code>
\n# Create connection
\n$conn = Get-CloudGlacierConnection -Key [YOUR ACCESS KEY] -Secret [YOUR SECRET KEY]<\/code>
\n# Set options<\/p>\n
Set-CloudOption -GlacierRetrievalRateLimitType Specified\r\nSet-CloudOption -GlacierChunkSizeMB 4\r\nSet-CloudOption -GlacierParallelUpload 1\r\nSet-CloudOption -GlacierPeakRetrievalRateLimit 23.5<\/code><\/pre>\n
# Select vault
\n$vault = $conn | Select-CloudFolder -Path \"us-east-1\/[YOUR VAULT]\"<\/code>
\n# Let's copy to vault
\n$destination = $vault<\/code>
\n# Select source folder
\n$src = Get-CloudFilesystemConnection | Select-CloudFolder \"C:\\Tmp[YOUR SOURCE FOLDER PATH]\"<\/code>
\n# Upload files to Glacier by the filter
\n#$src | Copy-CloudItem $destination -filter \"sample.txt\"<\/code>
\n# Upload all files to Glacier
\n$src | Copy-CloudItem $destination -filter \"*\"<\/code>
\n# Delete vault
\n$conn | Remove-CloudBucket $vault<\/code>
\nExample: Retrieving data from Amazon Glacier<\/b><\/p>\n
# Add snap-in
\nadd-pssnapin CloudBerryLab.Explorer.PSSnapIn<\/code>
\n# Enable logging and specify the path
\nSet-Logging -LogPath \"C:\\Users\\user1\\AppData\\Local\\CloudBerry S3 Explorer PRO\\Logs\\PowerShell.log\" -LogLevel Info<\/code>
\n# Create connection
\n$conn = Get-CloudGlacierConnection -Key [YOUR ACCESS KEY] -Secret [YOUR SECRET KEY]<\/code>
\n# Get existing vault
\n$vault = $conn | Select-CloudFolder -Path \"us-east-1\/[YOUR VAULT]\"<\/code>
\n# Get vault inventory.<\/p>\n
Note:<\/b>\u00a0this command may take up to 5 hours to execute if inventory has not been prepared yet.
\n$invJob = $vault | Get-Inventory<\/code>
\n# Now read vault archives
\n$archives = $vault | get-clouditem<\/code>
\n# Select destination local folder.
\n$dst = Get-CloudFilesystemConnection | Select-CloudFolder \"C:\\Tmp [YOUR DESTINATION FOLDER PATH]\"<\/code>
\n# Copy files from vault. Only files located in C:\\Tmp folder are copied.<\/p>\n
Note:<\/b>\u00a0this command may take many hours to execute when files have not been prepared for copying yet.
\n$vault | Copy-CloudItem $dst -filter \"C:\\Tmp\\*.*\"<\/code>
\nENABLING SERVER SIDE ENCRYPTION<\/b><\/p>\n
SSE is enabled with \"-sse\" switch. Applicable for Copy-CloudItem and Copy-CloudSyncFolders commands when uploading to Amazon S3.<\/p>\n
Example: Enabling SSE for Copy-CloudItem<\/b>:
\nsource | Copy-CloudItem $dest -Filter *.mov\u00a0-sse<\/b><\/code>
\nExample: Enabling SSE for Copy-CloudSyncFolders<\/b>:
\n$src | Copy-CloudSyncFolders $destination -IncludeFiles \"*.jpg\"\u00a0-sse<\/b><\/code>
\nExample: Enable SSL for connection<\/b>:<\/p>\n
# Create a connection with SSL
\n$s3 = Get-CloudS3Connection -UseSSL -Key $key -Secret $secret<\/code>
\nOptions supported for Copy-CloudSyncFolders<\/b>:<\/p>\n
-StorageClass<\/b>\u00a0defines storage class for files (it can be rrs or standard, or standard_ia)<\/p>\n
-IncludeFiles<\/b>\u00a0allows to specify certain files for sync using the standard wildcards (for example: *.exe; *.dll; d*t.doc; *.t?t)<\/p>\n
-ExcludeFiles<\/b>\u00a0allows excluding certain files from sync using the standard wildcards (for Example *.exe; *.dll; d*t.doc; *.t?t)<\/p>\n
-ExcludeFolders<\/b>\u00a0allows skipping certain folders (for Example bin; *temp*; My*)<\/p>\n
Example: Sync only JPG files and setting RRS storage class while syncing the files to the S3 storage<\/b><\/p>\n
$s3 = Get-CloudS3Connection -Key $key -Secret $secret\r\n$destination = $s3 | Select-CloudFolder -Path \"myBucket\/weeklyreport\"\r\n$src = Get-CloudFilesystemConnection | Select-CloudFolder \"c:\\sales\\\"\r\n$src | Copy-CloudSyncFolders $destination -IncludeFiles \"*.jpg\" -StorageClass rrs<\/code><\/pre>\n
Example: Sync entire folder excluding \\temp folder and .tmp files<\/b><\/p>\n
$s3 = Get-CloudS3Connection -Key $key -Secret $secret\r\n$destination = $s3 | Select-CloudFolder -Path \"myBucket\/weeklyreport\"\r\n$src = Get-CloudFilesystemConnection | Select-CloudFolder \"c:\\sales\\\"\r\n$src | Copy-CloudSyncFolders $destination -IncludeSubfolders -ExcludeFiles \"*.tmp\" -ExcludeFolders \"temp\"<\/code><\/pre>\n
SETTING A STORAGE CLASS<\/b><\/p>\n
You can set a storage class for a certain file or several files:
\nSet-CloudStorageClass<\/code>
\nStorage Class:<\/b>\u00a0rrs, standard, standard_ia<\/p>\n
Example: Setting an RRS storage class to a specified item:<\/b><\/p>\n
$s3 = Get-CloudS3Connection -Key $key -Secret $secret\r\n$bucket = $s3 | Select-CloudFolder -Path $bucketname\r\n$item = $bucket | Get-CloudItem $itemname\r\n$item | Set-CloudStorageClass -StorageClass rrs<\/code><\/pre>\n
Example: Setting RRS storage class to all text files in a specified folder:<\/b><\/p>\n
$s3 = Get-CloudS3Connection -Key $key -Secret $secret\r\n$bucket = $s3 | Select-CloudFolder -Path $bucketname\r\n$folder = $bucket | Get-CloudItem $foldername\r\n$folder | Set-CloudStorageClass -Filter *.txt -StorageClass rrs<\/code><\/pre>\n
Or you can set storage class while copying files to S3 storage -StorageClass in\u00a0Copy-CloudItem<\/b>.<\/p>\n
Example: Setting RRS storage class to a file while uploading it to the S3 storage:<\/b><\/p>\n
$s3 = Get-CloudS3Connection -Key $key -Secret $secret\r\n$destination = $s3 | Select-CloudFolder -path \"myBucket\/weeklyreport\"\r\n$src = Get-CloudFilesystemConnection | Select-CloudFolder \"c:\\sales\\\"\r\n$src | Copy-CloudItem $destination -filter \"results.xls\" -StorageClass rrs<\/code><\/pre>\n
ADVANCED PARAMETERS FOR \"Copy-CloudSyncFolders\"<\/b><\/p>\n
Copy-CloudSyncFolders supports advanced parameters:<\/p>\n
-DeleteOnTarget<\/b>\u00a0delete files from the target if they no longer exist on the source<\/p>\n
-IncludeSubfolders<\/b>\u00a0include subfolders into synchronization<\/p>\n
-CompareByContent<\/b>\u00a0use MD5 hash to compare the content of files (PRO only)<\/p>\n
-MissingOnly<\/b>\u00a0copy only missing files, ignore files that exist both on source and target<\/p>\n
GENERATING WEB URLs<\/b><\/p>\n
Using Get-CloudUrl you can generate HTTP, HTTPS or RTMP URLs and also HTML code for streaming video files.<\/p>\n
Example: Generating short URL for JPG files and save the output to a file<\/b>
\n$dest | Get-CloudUrl -Filter *.jpg -Type HTTP -ChilpIt >> C:\\urls.txt<\/code>
\nExample: Generating signed URL<\/b>
\n$dest | Get-CloudUrl -Filter *.jpg -Type HTTPS -Expire 01\/01\/2011 >> C:\\urls.txt<\/code>
\nExample: Generating CloudFront signed URL (where $domain is a CloudFront distribution domain name)<\/b>
\n$dest | Get-CloudUrl -Filter *.jpg -Type HTTP -Expire 01\/01\/2011 -DomainName $domain>> C:\\urls.txt<\/code>
\nExample: Generate signed URL for the private content item (where $domain is Streaming distribution domain name)<\/b><\/p>\n
$policy = New-CloudPolicy -PrivateKey $privatekey -KeyPairId $keypairid -IsCanned\r\n$dest | Get-CloudUrl -Filter *.flv -Type RTMP -Policy $policy -Expire 01\/01\/2011 -DomainName $domain >> C:\\urls.txt<\/code><\/pre>\n
SETTING CUSTOM CONTENT TYPES AND HTTP HEADERS<\/b><\/p>\n
Example: Adding a new content type for .flv<\/b><\/p>\n
Add-CloudContentType -Extension .flv -Type video\/x-flv\r\nGet-CloudContentTypes\u00a0- displays a list of predefined and custom content types<\/code><\/pre>\n
Any file with .flv extension uploaded to S3 will have a proper content-type: video\/x-flv.<\/p>\n
Example: Getting HTTP headers for an item ($s3 is an S3 connection)<\/b>
\n$s3 | Select-CloudFolder myvideos | Get-CloudItem cats.flv | Get-CloudItemHeaders<\/code>
\nExample: Setting HTTP headers to items<\/b><\/p>\n
$headers = New-CloudHeaders Expires \"Thu, 1 Apr 12:00:00 GMT\"\r\n$s3 | Select-CloudFolder myvideos | Add-CloudItemHeaders -Filter *.flv -Headers $headers<\/code><\/pre>\n
Example: Setting HTTP headers when copy\/move<\/b><\/p>\n
$headers = New-CloudHeaders Cache-Control private\r\n$source | Copy-CloudItem $dest -Filter *.mov -Headers $headers<\/code><\/pre>\n
RENAMING ITEMS<\/b><\/p>\n
Example: Renaming folder \"favorites\" to \"thrillers\" that is located in the bucket \"my videos\"<\/b>
\n$s3 | Select-CloudFolder myvidoes | Rename-CloudItem -Name favourites -NewName thrillers<\/code>
\nAPPLY ACL FOR ALL SUBFOLDERS AND FILES<\/b><\/p>\n
Example: Make all files inside \"myvideos\/thrillers\" and its subfolders as public read<\/b>
\n$s3 | Select-CloudFolder myvideos\/thrillers | Add-CloudItemPermission< -UserName \"All Users\" -Read -Descendants<\/code>
\nSET LOGGING FOR POWERSHELL<\/b>
\nSet-Logging -LogPath <path> -LogLevel <value><\/code>
\nValues:<\/b>\u00a0nolog, fatal, error, warning, info, debug<\/p>\n
ADVANCED OPTIONS (PRO ONLY)<\/b>
\nSet-CloudOption -ThreadCount <number><\/code>
\nDefines count of threads for multithreading uploading\/downloading.
\nSet-CloudOption -UseCompression <value><\/code>
\nDefines whether to use compression or not.
\nSet-CloudOption -UseChunks <value> -ChunkSizeKB <sizeinKB><\/code>
\nDefines the size of the chunk in KB; files larger than a chunk will be divided into chunks.<\/p>\n
Values:<\/b>\u00a01 or 0<\/p>\n
If you want to download a file that was divided into chunks on S3 storage you should enable \"chunk transparency\" mode before downloading the file to download it as a single file:
\nSet-CloudOption -ChunkTransparency 1<\/code>
\nWhen you copy or move files to S3 these files can inherit ACL from parent object: bucket or folder.
\nSet-CloudOption -PermissionsInheritance <value><\/code>
\nValues:<\/b>\u00a0\"donotinherit\", \"onlyforcloudfront\", \"inheritall\"<\/p>\n
Example:<\/b><\/p>\n
Set-CloudOption -PermissionsInheritance \"inheritall\"\r\n$s3 = Get-CloudS3Connection <key> <secret>\r\n$destination = $s3 | Select-CloudFolder -path \"myBucket\/weeklyreport\"\r\n$src = Get-CloudFilesystemConnection | Select-CloudFolder \"c:\\sales\\\"\r\n$src | Copy-CloudItem $destination -filter \"results.xls\"<\/code><\/pre>\n
The file \"result.xls\" will automatically have the same ACL as \"myBucket\/weeklyreport\".
\nSet-CloudOption -KeepExistingHeaders<\/code>
\nKeep existing HTTP headers when replacing files on S3.
\nSet-CloudOption -DoNotChangePermissionsForExisting <value><\/code>
\nKeep ACL for files when replacing them on S3.<\/p>\n
Values:<\/b>\u00a01 or 0
\nSet-CloudOption -KeepExistingPemissionsOnCloudCopy <value><\/code>
\nKeep\u00a0source<\/b>\u00a0permissions when copying\u00a0within S3<\/b>.<\/p>\n
Values:<\/b>\u00a01 or 0<\/p>\n
Copy-CloudSyncFolders<\/b><\/p>\n
Copy-CloudSyncFolders synchronizes local folders with the Amazon S3 bucket. You should specify the source folder (local or S3) in the pipeline.<\/p>\n
-Source<\/b>\u00a0<CloudFolder> Amazon S3 bucket or folder or local folder<\/p>\n
-Target<\/b>\u00a0<CloudFolder> Amazon S3 bucket or folder or local folder<\/p>\n
Example:<\/b><\/p>\n
$s3 = Get-CloudS3Connection <key> <secret>\r\n$source = $s3 | Select-CloudFolder -Path boooks\/sync\r\n$local = Get-CloudFileSystemConnection\r\n$target = $local | Select-CloudFolder C:\\temp\\sync\r\n$source | Copy-CloudSyncFolders $target<\/code><\/pre>\n
Or synchronize content in both ways.
\n$source | Copy-CloudSyncFolders $target -Bidirectional<\/code>
\nNew-CloudBucket<\/b><\/p>\n
New-CloudBucket Creates a new bucket. You should specify S3 connection in pipeline.<\/p>\n
-Connection<\/b>\u00a0<CloudS3Connection> - S3 connection<\/p>\n
-Name<\/b>\u00a0<String> - Bucket name<\/p>\n
-Location<\/b>\u00a0<String> - Bucket location. US (USA) or EU (europe). By default US location is used.<\/p>\n
Example:<\/b><\/p>\n
$s3 = Get-CloudS3Connection <key> <secret>\r\n$s3 | New-CloudBucket mytestbucket EU Remove-CloudBucket<\/code><\/pre>\n
Removes bucket. Before bucket will be removed all contents must be removed. It can take a long time, progress is displayed.<\/p>\n
-Connection<\/b>\u00a0<CloudS3Connection> S3 Connection<\/p>\n
-Name<\/b>\u00a0<String> Bucket name<\/p>\n
-Force<\/b>\u00a0Suppress warning messages<\/p>\n
-Bucket<\/b>\u00a0<CloudFolder> Bucket object<\/p>\n
Example:<\/b>
\n$s3 | Remove-CloudBucket mytestbucket<\/code>
\nGet-CloudItemACL<\/b>\u00a0- Returns all access control entry for the specified item. It can be an S3 bucket, folder or file. You can get the item using Select-CloudFolder or Get-CloudItems commands.<\/p>\n
-Item<\/b>\u00a0<CloudItem> Cloud item, it can be a bucket, s3 folder or s3 file.<\/p>\n
Example:<\/b>
\n$fld = $s3 | Select-CloudFolder mytestbucket\/documents\u00a0$fld | Get-CloudItemACL<\/code>
\nAdd-CloudItemPermission\u00a0<\/b>- Grants permission to user or group. If the user is not in the ACL, user entry will be added.<\/p>\n
-Item <CloudItem><\/b>\u00a0Cloud item, it can be a bucket, s3 folder or s3 file.<\/p>\n
-UserName <String><\/b>\u00a0Username or group<\/p>\n
-Write<\/b>\u00a0Grant write permission<\/p>\n
-WriteACP<\/b>\u00a0Grant write ACP permission<\/p>\n
-Read<\/b>\u00a0Grant read permission<\/p>\n
-ReadACP<\/b>\u00a0Grant read ACP permission<\/p>\n
-FullControl<\/b>\u00a0Grant full control permission. This means that all other permits will be granted.<\/p>\n
-CloudACE <CloudACE><\/b>\u00a0Access control entry<\/p>\n
Example:<\/b>
\n$fld | Add-CloudItemPermission \"All Users\" -Read<\/code>
\nRemove-CloudItemPermission\u00a0<\/b>- Revokes permission to user or group. If the RemoveUser parameter is specified, user entry will be removed from the access control list.<\/p>\n
-Item <CloudItem><\/b>\u00a0Cloud item, it can be a bucket, s3 folder or s3 file.<\/p>\n
-UserName <String><\/b>\u00a0Username or group<\/p>\n
-Write<\/b>\u00a0Revoke write permission<\/p>\n
-WriteACP<\/b>\u00a0Revoke write ACP permission<\/p>\n
-Read<\/b>\u00a0Revoke read permission<\/p>\n
-ReadACP<\/b>\u00a0Revoke read ACP permission<\/p>\n
-FullControl<\/b>\u00a0Revoke full control permission. This means that all other permits will be removed.<\/p>\n
-CloudACE <CloudACE><\/b>\u00a0Access control entry<\/p>\n
Example:<\/b>
\n$fld | Remove-CloudItemPermission \"All Users\" -Read<\/code>
\nSet-CloudOption<\/b>\u00a0- Set options for snap-in<\/p>\n
-PathStyle <String><\/b>\u00a0- Path style if this flag is specified. VHost otherwise.<\/p>\n
-ProxyAddress <String><\/b>\u00a0- Proxy address<\/p>\n
-ProxyPort <Int32><\/b>\u00a0- Proxy port<\/p>\n
-ProxyUser <String><\/b>\u00a0- Proxy user name<\/p>\n
-ProxyPassword <String><\/b>\u00a0- Proxy user password<\/p>\n
-CheckFileConsistency<\/b>\u00a0- Check file consistency. The MD5 hash is used for checking.<\/p>\n
Other Commands<\/h2>\n
Add-CloudFolder<\/b>\u00a0- Create new folder<\/p>\n
-Folder <CloudFolder><\/code>\u00a0- Current folder
\n-Name <String><\/code>\u00a0- New folder name<\/p>\n
Copy-CloudItem<\/b>\u00a0- Copy cloud item (file or folder) to the Destination<\/p>\n
-Destination <CloudFolder><\/code>\u00a0- Destination folder
\n-Filter <String><\/code>\u00a0- Item filter, * and ? are permitted
\n-Folder <CloudFolder><\/code>\u00a0- Current folder<\/p>\n
Get-CloudFilesystemConnection<\/b>\u00a0- Get connection to local file system<\/p>\n
Get-CloudItem<\/b>\u00a0- List files and folder in current folder<\/p>\n
-Filter <String><\/code>\u00a0- Item filter, * and ? are permitted
\n-Folder <CloudFolder><\/code>\u00a0- Current folder<\/p>\n
Get-CloudRootFolder<\/b>\u00a0- Get root folders<\/p>\n
-Connection <BaseCloudConnection><\/code>\u00a0- Connection object<\/p>\n
Get-CloudS3Connection<\/b>\u00a0- Set Amazon S3 connection<\/p>\n
-Key <String><\/code>\u00a0- Access Key for S3 connection
\n-Secret <String><\/code>\u00a0- Secret Key for S3 connection
\n-Endpoint <String><\/code>\u00a0- Endpoint for S3 compatible storage
\n-UseSSL<\/code>\u00a0- Enables SSL for connection
\n-SignatureVersion<\/code>\u00a0- Defines an authentication version. By default, 4.<\/p>\n
Note: to define S3 compatible connection you need to specify Signature Version = 2
\n$s3 = Get-CloudS3Connection -Key $key -Secret $secret -SignatureVersion 2<\/code><\/p>\n
Get-CloudGlacierConnection<\/b>\u00a0- Set Amazon Glacier connection<\/p>\n
-Key <String><\/code>\u00a0- Access Key for Amazon Glacier connection
\n-Secret <String><\/code>\u00a0- Secret Key for Amazon Glacier connection
\n-UseSSL<\/code>\u00a0- Enables SSL for connection<\/p>\n
Move-CloudItem<\/b>\u00a0- Move cloud item (file or folder) to the Destination<\/p>\n
-Destination <CloudFolder><\/code>\u00a0- Destination folder
\n-Filter <String><\/code>\u00a0- Item filter, * and ? are permitted
\n-Folder <Folder><\/code>\u00a0- Current folder<\/p>\n
Remove-CloudItem<\/b>\u00a0- Remove cloud items (file or folder)<\/p>\n
-Filter <String><\/code>\u00a0- Item filter, * and ? are permitted
\n-Folder <CloudFolder><\/code>\u00a0- Current folder<\/p>\n
Select-CloudFolder<\/b>\u00a0- Get a cloud folder. It must be used for getting a folder for other commands as the current folder.<\/p>\n
-Connection <BaseCloudConnection><\/code>\u00a0- Connection object
\n-Path <String><\/code>\u00a0- Path
\n-Folder <CloudFolder><\/code>\u00a0- Folder object<\/p>\n
Installation<\/h2>\n
Powershell Snap-In must be registered and added to the console.<\/p>\n
System Requirements<\/b><\/p>\n
.NET Framework 4.0 (full version)
\nWindows Management Framework 3.0<\/p>\n
Registering Snap-In<\/b><\/p>\n
If the PowerShell is installed before the installation of CloudBerry Explorer, you do not need to install Snap-in. Otherwise, run the following command in the CloudBerry Explorer installation folder (c:\\Program Files\\CloudBerryLab\\CloudBerry Explorer for Amazon S3):
\nC:\\Windows\\Microsoft.NET\\Framework\\v4.0.30319\\InstallUtil.exe CloudBerryLab.Explorer.PSSnapIn.dll<\/p>\n
Note:<\/b>\u00a0For x64 the command must be like : C:\\Windows\\Microsoft.NET\\Framework64\\v4.0.30319\\InstallUtil.exe \"C:\\Program Files (x86)\\CloudBerryLab\\CloudBerry Explorer for Amazon S3\\CloudBerryLab.Explorer.PSSnapIn.dll\"<\/p>\n
Note:<\/b>\u00a0For PRO version the default installation folder is \"C:\\Program Files\\CloudBerryLab\\CloudBerry S3 Explorer PRO\"; on x64 - \"C:\\Program Files (x86)\\CloudBerryLab\\CloudBerry S3 Explorer PRO\"<\/p>\n
Note:<\/b>\u00a0You can do this from the command line or PowerShell.<\/p>\n
You can verify that the CloudBerry Explorer Snap-in is registered. Run the following command:<\/p>\n
Get-PSsnapin -Registered<\/code><\/p>\n
PowerShell displays registered Snap-Ins. Check that CloudBerryLab.Explorer.PSSnapIn is on the list.<\/p>\n
Adding Snap-In to console<\/b><\/p>\n
You can check that CloudBerry Explorer Snap-in is registered by the running command above.
\nTo add Snap-In to console run the following command:<\/p>\n
Add-PSSnapin CloudBerryLab.Explorer.PSSnapIn<\/code><\/p>\n
Now the new command will be available.<\/p>\n
Exporting console configuration<\/b><\/p>\n
You should run the Add-PSSnapin command anytime you start PowerShell or you can save the configuration using the following.<\/p>\n
    \n
  • Run PowerShell.<\/li>\n
  • Add Snap-In to console.<\/li>\n
  • Run the command: Export-Console CloudBerryExplorerConfig<\/li>\n<\/ul>\n
    CloudBerryExplorerConfig is the name of a console file to save the configuration. To start the PowerShell from a saved configuration run the command:
    \nC:\\Program Files\\Command Shell> PS -PSConsoleFile CloudBerryExplorerConfig.psc1.
    \nCloudBerry Explorer commands will be available.<\/p>\n","protected":false},"excerpt":{"rendered":"
    CloudBerry Explorer offers PowerShell extension to manage file operations across Amazon Simple Storage Service (Amazon S3), Amazon Glacier and file system. Windows PowerShell is a command-line shell that helps IT professionals to easily control system and accelerate automation. It includes several system administration utilities, improved navigation of common management data such as the registry, certificate […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":25715,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"page-template-cli.php","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-25718","page","type-page","status-publish","hentry","types-cli"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/pages\/25718","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/comments?post=25718"}],"version-history":[{"count":0,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/pages\/25718\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/pages\/25715"}],"wp:attachment":[{"href":"https:\/\/www.msp360.com\/resources\/wp-json\/wp\/v2\/media?parent=25718"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}