Page Comparison

...

• I want to have a few aliases to shortcut DX commands

• I want to have a script that I can create a scratch org with

That’s about it.

Trailhead

This module might be helpful https://trailhead.salesforce.com/content/learn/modules/cli-basics

But you DO NOT NEED NODE OR NPM! (Yet). So ignore the Mac specific bits in the third module.

Getting Started

Well, you need to start at the begining… and gee is that hard. First of all just how many versions of Powershell are there? And does it need to be stand-alone or can it run in VS Code?

...

I started with Peter Chittum’s Apply the Salesforce CLI to Everyday Problems. Thankfully Peter is talking about Powershell and Bash these days. I went to the Github repo and all of a sudden was stuck. What is the ISE? Wh do I need to know about that? What is a profile? And everything past about half way in that video is a bit over my head - when he starts talking about “tail”, then I know he’s not talking to me. It’s like devs who just say “touch” the file. You know you are talking to a Mac dev and you know to just ignore and walk away and try to find someone that can speak your language.

So I think what he’s doing is trying to get you to have a default set of commands that open up each time you open VS Code. This is stored in a profile it seems. I could not work out Peter’s instructions though.

I found a simple set of instructions that were basically the same as Peter’s instructions… the trick is to start in VS Code and don’t leave VS Code. And don’t install the Powershell VS Code Extension.

I found this article to be helpful.

Test-Path $profile

...

this returns the folder where the profile is stored. I opened the folder in my file explorer then opened the profile file in vscode.

The file is Microsoft.PowerShell_profile.ps1 and is created in C:\Users\<username>\Documents\PowerShell\

You may also need to do the following, but I’m not sure because it was all very confusing. Try it without using this command and report back. “If the Execution Policy is set to RemoteSigned, you can run only foreign scripts from Trusted Publisher, but you can also run your own scripts (that are not signed).” From this article.

 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

...

Paste the contents of Peter Chittum’s sample profile into that file https://github.com/pchittum/everyday-sfcli/blob/master/utils/powershell-profile/Set-RecommendedProfileItems.ps1 and save. . But remove the cd~ at the top as that changes the directory out of your current working SFDX directory and you don’t want that.

Save, then Reload VS Code.

Open the terminal and type:

dxlist

A list of your scratch orgs appear! Magic!

...

still works too!

Extending Functions

Now we can see in Peter’s example that functions can be a bit more interactive.

Function dxopen ([string]$u) {
    If ($u -ne '') {
        sfdx force:org:open -u $u     
    } Else {
        sfdx force:org:open
    }
}

so now we can see we can add parameters to functions. The $u is saying whatever is entered directly after dxopen then stick it after the command sfdx force:org:open -u

So I want to add another command like that to set default org.

sfdx force:config:set defaultusername=

Function dxdefault ([string]$u) {
    If ($u -ne '') {
        sfdx force:config:set defaultusername=$u     
    } Else {
        Return ''
    }
}

Reload VS Code

Type

dxdefault yourOrgAlias

The default org is now set.

Once the default org is set, you can use the window icon in the status bar to open that org.

That’s enough for now. At least we have some simple aliases.