PowerShell w służbie Citrixa - czyli jak ułatwić sobie codzienną pracę

1. PowerShell w służbie Citrixa –
czyli jak ułatwić sobie
codzienną pracę
Jarosław Sobel
Polska Grupa Użytkowników
Citrix
Warszawa, 30.09.2016

2. Jarosław Sobel
• Projektant i administrator rozwiązań Citrix
• Blogger, prelegent i autor publikacji w prasie IT
• Praca z Citrixem od ponad 10 lat (od czasów Citrix Metaframe)
• Doświadczenie w pracy w dużych środowiskach
~4000 użytkowników, ~500 serwerów XA oraz kilkaset stacjiVDI
• Posiadacz certyfikacji w technologiach:
• Citrix – w tym CCE-V (Citrix Certified Expert –Virtualization)
• VMware –VCP-DCV 550
• Microsoft – ServerVirtualization withWindows Server Hyper-V and System Center, 70-410
• NetApp – NCDA, NCIE-SAN
Polska Grupa Użytkowników Citrix 22016-09-30

3. Agenda
• PowerShell & SDK
• Citrix
• XenApp 6.x
• XenApp/XenDesktop 7.x
• HDX & CDF Traces
• PVS
• StoreFront
• Serwer licencji
• XenServer
• Dokumentacja środowiska
• Integracja z innymi rozwiązaniami
• RRDtool
• Kiedy i czy warto?
• Linki
Polska Grupa Użytkowników Citrix 32016-09-30

4. Citrix SDKs
• Citrix SDK (Software Development Kit) – zestaw oprogramowania i
narzędzi umożliwiających tworzenie aplikacji współpracujących z
produktami firmy Citrix
• Obecnie Citrix dostarcza SDK dla większości swoich produktów:
• Nowe– w postaci CMDletów PowerShellowych
• „Stare” – zazwyczaj niespójny i trudny do powiązania z innymi rozwiązaniami
(PoSH, DLL, SOAP, itp.)
Polska Grupa Użytkowników Citrix 42016-09-30

5. PowerShell
• What is PowerShell?
• PowerShell (PoSH) is an automation platform and scripting language for
Windows and Windows Server that allows you to simplify the
of your systems. Unlike other text-based shells, PowerShell harnesses the
power of the .NET Framework, providing rich objects and a massive set of
built-in functionality for taking control of your Windows environments.
Polska Grupa Użytkowników Citrix 52016-09-30

6. XenApp 6.5 - instalacja
• Instalacja Citrix SDX for XA 6.5
• Dodanie Snap-Ina:
• Add-PSSnapin Citrix.*
• Wyświetlenie dodanych modułów:
• Get-PSSnapin Citrix.*
• Wyświetlenie cmdletów:
• Get-Command -module "Citrix.*"
• Uruchamianie - uprawienia
• Użytkownik administracyjny
• Użytkownik z innymi prawami
• Tryb wsadowy – konto SYSTEM na serwerze XA
Polska Grupa Użytkowników Citrix 62016-09-30

7. XenApp 6.5 - cmdlety
• Get-XAFarm
• Get-XAServer
• Get-XAServerLoad
• Get-XAApplication
• Get-XASession
• …
Polska Grupa Użytkowników Citrix 72016-09-30

