ThinScale Management PowerShell Module brugervejledning

Produktnavn: Thin Scale Management Power Shell-modul
Version: 7.5
Minimum Power Shell Version: 7.0
Installationssti: C: Program Files PowerS helvede 7 moduler Thin Scale Management

Produktbrugsvejledning

Forudsætninger

Modulet fungerer kun på en maskine, hvor ThinScale Management Console også er installeret, da det afhænger af nogle af de installerede files.
Modulet kræver minimum version 7.0 af PowerShell.

Installation

Modulet kan installeres ved hjælp af ikonet 'Installer modul' fra Thin Scale Management Console.
Note: Power Shell 7.2 eller nyere er påkrævet.
Dette vil tillade dig at installere modulet for kun den aktuelle bruger eller alle brugere på maskinen (kræver administrative rettigheder).

Installationssti: C: Program FilesPower Shell 7 moduler Thin Scale Management

Tilladelser

Modulet er digitalt signeret, så det kan køres, når PowerShell-udførelsespolitikken er indstillet til AllSigned.

Ofte stillede spørgsmål

Q: Hvilke versioner af PowerShell er kompatible med ThinScale Management PowerShell-modulet?

A: Modulet kræver minimum version 7.0 af PowerShell.

Sp: Hvordan kan jeg installere ThinScale Management PowerShell-modulet?

A: Du kan installere modulet ved hjælp af ikonet 'Installer modul' fra ThinScale Management Console.

Indledning

ThinScale Management PowerShell-modulet gør det muligt at skrive PowerShell-scripts, som kan kalde funktioner, der findes i ThinScale Management Console.
Dette gør det muligt at automatisere visse handlinger i stedet for, at de skal udføres manuelt fra selve konsollen.

Sådan fungerer denne guide

ThinScale installations- og administrationsvejledninger er designet til at hjælpe med installation og konfiguration af ThinScale-løsninger i dit miljø ved at give et let at følge, omfattende, trin-for-trin sæt illustrerede instruktioner.
Igennem denne guide vil du se forskellige typer tekst som f.eks URLs, kommandolinjeindtastninger og tekst på skærmen alle repræsenteret ved hjælp af forskellige stilarter og formatering for at skelne mellem teksttyperne.

Følgende tabel viser examples af disse forskellige stilarter:

Tekst på skærmen Angiver tekst vist på skærmen, såsom menuer, indstillinger, klikknapper og anden tekstinformation
Ekstern URL Angiver et link til en ekstern side/webwebsted
Indre URL Angiver et link til en intern web side såsom en konsol

Kommandolinje Angiver noget, du skal indtaste, såsom kommandolinjeinstruktioner, scripts, brugernavne og adgangskoder
Kommandoer Angiver et kommandonavn eller en variabel
Sektionsreference Angiver en henvisning til et andet afsnit i dokumentet, såsom en anden side eller overskrift

server\mappe Angiver en sti til en mappe eller en delt mappe

Revisionshistorik for dokument

Den aktuelle version af dette dokument plus versionshistorikdetaljerne for, hvad der er ændret.

Revision/version	Dato	Forfatter(e)	Beskrivelse
V3.1.0	januar 2019	David Coombes	Første udgivelse
V5.0	januar 2020	David Coombes	Anden udgivelse
V.5.2	juli 2020	David Coombes	Tredje udgivelse
V.5.4	marts 2021	David Coombes	Fjerde udgivelse
V 7.0	april 2021	David Coombes	Femte udgivelse
V7.1	oktober 2021	David Coombes	Sjette udgivelse
V7.2	november 2021	Niall AL Rubeai	Syvende udgivelse
V7.3	juli 2022	Niall AL Rubeai	Ottende udgivelse
V7.4	november 2022	David Coombes	Niende udgivelse
V7.5	juli 2023	David Coombes	Tiende udgivelse

Funktioner

Funktionerne tilgængelige i denne version af modulet er som følger:

