{"id":75070,"date":"2023-06-05T13:11:19","date_gmt":"2023-06-05T17:11:19","guid":{"rendered":"https:\/\/jumpcloud.com\/?post_type=support&p=75070"},"modified":"2023-06-05T13:11:19","modified_gmt":"2023-06-05T17:11:19","slug":"install-the-jumpcloud-powershell-module","status":"publish","type":"support","link":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module","title":{"rendered":"Install the JumpCloud PowerShell Module"},"content":{"rendered":"\n

PowerShell is a task automation and configuration management framework from Microsoft, consisting of a command-line shell and associated scripting language. The JumpCloud PowerShell Module<\/a> is a set of PowerShell commands that allow JumpCloud administrators to interact with their JumpCloud directory.<\/p>\n\n\n\n

Installing the JumpCloud PowerShell module can be done by running a single command.<\/p>\n\n\n\n

<\/p><\/div>

Tip:<\/strong> \n

On Mac or Linux and need to install PowerShell? See Installing PowerShell on Mac and Linux<\/a> below.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n

Installing the PowerShell Module<\/h2>\n\n\n\n

From a Windows PowerShell window launched as administrator, or a terminal window on Mac and Linux where you have launched in PowerShell by running the command pwsh<\/code>, enter the command:<\/p>\n\n\n\n

\n

Install-Module JumpCloud -Scope CurrentUser <\/p>\n<\/div><\/div>\n\n\n\n

When prompted, press Y<\/strong> to install the JumpCloud PowerShell module:<\/p>\n\n\n\n

\n

Untrusted repository You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from ‘PSGallery’? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is “N”):<\/p>\n<\/div><\/div>\n\n\n\n

Authenticating the PowerShell Module<\/h2>\n\n\n\n

After the JumpCloud module is installed, you will authenticate the module to the JumpCloud API using a JumpCloud API key and the function Connect-JCOnline<\/a>.<\/p>\n\n\n\n

Locate your JumpCloud API key within the JumpCloud Admin Portal. Need help finding your JumpCloud API key? See JumpCloud APIs<\/a>.<\/p>\n\n\n\n

After locating your JumpCloud API key, enter the command Connect-JCOnline<\/code> and enter your API key when prompted. Example:<\/p>\n\n\n\n

\n

\/Users\/buster>
Connect-JCOnline cmdlet Connect-JCOnline at command pipeline position 1 Supply values for the following parameters: (Type !? for Help.) 
JumpCloudAPIKey:<\/p>\n<\/div><\/div>\n\n\n\n

<\/p><\/div>

Tip:<\/strong> \n

On Mac or Linux? Once PowerShell is installed, remember you must enter the pwsh<\/code> <\/em>command within the terminal application to open PowerShell.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n

A success message will indicate that you have successfully connected to the module. If there is an update available for the module, you will be asked if you would like to update.<\/p>\n\n\n\n

Using PowerShell<\/h2>\n\n\n\n

Find a matrix of copy-and-pastable real work PowerShell examples that have been crowd sourced from JumpCloud customers within the JumpCloud PowerShell Commands Example Library<\/a>.<\/p>\n\n\n\n

To see all of the available commands within the JumpCloud Module, run:<\/p>\n\n\n\n

\n

Get-Command -Module JumpCloud<\/p>\n<\/div><\/div>\n\n\n\n

Accessing Built-In Help<\/strong><\/h3>\n\n\n\n

PowerShell has a built-in help system. To use this system, type Help [enter command here] -Full<\/code> to see the full help inside the terminal. For example:<\/p>\n\n\n\n

\n

Help Get-JCUser -Full<\/p>\n<\/div><\/div>\n\n\n\n

Or, run Help [enter command here] -Online<\/code> to see the help in a web browser:<\/p>\n\n\n\n

\n

Help Get-JCUser -Online<\/p>\n<\/div><\/div>\n\n\n\n

If you get stuck inside the internal help, press Q to exit.<\/p>\n\n\n\n

Installing PowerShell on Mac and Linux<\/h2>\n\n\n\n

If you are on Mac or Linux, follow this link<\/a> to locate the PowerShell package for your operating system.<\/p>\n\n\n\n

Download the installation media by clicking on the hyperlink next to your operating system under the Downloads (stable) <\/strong>column of the linked table.<\/p>\n\n\n\n