8. XenApp 6.x – legacy MFCOM.dll
• Biblioteka z funkcjami
zarządzającymi środowiskiem
Citrix
• Jest ona udostępniania w postaci
DLL-ki i może być użyta w
większości języków na platformę
Windows, np.:VisualBasic,
C/C++, .NET (C#), ObjectPascalu
lub Asemblerze
• Przykładowa deklaracja w C#:
• using MetaFrameCOM;
Polska Grupa Użytkowników Citrix 82016-09-30

9. XenDesktop 7.x – instalacja
• Komponenty SDK zawarte są w instalatorze konsoli Studio
• Dodanie Snap-Ina:
• Add-PSSnapin Citrix.*
• Wyświetlenie cmdletów:
• Get-Command -module "Citrix.*”
• Uruchamianie - uprawienia
• Użytkownik administracyjny
• Użytkownik z innymi prawami
• Tryb wsadowy – konto serwisowe oraz użycie opcji „AdminAddress” w
poleceniu, np:
• Get-BrokerMachine -AdminAddress „ddc01.domena.local:80"
Polska Grupa Użytkowników Citrix 92016-09-30

10. XenDesktop 7.x – CMDlet
• Citrix.AdIdentity.Admin.V2
• Citrix.AppV.Admin.V1
• Citrix.Broker.Admin.V2
• Citrix.Configuration.Admin.V2
• Citrix.ConfigurationLogging.Admin.V1
• Citrix.DelegatedAdmin.Admin.V1
• Citrix.EnvTest.Admin.V1
• Citrix.Host.Admin.V2
• Citrix.MachineCreation.Admin.V2
• Citrix.Monitor.Admin.V1
• Citrix.Storefront.Admin.V1
• …
Polska Grupa Użytkowników Citrix 102016-09-30

11. XenDesktop 7.x – CMDlet
• Get-BrokerServiceStatus
• Get-ConfigServiceStatus
• Get-HypServiceStatus
• Get-AcctServiceStatus
• Get-ProvServiceStatus
Polska Grupa Użytkowników Citrix 112016-09-30
http://www.basvankaam.com/2015/03/26/12-services-that-make-up-the-citrix-xendesktop-flex-management-architecture/

12. XenDesktop 7.x - Studio
Polska Grupa Użytkowników Citrix 122016-09-30

13. XenDesktop 7.x – Tworzenie site’a
• Możliwość skonfigurowania całego site’a
przy pomocy PowerShella
• Przydatne dla integratorów i
wdrożeniowców
• New-XDDatabase
• New-XDSite
• Set-XDLicensing
• Set-ConfigSite
• Set-ConfigSiteMetadata
• …
Polska Grupa Użytkowników Citrix 132016-09-30

14. XenDesktop 7.x – Workspace cloud
• W związku z tym, że „Workspace Cloud Connector” oraz „zasoby”
znajdują się w różnych miejscach chmury istniejące SDK nie zadziała,
gdyż nie będzie możliwości rozwiązania nazwy podanej w
parametrze: AdminAddress
• Citrix udostępnił „Remote Powershell SDK”
• Zamiast polecenia: Get-BrokerMachine –AdminAddress <ddc address>
• Mamy zwykłe: Get-BrokerMachine
• Autentykacja
• Get-CWCAuthentication
• Po wprowadzeniu emaila i hasła sesja użytkownika będzie trwała 24 godziny
Polska Grupa Użytkowników Citrix 142016-09-30

15. XenDesktop 7.x - HypConn
Polska Grupa Użytkowników Citrix 152016-09-30
PS C:> Get-BrokerDesktop -MachineName "home.labVDI01" | select MachineName,
HostedMachineId, HypervisorConnectionUid
HostedMachineId : 874e03b5-2da3-4695-8153-d9cc8a30025d
HypervisorConnectionUid : 1
MachineName : home.labVDI01
PS C:> Get-VM "XD01" | select Name, ID
Name : XD01
ID : ce9873ea-777a-4acd-a510-bd0e159fcb8a
PS C:> Set-BrokerMachine -MachineName "home.labVDI01" -HostedMachineId
"ce9873ea-777a-4acd-a510-bd0e159fcb8a"

16. XenDesktop 5.x
• CMDlety w wersji 1:
• Citrix.Configuration.Admin.V1 – XenDesktop 5.x
• Citrix.Configuration.Admin.V2 – XenDesktop 7.x
• Doumentacja w KB: CTX127254
Polska Grupa Użytkowników Citrix 162016-09-30

17. XenDesktop 7.x - OData
• XA/XD 7.x zawiera usługę monitoringu, która przechowuje
zgromadzone dane w bazie. Do tych danych można się „dostać”
przy pomocy SQL Server Management Studio lub przy pomocy
Excela i protokołu OData.
• Open Data Protocol (OData) is an open protocol which allows the
creation and consumption of queryable and
interoperable RESTful APIs in a simple and standard way.
• Jest dostępny OData PowerShell Provider
Polska Grupa Użytkowników Citrix 172016-09-30

18. XenDesktop 7.x - OData
• http://{NameOFYourBroker}/Citrix/Monitor/OData/v2/Data
• …/OData/V1/Data dla wersji 7.5 oraz wczesniejszych
Polska Grupa Użytkowników Citrix 182016-09-30

19. XenDesktop 7.x - OData
Polska Grupa Użytkowników Citrix 192016-09-30

20. XenDesktop 7.x - OData
Polska Grupa Użytkowników Citrix 202016-09-30

21. HDX
PS c:> Get-WmiObject -Namespace rootCitrixhdx -Class
Citrix_VirtualChannel_Thinwire_Enum | select Component_Encoder, Component_Fps
Component_Encoder Component_Fps
----------------- -------------
DeepCompressionV2Encoder 9
DeepCompressionV2Encoder 9
Polska Grupa Użytkowników Citrix 212016-09-30

22. HDX
• Get-WmiObject -ComputerName {Host} -Namespace rootcitrixeuem -Class
Citrix_Euem_RoundTrip
Polska Grupa Użytkowników Citrix 222016-09-30

23. CDF Traces
• Get-Command –Module Citrix.Common.Commands
• Get-CtxTraceProvider
• Start-CtxTraceSession –TraceProviders $allProviders
• Start-CtxTraceSession [-TraceProviders] <CtxTraceProvider[]> [-WhatIf] [-Confirm] [[-
ServerName] <String[]>] [-CircularLogFile] [-MaxLogFileSize <Int32>] [-DataType
<TraceDataTypes[]>] [-Level <TraceDataLevels>] [-Force] [<CommonParameters>]
• Stop-CtxTraceSession
• Get-CtxTraceSession
Polska Grupa Użytkowników Citrix 232016-09-30

24. PVS
PVS 7.0 & 7.1 & 7.6
Polska Grupa Użytkowników Citrix 242016-09-30
PVS >=7.7

25. PVS <7.7
• Instalacja (biblioteka McliPSSnapIn.dll dostępna po instalacji konsoli PVSa):
• For 32-bit: %systemroot%Microsoft.NETFrameworkv2.0.50727installutil.exe
McliPSSnapIn.dll
• For 64-bit: %systemroot%Microsoft.NETFramework64v2.0.50727installutil.exe
McliPSSnapIn.dll
• Dodanie SnapIna
• Add-PSSnapin –Name McliPSSnapIn
• Nawiązanie połączenia z usługą SOAP serwera PVS:
• MCLI-Run setupconnection -p server=<PVSHOSTNAME>,port=<PVSPORT>
• Wszystkie CMDlety zaczynają się od Mcli-*
• Przykład: Dodanie vDisku do Store’a:
• MCLI-Add diskLocator -r
diskLocatorName=”VDISKNAME”,siteName=”SITENAME”,storename=”STORENAME”
• Wylistowanie urządzeń (Target Device’ów) z danej kolekcji:
• MCLI-Get Device -p collectionName=”COLLECTIONNAME”,siteName=”SITENAME” –f name –s
name
Polska Grupa Użytkowników Citrix 252016-09-30

26. PVS <7.7 - non-Object output
Polska Grupa Użytkowników Citrix 262016-09-30
Mcli-Get DiskLocator -f diskLocatorId, diskLocatorName,
siteId, siteName, storeId, storeName
• Jest to „sztuczne” obudowanie wywołania polecenia mcli.exe komendami
PowerShellowymi

27. PVS <7.7 - non-Object output
Polska Grupa Użytkowników Citrix 272016-09-30
RemkoWeijnen (CTP) przygotował skrypt
parsujący wynik polecenia Mcli-Get do
postaci obiektów PoSH
• Poniżej ponownie wykonanie polecenia:
Mcli-Get DiskLocator
• Ale wynik został przepuszczony przez funkcję
ToObject

28. PVS >=7.7
• Dokument:
• „Citrix Provisioning Services 7.7Transition to PowerShell with Objects from
PowerShell (Deprecated) Programmer’sGuide”
Polska Grupa Użytkowników Citrix 282016-09-30

29. PVS – inne zastosowania
Polska Grupa Użytkowników Citrix 292016-09-30
• Lista urządzeń i przypisani do konkretnych vDisków i wersji

30. PVS – inne zastosowania
Polska Grupa Użytkowników Citrix 302016-09-30
• Weryfikacja poprawnej synchronizacji vDisków pomiędzy serwerami
PVS

31. StoreFront
• Dodanie Snap-Ina:
• Add-PSSnapin Citrix.*
• Wyświetlenie cmdletów:
• Get-Command -module "Citrix.*"
Polska Grupa Użytkowników Citrix 312016-09-30

32. StoreFront – import/export subskrypcji
• Dokument KB: CTX139343
• Export-DSStoreSubscriptions –StoreName StoreName –
FilePath DataFile
• Import-DSStoreSubscriptions –StoreName StoreName –
FilePath FilePath
Polska Grupa Użytkowników Citrix 322016-09-30

33. Serwer licencji Citrixa
• Informacje o licencjach dostępne przezWMI
• $licensePool = gwmi -class "Citrix_GT_License_Pool"
-Namespace "ROOTCitrixLicensing"
• $usage = $licensePool | where-object {$_.PLD -like
"XDT_ENT_UD"} | select
Count,InUseCount,PooledAvailable,Overdraft
Polska Grupa Użytkowników Citrix 332016-09-30

34. XenServer
• PS> Import-Module XenServerPSModule
• PS> Get-Help about_XenServer
• PS> Connect-XenServer -url https://<servername>
• PS> Get-XenVM
• PS> Get-Help Invoke-XenVM
• PS> Disconnect-XenServer
Polska Grupa Użytkowników Citrix 342016-09-30

35. PoSH i nie tylko
Polska Grupa Użytkowników Citrix 352016-09-30

36. Dokumentacja środowiska
• Carl Webster
• Zestaw skryptów PoSH
służących do dokumentacji
środowiska Citrix (XA/XD/PVS)
oraz komponentów
dodatkowych
(DHCP/AD/Hypervisor)
Polska Grupa Użytkowników Citrix 362016-09-30

37. Integracja z innymi rozwiązaniami
• Citrix NetScaler
• Citrix ShareFile
• Hypervisory:
• Hyper-V
• VMware
• XenServer
• Active Directory, DNS, DHCP
• WMI
• …
Polska Grupa Użytkowników Citrix 372016-09-30

38. Inne zastosowania (około Citrixowe)
• Uptime serwerów (weryfikacja, czy restart się udał)
• Get-WmiObject Win32_OperatingSystem -ev myError -ea SilentlyContinue | select LastBootUpTime, LocalDateTime
• Wyszukiwanie plików – np.: dumpów systemowych
• Logi systemowe – weryfikacja i zgłaszanie eventów
• Get-EventLog
• Sesje
• Logon Server
• (Get-WmiObject -Class win32_ntdomain -Filter "DomainName = '{domain}'" -ComputerName $s).DomainControllerName
• Zdalny rejestr
• $w32reg = [Microsoft.Win32.RegistryKey]::OpenRemoteBaseKey('LocalMachine',$computer1)
• $keypath = 'SystemCurrentControlSetservicesNetlogonParameters'
• $ceds = $w32reg.OpenSubKey($keypath)
• Weryfikacja konfiguracji wzorcowej
• Weryfikacja stanu usług i ich ewentualny restart, np.:
• IMA, BrokerService
• Weryfikacja stanu aplikacji na serwerze
• $a = Invoke-Command -ComputerName $s -ScriptBlock {cscript "C:Program Files (x86)Microsoft
OfficeOffice15OSPP.VBS" /dstatus}
• $a | foreach {if($_ -like '*OOT_GRACE*') {write-host $_} }
• $a | foreach {if($_ -like '*LICENSED*') {write-host $_} }
Polska Grupa Użytkowników Citrix 382016-09-30

39. RRDtool
• RRDtool is the OpenSource industry standard, high performance
data logging and graphing system for time series data. RRDtool
be easily integrated in shell scripts, perl, python, ruby, lua or tcl
applications.
• RRDtool – Time-Series DataBase
Polska Grupa Użytkowników Citrix 392016-09-30

40. RRDtool- statystyki serwera licencji
• Co jest potrzebne:
• PowerShell i CMD, task scheduler
• Dane zWMI nt. licencji
• binaria RRDtool
Polska Grupa Użytkowników Citrix 402016-09-30

41. RRDtool- statystyki serwera licencji
• Kroki:
• Utworzenie bazy RRD
c:CTXRRDtoolrrdtool.exe create CtxLicUsage.rrd
--start now-10m --step 300
DS:total:GAUGE:450:0:U DS:used:GAUGE:450:0:U DS:avail:GAUGE:450:0:U DS:overdraft:GAUGE:450:0:U
RRA:AVERAGE:0.5:1:2880 RRA:AVERAGE:0.5:3:2880 RRA:AVERAGE:0.5:9:2880 RRA:AVERAGE:0.5:54:2880
• Co określony odstęp czasu zapisanie danych w bazie
$licensePool = gwmi -class "Citrix_GT_License_Pool" -Namespace "ROOTCitrixLicensing"
$usage = $licensePool | where-object {$_.PLD -like "XDT_ENT_UD"} | select
Count,InUseCount,PooledAvailable,Overdraft
# Write-Host $usage.Count $usage.InUseCount $usage.PooledAvailable
$unixtime = [int][double]::Parse($(Get-date -date (Get-Date).ToUniversalTime()-uformat %s))
$cmd = "C:CTXRRDtoolrrdtool.exe update CtxLicUsage.rrd
$($unixtime):$($usage.Count):$($usage.InUseCount):$($usage.PooledAvailable):$($usage.Overdraft)"
iex $cmd
• rrdtool.exe update CtxLicUsage.rrd 1429608601:660:537:123:60
• Wygenerowanie ładnego wykresu ;-)
Polska Grupa Użytkowników Citrix 412016-09-30

42. RRDtool – inne zastosowania
Polska Grupa Użytkowników Citrix 422016-09-30

43. RRDtool – inne zastosowania
Polska Grupa Użytkowników Citrix 432016-09-30

44. Kiedy i czy warto?
• Jeśli mamy duże środowisko
• Jeśli często wykonujemy te same zadania administracyjne
• Jeśli chcemy coś zautomatyzować
• Kiedy nie da się czegoś wykonać z GUI
• Wykonujemy polecenia zdalnie
• Enter-PSSession [-ComputerName] <String>
• Przełącznik „zdalnego serwera” w CMDlet, np.: -AdminAccess
• Jeśli chcemy przygotować statystyki, raporty, informacje zbiorcze
• Jeśli chcemy zintegrować produkty Citrixa z innymi rozwiązaniami
• Jeśli chcemy dokładniej poznać konkretne rozwiązanie
Polska Grupa Użytkowników Citrix 442016-09-30

45. Linki
• Wszystkie linki i materiały są dostępne na stronie:
http://xenthusiast.com/4plcug_conference_materials/
• A skrypty pojawią już niedługo na GitHubie
Polska Grupa Użytkowników Citrix 452016-09-30

46. Polska Grupa Użytkowników Citrix 462016-09-30
Q&A

47. Dziękuję za uwagę
Polska Grupa Użytkowników Citrix 472016-09-30
Jarosław Sobel
email: jarek.sobel@gmail.com
www: xenthusiast.com
twitter: @JarekSobel