Tilføj-TSTMGMTFolderPackageAssignment
Tilføj-TSTMGMTFolderProfileOpgave
Tilføj-TSTMGMTProfileRevision
Connect-TSTMGMTServer
Afbryd-TSTMGMTServer
Eksport-TSTMGMTProfile
Hent-TSTMGMTAAllData
Hent-TSTMGMTA adgangsnøgle
Hent-TSTMGMTA adgangsnøgler
Få-TSTMGMTAPresultater
Hent-TSTMGMTDenhed
Hent-TSTMGMTDenheder
Hent-TSTMGMTDeviceInventory
Hent-TSTMGMTFolder
Hent-TSTMGMTFoldere
Hent-TSTMGMTLicenseData
Få-TSTMGMTLicenseUsage
Hent-TSTMGMTProfile
Hent-TSTMGMTProfileObjekt
Hent-TSTMGMTProfileRevisioner
Hent-TSTMGMTProfiles
Hent-TSTMGMTRefreshData
Få-TSTMGMTRole
Hent-TSTMGMTRoles
Hent-TSTMGMTSite
Hent-TSTMGMTSites
Hent-TSTMGMTUser
Få-TSTMGMTU-brugere
Få-TSTMGMTLogsAudit
Hent-TSTMGMTLogsEvent
Få-TSTMGMTLogsMonitoring
Import-TSTMGMTProfileObjekt
Invoke-TSTMGMTAdminAction
Flyt-TSTMGMTO-objekt
Flyt-TSTMGMTOobjekter
Ny-TSTMGMTAddAce
Ny- TSTMGMTAccessKey
Ny-TSTMGMTDenhed
Ny-TSTMGMTFolder
Ny-TSTMGMTProfile
Ny-TSTMGMTProfileObjekt
Ny-TSTMGMTRole
Ny-TSTMGMTSite
Ny-TSTMGMTU-bruger
Fjern-TSTMGMTFolderPackageAssignment.
Fjern-TSTMGMTFolderProfileOpgave Fjern-TSTMGMTObject
Omdøb-TSTMGMTObject
Nulstil-TSTMGMTDeviceLocationData
Indstil-TSTMGMTA adgangsnøgle
Indstil-TSTMGMTDeviceNotes
Sæt-TSTMGMTFolder
Indstil-TSTMGMTObjectSecurity
Indstil-TSTMGMTRole
Indstil-TSTMGMTSite
Indstil-TSTMGMTUser
Test-TSTMGMTObjectExists
Hent-TSTMGMTUserAssignment
Hent-TSTMGMTUserAssignments
Ny-TSTMGMTUserAssignment
Set-TSTMGMTUserAssignment

Forudsætninger

Modulet fungerer kun på en maskine, hvor ThinScale Management Console også er installeret, da det afhænger af nogle af de installerede files.

Modulet kræver minimum version 7.0 af PowerShell.

Installation

Modulet kan installeres ved hjælp af ikonet 'Installer modul' fra ThinScale Management Console.

Note: Powershell 7. 2 eller højere er påkrævet
Dette giver dig mulighed for at installere modulet for kun den aktuelle bruger eller alle brugere på maskinen (kræver administrative rettigheder)
C:\Tidsplan Files\PowerShell\7\Modules\ThinScaleManagement

Tilladelser

Modulet er digitalt signeret, så det kan køres, når PowerShell-udførelsespolitikken er indstillet til AllSigned.

Dokumentation

Modulet indeholder PowerShell-kompatibel hjælp til alle funktioner.

Dette kan tilgås på to måder:

Brug af PowerShells Get-Help cmdlet
Tryk på F1-tasten med markøren i en ThinScale Management-funktion, når du bruger PowerShell ISE

Brug

Når modulet er installeret, indlæses det ved at køre følgende kommando:
Import-modul ThinScaleManagement
Der skal derefter oprettes en forbindelse til en ThinScale Management-server, som returnerer et objekt, som skal sendes til alle yderligere ThinScale-funktioner og skal lagres i en variabel:
Connect-TSTMGMTServer -URI "https://d7.thinscale.com" -brugernavn bob@thinscale.com" -adgangskode "adgangskode"

Et alternativ til at videregive URI, brugernavn og adgangskode er at indstille nogle eller alle af dem i miljøvariablerne THINSCALE_URI, THINSCALE_USERNAME og
THINSCALE_PASSWORD hhv.
De(n) påkrævede funktion(er) kan derefter kaldes omgåelse af grænsefladevariablen og andre parametre i henhold til modulets selvstændige dokumentation.

F.eksampdet: $alldata = Get-TSTMGMTAllData
Når alle handlinger er afsluttet, skal sessionen afbrydes ved hjælp af følgende kommando:

Afbryd-TSTMGMTServer

Dette vil ugyldiggøre grænsefladevariablen, så hvis efterfølgende ThinScale-funktioner skal kaldes, skal Connect-TSTMGMTServer-funktionen kaldes igen og en ny grænsefladevariabel gemmes.

Parametre

Hvor eksisterende objekter, såsom enheder eller mapper, skal overføres som parametre til ThinScale-funktioner, er der to måder at opnå dette på:
Angiv det som en absolut strengsti såsom Devices\Production\Luxemburg\Device1234
Angiv den unikke GUID for varen, som kan fås via de data, der returneres fra funktionen Get-TSTMGMTAllData eller et kald til New-TSTMGMTFolder eller New-TSTMGMTDevice
Alle funktioner, der kræver, at eksisterende objekter angives, kræver, at der bruges forskellige parametre, afhængigt af om der sendes en streng eller GUID for at identificere det pågældende objekt.
F.eksample: New-TSTMgmtFolder –Mappenavn '\Devices\Production'
Ny-TSTMgmt-mappe -Mappenavn 'UAT' -ParentId 'A7955CE0-8743-44CD-87A1-BD6418085912' -DeviceState Disabled -DeviceStateMessage 'Enheder i denne mappe er deaktiveret'
Hvor GUID'et sendes via -parentId er GUID'et for mappen \Devices\Production
WWW.THINSCALE.COM

Dokumenter/ressourcer

THINSCALE ThinScale Management PowerShell-modul [pdfBrugervejledning
ThinScale Management PowerShell-modul, Management PowerShell-modul, PowerShell-modul, modul

Referencer

Brugermanual

ThinScale Management PowerShell-modul

Produktinformation