{"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 探花大神 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 探花大神 PowerShell Module<\/a> is a set of PowerShell commands that allow 探花大神 administrators to interact with their 探花大神 directory.<\/p>\n\n\n\n

Installing the 探花大神 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 探花大神 -Scope CurrentUser <\/p>\n<\/div><\/div>\n\n\n\n

When prompted, press Y<\/strong> to install the 探花大神 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 探花大神 module is installed, you will authenticate the module to the 探花大神 API using a 探花大神 API key and the function Connect-JCOnline<\/a>.<\/p>\n\n\n\n

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

After locating your 探花大神 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.) 
探花大神APIKey:<\/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 探花大神 customers within the 探花大神 PowerShell Commands Example Library<\/a>.<\/p>\n\n\n\n

To see all of the available commands within the 探花大神 Module, run:<\/p>\n\n\n\n

\n

Get-Command -Module 探花大神<\/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 探花大神 | Select-Object InstalledLocation<\/p>\n<\/div><\/div>\n\n\n\n

    \n

    InstalledLocation
    —————–
    \/Users\/buster\/.local\/share\/powershell\/Modules\/探花大神\/1.12.0<\/p>\n<\/div><\/div>\n\n\n\n

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

    Get-InstalledModule 探花大神 | Select-Object InstalledLocation<\/p>\n<\/div><\/div>\n\n\n\n

    \n

    InstalledLocation
    —————–
    C:\\Users\\buster\\Documents\\WindowsPowerShell\\Modules\\探花大神\\1.11.0<\/p>\n<\/div><\/div>\n\n\n\n

    Removing the folder “探花大神” 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 探花大神 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 探花大神 PowerShell Module - 探花大神<\/title>\n<meta name=\"description\" content=\"Learn how to install, authenticate, use, uninstall, and troubleshoot the 探花大神 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 探花大神 PowerShell Module\" \/>\n<meta property=\"og:description\" content=\"Browse the 探花大神 Help Center by category, search for a specific topic, or check out our featured articles.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module\" \/>\n<meta property=\"og:site_name\" content=\"探花大神\" \/>\n<meta property=\"og:image\" content=\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-探花大神HelpCenter-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 探花大神 PowerShell Module - 探花大神\",\"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 探花大神 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 探花大神 PowerShell Module\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jumpcloud.com\/#website\",\"url\":\"https:\/\/jumpcloud.com\/\",\"name\":\"探花大神\",\"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\":\"探花大神\",\"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\":\"探花大神\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Install the 探花大神 PowerShell Module - 探花大神","description":"Learn how to install, authenticate, use, uninstall, and troubleshoot the 探花大神 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 探花大神 PowerShell Module","og_description":"Browse the 探花大神 Help Center by category, search for a specific topic, or check out our featured articles.","og_url":"https:\/\/jumpcloud.com\/support\/install-the-jumpcloud-powershell-module","og_site_name":"探花大神","og_image":[{"width":890,"height":525,"url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-探花大神HelpCenter-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 探花大神 PowerShell Module - 探花大神","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 探花大神 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 探花大神 PowerShell Module"}]},{"@type":"WebSite","@id":"https:\/\/jumpcloud.com\/#website","url":"https:\/\/jumpcloud.com\/","name":"探花大神","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":"探花大神","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":"探花大神"},"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}]}}