Install the PowerShell application on your target system using the downloaded installation media.<\/p>\n\n\n\n

<\/p><\/div>

Tip:<\/strong> \n

Need more help? Navigate to the How to Install<\/strong> Instructions link for your operating system in the linked table.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n

Once PowerShell is installed, PowerShell can be accessed within the terminal application on Mac or Linux system by typing pwsh<\/code>.<\/p>\n\n\n\n

\n

MBP-d3v:~ scottd3v$ pwsh
PowerShell v7.0.0
Copyright (c) Microsoft Corporation. All rights reserved.

https:\/\/aka.ms\/pscore6-docs
Type ‘help’ to get help.

PS \/Users\/scottd3v><\/p>\n<\/div><\/div>\n\n\n\n

You will be able to tell you are running PowerShell because the root of your terminal command line will switch to PS<\/code> as seen above.<\/p>\n\n\n\n

    \n
  • Before calling PowerShell using the pwsh<\/code> command: MBP-d3v:~ scottd3v$<\/code><\/li>\n\n\n\n
  • After: PS \/Users\/scottd3v<\/code><\/li>\n<\/ul>\n\n\n\n

    Uninstalling the PowerShell Module<\/h2>\n\n\n\n

    When the command “Install-module” is used to install a module from the PowerShell gallery, the contents of the module are saved locally to the system.<\/p>\n\n\n\n

    To uninstall a module and ensure a clean full uninstallation, remove the module files from the system.<\/p>\n\n\n\n

    The command “Get-InstaledModule” and the property “InstalledLocation” can be used to query the location of the module files on a system. See the below examples:<\/p>\n\n\n\n

    Mac<\/h3>\n\n\n\n
    \n

    Get-InstalledModule JumpCloud | Select-Object InstalledLocation<\/p>\n<\/div><\/div>\n\n\n\n

    \n

    InstalledLocation
    —————–
    \/Users\/buster\/.local\/share\/powershell\/Modules\/JumpCloud\/1.12.0<\/p>\n<\/div><\/div>\n\n\n\n

    Windows<\/h3>\n\n\n\n
    \n

    Get-InstalledModule JumpCloud | Select-Object InstalledLocation<\/p>\n<\/div><\/div>\n\n\n\n

    \n

    InstalledLocation
    —————–
    C:\\Users\\buster\\Documents\\WindowsPowerShell\\Modules\\JumpCloud\\1.11.0<\/p>\n<\/div><\/div>\n\n\n\n

    Removing the folder “JumpCloud” and its contents from the system will uninstall the module and allow for a clean reinstallation using the “Install-Module” command.<\/p>\n\n\n\n

    Troubleshooting<\/h2>\n\n\n\n

    In order to install the JumpCloud PowerShell Module from the PowerShell gallery on Windows, you must be running Windows PowerShell version 5.0 or newer and have your Execution Policy set to at least RemoteSigned.<\/p>\n\n\n\n

    The PowerShell command $PSVersionTable<\/code> will show what version of PowerShell is installed on a local machine. PSVersion<\/code> will reveal the version number when using this command:<\/p>\n\n\n\n

    \n

    $PSVersionTable
    Name Value 
    —- —– 
    PSVersion 5.1.16299.64 
    PSEdition Desktop 
    PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…} 
    BuildVersion 10.0.16299.64 
    CLRVersion 4.0.30319.42000
    WSManStackVersion 3.0 
    PSRemotingProtocolVersion 2.3 
    SerializationVersion 1.1.0.1<\/p>\n<\/div><\/div>\n\n\n\n

    On Windows machines, the Execution Policy must be set to at least RemoteSigned in order to load the module. The module will install if the Execution Policy is set to Unrestricted or ByPass as well. To see the Execution Policy, run the command Get-ExecutionPolicy<\/code>. To set the Execution Policy, run the following command in a Windows PowerShell session launched with Administrator permissions:<\/p>\n\n\n\n

    \n

    Set-ExecutionPolicy RemoteSigned<\/p>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"

    PowerShell is a task automation and configuration management framework from Microsoft, consisting of a command-line shell and associated scripting language. […]<\/p>\n","protected":false},"author":203,"featured_media":0,"template":"","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","inline_featured_image":false,"footnotes":""},"support_category":[2856,2916],"support_tag":[],"coauthors":[2837],"acf":[],"yoast_head":"\nInstall the JumpCloud PowerShell Module - JumpCloud<\/title>\n<meta name=\"description\" content=\"Learn how to install, authenticate, use, uninstall, and troubleshoot the JumpCloud PowerShell Module, including installation on Linux or Mac.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Install the JumpCloud PowerShell Module\" \/>\n<meta property=\"og:description\" content=\"Learn how to install, authenticate, use, uninstall, and troubleshoot the JumpCloud PowerShell Module, including installation on Linux or Mac.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module\" \/>\n<meta property=\"og:site_name\" content=\"JumpCloud\" \/>\n<meta property=\"og:image\" content=\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-JumpCloudHelpCenter-SiteDisplay-min-2.png\" \/>\n\t<meta property=\"og:image:width\" content=\"890\" \/>\n\t<meta property=\"og:image:height\" content=\"525\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"derekpietras\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module\",\"url\":\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module\",\"name\":\"Install the JumpCloud PowerShell Module - JumpCloud\",\"isPartOf\":{\"@id\":\"https:\/\/jumpcloud.com\/#website\"},\"datePublished\":\"2023-06-05T17:11:19+00:00\",\"dateModified\":\"2023-06-05T17:11:19+00:00\",\"description\":\"Learn how to install, authenticate, use, uninstall, and troubleshoot the JumpCloud PowerShell Module, including installation on Linux or Mac.\",\"breadcrumb\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/jumpcloud.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\/\/jumpcloud.com\/support\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Install the JumpCloud PowerShell Module\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jumpcloud.com\/#website\",\"url\":\"https:\/\/jumpcloud.com\/\",\"name\":\"JumpCloud\",\"description\":\"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.\",\"publisher\":{\"@id\":\"https:\/\/jumpcloud.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/jumpcloud.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/jumpcloud.com\/#organization\",\"name\":\"JumpCloud\",\"url\":\"https:\/\/jumpcloud.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"contentUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"width\":598,\"height\":101,\"caption\":\"JumpCloud\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Install the JumpCloud PowerShell Module - JumpCloud","description":"Learn how to install, authenticate, use, uninstall, and troubleshoot the JumpCloud PowerShell Module, including installation on Linux or Mac.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module","og_locale":"en_US","og_type":"article","og_title":"Install the JumpCloud PowerShell Module","og_description":"Learn how to install, authenticate, use, uninstall, and troubleshoot the JumpCloud PowerShell Module, including installation on Linux or Mac.","og_url":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module","og_site_name":"JumpCloud","og_image":[{"width":890,"height":525,"url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-JumpCloudHelpCenter-SiteDisplay-min-2.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes","Written by":"derekpietras"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module","url":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module","name":"Install the JumpCloud PowerShell Module - JumpCloud","isPartOf":{"@id":"https:\/\/jumpcloud.com\/#website"},"datePublished":"2023-06-05T17:11:19+00:00","dateModified":"2023-06-05T17:11:19+00:00","description":"Learn how to install, authenticate, use, uninstall, and troubleshoot the JumpCloud PowerShell Module, including installation on Linux or Mac.","breadcrumb":{"@id":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/jumpcloud.com\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/jumpcloud.com\/support"},{"@type":"ListItem","position":3,"name":"Install the JumpCloud PowerShell Module"}]},{"@type":"WebSite","@id":"https:\/\/jumpcloud.com\/#website","url":"https:\/\/jumpcloud.com\/","name":"JumpCloud","description":"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.","publisher":{"@id":"https:\/\/jumpcloud.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jumpcloud.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/jumpcloud.com\/#organization","name":"JumpCloud","url":"https:\/\/jumpcloud.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/","url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","contentUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","width":598,"height":101,"caption":"JumpCloud"},"image":{"@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75070"}],"collection":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support"}],"about":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/types\/support"}],"author":[{"embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/users\/203"}],"version-history":[{"count":3,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75070\/revisions"}],"predecessor-version":[{"id":85079,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75070\/revisions\/85079"}],"wp:attachment":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/media?parent=75070"}],"wp:term":[{"taxonomy":"support_category","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_category?post=75070"},{"taxonomy":"support_tag","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_tag?post=75070"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/coauthors?post=75070"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}