SDKs und APIs
Citrix DaaS™ Remote PowerShell SDK
-
Das Remote PowerShell SDK automatisiert komplexe und repetitive Aufgaben. Es bietet den Mechanismus zum Einrichten und Verwalten der Citrix DaaS-Umgebung (ehemals Citrix Virtual Apps and Desktops™ Service), ohne Studio zu verwenden.
- Details zu den Cmdlets finden Sie im Citrix DaaS SDK.
- Die unterstützten Module sind unter Support und Einschränkungen aufgeführt. Dieser Abschnitt listet auch die Cmdlets auf, die in diesem SDK deaktiviert sind.
- Das Remote PowerShell SDK steht auf der Citrix Website zum Download bereit.
Dieses Produkt unterstützt PowerShell-Versionen 3 bis 7.3.
Hinweis:
Die Unterstützung für PowerShell-Version 7.4 befindet sich derzeit in der technischen Vorschau.
Unterschiede zwischen diesem SDK und dem SDK für kundenverwaltete Bereitstellungen
- In einer Citrix Virtual Apps and Desktops-Bereitstellung, die von Kundenadministratoren installiert und verwaltet wird, führen diese Administratoren Cmdlets und Skripte an einem Standort aus, der VDAs und Delivery Controller innerhalb einer gemeinsamen Domänenstruktur enthält. Im Gegensatz dazu teilt Citrix DaaS die VDAs und Controller in einen Ressourcenstandort bzw. die Steuerungsebene auf. Diese Aufteilung bedeutet, dass das ursprüngliche Citrix Virtual Apps and Desktops PowerShell SDK in einer Citrix DaaS-Umgebung nicht funktioniert. Es kann die sichere Grenze vom Ressourcenstandort zur Steuerungsebene nicht überschreiten.
Die Lösung ist das Citrix DaaS Remote PowerShell SDK. Wenn es am Ressourcenstandort ausgeführt wird, greift das Remote PowerShell SDK auf die Steuerungsebene zu, als wäre sie lokal. Dies bietet dieselbe Funktionalität wie ein einzelner Citrix Virtual Apps and Desktops-Standort. Es gibt nur die unterste, nicht sichtbare Kommunikationsebene, die so erweitert wurde, dass sie entweder in einem einzelnen lokalen Standort oder in der Cloud-Umgebung funktioniert. Die Cmdlets sind dieselben, und die meisten vorhandenen Skripte bleiben unverändert.
- Das Cmdlet
Get-XdAuthenticationstellt die Autorisierung bereit, um die sichere Grenze vom Ressourcenstandort zur Steuerungsebene zu überschreiten. Standardmäßig fordertGet-XdAuthenticationBenutzer zur Eingabe von CAS-Anmeldeinformationen auf und muss einmal pro PowerShell-Sitzung ausgeführt werden. Alternativ kann der Benutzer ein Authentifizierungsprofil mithilfe eines API-Zugriffs-Secure-Clients definieren, der in der Citrix Cloud™-Konsole erstellt wurde. In beiden Fällen bleiben die Sicherheitsinformationen für die Verwendung in nachfolgenden PowerShell SDK-Aufrufen erhalten. Wenn dieses Cmdlet nicht explizit ausgeführt wird, wird es vom ersten PowerShell SDK-Cmdlet aufgerufen.
Voraussetzungen
- Um das Citrix DaaS Remote PowerShell SDK zu verwenden, müssen Sie die folgenden URLs auf die Whitelist setzen:
Kommerziell
https://*.cloud.comhttps://*.citrixworkspacesapi.net/[customerid]https://[customerid].xendesktop.net:443
Japan
https://*.citrixcloud.jphttps://*.citrixworkspacesapi.jp/[customerid]https://[customerid].apps.citrixworkspacesapi.jp:443
Regierung
hhttps://*.cloud.ushttps://*.citrixworkspacesapi.us/[customerid]https://[customerid].xendesktop.us:443
Remote PowerShell SDK installieren und verwenden
-
Anforderungen und Überlegungen:
-
Hinweis:
-
Installieren Sie das Remote PowerShell SDK nicht auf einer Citrix Cloud Connector™-Maschine. Es kann auf jeder in die Domäne eingebundenen Maschine innerhalb desselben Ressourcenstandorts installiert werden.
Citrix® unterstützt das Ausführen der Cmdlets dieses SDKs auf Cloud Connectors nicht. Der Betrieb des SDKs beinhaltet die Cloud Connectors nicht.
-
Wenn Sie zusätzlich zu Citrix DaaS auch eine Citrix Virtual Apps and Desktops-Bereitstellung haben, installieren Sie das Remote PowerShell SDK nicht auf einem lokalen Delivery Controller. Da Citrix Studio (MMC-basiert) als Teil des Delivery Controllers installiert wird, können Sie das SDK auch nicht auf einem Server installieren, auf dem Citrix Studio ausgeführt wird.
- Installieren Sie Microsoft Edge WebView2.
- Stellen Sie sicher, dass PowerShell 3.0, 4.0, 5.0, 6.0 oder 7.0 auf der Maschine verfügbar ist.
- Der SDK-Installer lädt .NET Framework 4.8 herunter und installiert es, falls es (oder eine später unterstützte Version) noch nicht installiert ist.
- Wenn auf der Maschine bereits das Citrix Virtual Apps and Desktops SDK installiert ist, entfernen Sie dieses SDK (über Windows „Programme und Funktionen“), bevor Sie das Remote PowerShell SDK installieren.
- Verwenden Sie für eine automatisierte Umgebung den Parameter
-quiet, um das SDK ohne Benutzereingabe zu installieren.
So installieren Sie das Remote PowerShell SDK:
- Laden Sie das Virtual Apps and Desktops Remote PowerShell SDK von der Downloadseite herunter.
- Installieren und führen Sie das SDK aus.
Installationsprotokolle werden in %TEMP%\CitrixLogs\CitrixPoshSdk erstellt. Protokolle können bei der Behebung von Installationsproblemen helfen.
Führen Sie das SDK auf einem in die Domäne eingebundenen Computer innerhalb dieses Ressourcenstandorts aus:
- Öffnen Sie eine PowerShell-Eingabeaufforderung. Sie müssen sie nicht als Administrator ausführen.
- Wenn Sie das Snap-In (anstelle des Moduls) verwenden möchten, fügen Sie das Snap-In mit dem Cmdlet
Add-PSSnapin(oderasnp) hinzu. - Sie können sich explizit mit dem Cmdlet
Get-XdAuthenticationauthentifizieren. Alternativ können Sie Ihren ersten Remote PowerShell SDK-Befehl ausführen, der Sie zur gleichen Authentifizierung wieGet-XdAuthenticationauffordert. Wenn Sie einen Proxy verwenden, müssen Sie sich beim Proxy authentifizieren, um das CmdletGet-XdAuthenticationverwenden zu können. Weitere Informationen finden Sie unter Verwenden des Remote PowerShell SDK mit einem Proxy. - Um die Authentifizierungsaufforderung zu umgehen, können Sie das Cmdlet
Set-XdCredentialsverwenden, um ein Standardauthentifizierungsprofil zu erstellen, indem Sie einen in der Citrix Cloud-Konsole erstellten Secure Client verwenden. - Führen Sie weiterhin PowerShell SDK-Cmdlets oder PowerShell SDK-Automatisierungsskripte aus. Siehe ein Beispiel.
Um das Remote PowerShell SDK zu deinstallieren, wählen Sie unter Windows „Programme und Funktionen“ die Option Citrix Virtual Apps and Desktops Remote PowerShell SDK aus. Klicken Sie mit der rechten Maustaste und wählen Sie Deinstallieren. Folgen Sie den Anweisungen im Dialogfeld.
Remote PowerShell SDK mit einem Proxy verwenden
Wenn Sie einen Proxy verwenden, können Sie das Cmdlet Get-xdAuthentication möglicherweise nicht verwenden, da der Proxy die HTTP-Anfragen blockiert, die das Cmdlet stellt.
Es gibt zwei Möglichkeiten, sich beim Proxy zu authentifizieren. Sie können entweder den Parameter ProxyUseDefault oder die Parameter ProxyUsername und ProxyPassword verwenden:
-
Der Parameter
ProxyUseDefaultermöglicht die Authentifizierung am Proxy mithilfe der Standard-Proxy-Anmeldeinformationen. Zum Beispiel:Get-XdAuthentication -ProxyUseDefault <!--NeedCopy--> -
Die Parameter
ProxyUsernameundProxyPasswordermöglichen die Authentifizierung am Proxy innerhalb der PowerShell-Sitzung. Beispiel:```
-
$secureString = ConvertTo-SecureString -String “password” -AsPlainText -Force
-
Get-XdAuthentication -ProxyUsername user1 -ProxyPassword $secureString
-
```
-
Hinweis:
-
-
Sie erhalten einen Fehler, wenn Sie einen Befehl mit
XDHyp:\im Remote-PowerShell-SDK ausführen. So beheben Sie dieses Problem: -
- Führen Sie einen Befehl mit
Hypaus. Beispiel:Get-HypServiceStatus
- Führen Sie einen Befehl mit
-
- Führen Sie einen Befehl mit
XDHyp:\aus. Beispiel:Get-ChildItem XDHyp:\Connections\
- Führen Sie einen Befehl mit
-
Beispielaktivitäten
-
Gängige Aktivitäten umfassen das Einrichten von Maschinenkatalogen, Anwendungen und Benutzern. Ein Beispielskript wird unten gezeigt.
-
``` $users = “xd.local\Domain Users”
$TSVDACatalogName = “TSVDA”
$TSVDADGName = “TSVDA”
-
$TSVDAMachineName = “xd\ds-tsvda2”
-
#Create TSVDA Catalog
-
$brokerUsers = New-BrokerUser -Name $users
-
$catalog = New-BrokerCatalog -Name $TSVDACatalogName -AllocationType “Random” -Description $TSVDACatalogName -PersistUserChanges “OnLocal” -ProvisioningType “Manual” -SessionSupport “MultiSession” -MachinesArePhysical $true
-
#Add TSVDA Machine to Catalog
$BrokeredMachine = New-BrokerMachine -MachineName $TSVDAMachineName -CatalogUid $catalog.uid
-
#Create new desktops & applications delivery group
-
$dg = New-BrokerDesktopGroup -Name $TSVDADGName -PublishedName $TSVDADGName -DesktopKind “Shared” -SessionSupport “MultiSession” -DeliveryType DesktopsAndApps -Description $TSVDADGName
-
#Create notepad application
-
New-BrokerApplication -ApplicationType HostedOnDesktop -Name “Notepad” -CommandLineExecutable “notepad.exe” -DesktopGroup $dg
-
#Assign users to desktops and applications
New-BrokerEntitlementPolicyRule -Name $TSVDADGName -DesktopGroupUid $dg.Uid -IncludedUsers $brokerUsers -description $TSVDADGName
-
New-BrokerAccessPolicyRule -Name $TSVDADGName -IncludedUserFilterEnabled $true -IncludedUsers $brokerUsers -DesktopGroupUid $dg.Uid -AllowedProtocols @(“HDX”,”RDP”)
-
New-BrokerAppEntitlementPolicyRule -Name $TSVDADGName -DesktopGroupUid $dg.Uid -IncludedUsers $brokerUsers -description $TSVDADGName
-
#Add machine to delivery group
-
Add-BrokerMachine -MachineName $TSVDAMachineName -DesktopGroup $dg
-
```
-
Unterstützung und Einschränkungen
-
Die folgenden Betriebssysteme werden vom Remote-PowerShell-SDK unterstützt:
- Windows 11
- Windows 10
- Windows 10 IoT Enterprise LTSC x32 2019
- Windows 10 IoT Enterprise LTSC x64 2019
- Windows 10 IoT Enterprise 21h1 x64
- Windows Server 2022
- Windows Server 2019
-
Windows Server 2016
-
Die folgenden Citrix Virtual Apps and Desktops PowerShell-Module werden in dieser Version unterstützt:
- Broker
- Active Directory (AD)-Identität
- Maschinenerstellung
- Konfiguration
- Konfigurationsprotokollierung
- Host
- Delegierte Administration
-
Analytics
-
Details zu Cmdlets finden Sie unter Citrix Virtual Apps and Desktops SDK.
-
Nach der Authentifizierung bleibt der Remotezugriff in der aktuellen PowerShell-Sitzung 24 Stunden lang gültig. Danach müssen Sie Ihre Anmeldeinformationen erneut eingeben.
-
Das Remote-PowerShell-SDK muss auf einem Computer innerhalb des Ressourcenstandorts ausgeführt werden.
-
Die folgenden Cmdlets sind in Remote-Operationen deaktiviert, um die Integrität und Sicherheit der Citrix Cloud-Steuerungsebene zu gewährleisten.
-
Citrix.ADIdentity.Admin.V2:
- Copy-AcctIdentityPool
- Get-AcctDBConnection
- Get-AcctDBSchema
- Get-AcctDBVersionChangeScript
- Get-AcctInstalledDBVersion
- Remove-AcctServiceMetadata
- Reset-AcctServiceGroupMembership
- Set-AcctDBConnection
- Set-AcctServiceMetadata
- Set-AcctADAccountUserCert
-
Test-AcctDBConnection
-
Citrix.Analytics.Admin.V1:
- Get-AnalyticsDBConnection
- Get-AnalyticsDBSchema
- Get-AnalyticsDBVersionChangeScript
- Get-AnalyticsInstalledDBVersion
- Import-AnalyticsDataDefinition
- Remove-AnalyticsServiceMetadata
- Reset-AnalyticsServiceGroupMembership
- Set-AnalyticsDBConnection
- Set-AnalyticsServiceMetadata
- Set-AnalyticsSite
-
Set-AnalyticsDBConnection
-
Citrix.DelegatedAdmin.Admin.V1:
- Add-AdminRight
- Get-AdminDBConnection
- Get-AdminDBSchema
- Get-AdminDBVersionChangeScript
- Get-AdminInstalledDBVersion
- Import-AdminRoleConfiguration
- New-AdminAdministrator
- Remove-AdminAdministrator
- Remove-AdminAdministratorMetadata
- Remove-AdminRight
- Remove-AdminServiceMetadata
- Reset-AdminServiceGroupMembership
- Set-AdminAdministrator
- Set-AdminAdministratorMetadata
- Set-AdminDBConnection
- Set-AdminServiceMetadata
-
Test-AdminDBConnection
-
Citrix.Broker.Admin.V2:
- Get-BrokerDBConnection
- Get-BrokerDBSchema
- Get-BrokerDBVersionChangeScript
- Get-BrokerInstalledDBVersion
- Get-BrokerLease
- Get-BrokerController
- New-BrokerMachineConfiguration
- Remove-BrokerControllerMetadata
- Remove-BrokerLease
- Remove-BrokerLeaseMetadata
- Remove-BrokerMachineConfigurationMetadata
- Remove-BrokerMachineConfiguration
- Remove-BrokerSiteMetadata
- Remove-BrokerUserFromApplication
- Reset-BrokerLicensingConnection
- Reset-BrokerServiceGroupMembership
- Set-BrokerControllerMetadata
- Set-BrokerDBConnection
- Set-BrokerLeaseMetadata
- Set-BrokerMachineConfiguration
- Set-BrokerMachineConfigurationMetadata
- Set-BrokerSiteMetadata
- Test-BrokerDBConnection
- Test-BrokerLicenseServer
-
Update-BrokerBrokerLocalLeaseCache
-
Citrix.Configuration.Admin.V2:
- Export-ConfigFeatureTable
- Get-ConfigDBConnection
- Get-ConfigDBSchema
- Get-ConfigDBVersionChangeScript
- Get-ConfigInstalledDBVersion
- Get-ConfigServiceGroup
- Import-ConfigFeatureTable
- Register-ConfigServiceInstance
- Remove-ConfigRegisteredServiceInstanceMetadata
- Remove-ConfigServiceGroup
- Remove-ConfigServiceGroupMetadata
- Remove-ConfigServiceMetadata
- Remove-ConfigSiteMetadata
- Reset-ConfigServiceGroupMembership
- Set-ConfigDBConnection
- Set-ConfigRegisteredServiceInstance
- Set-ConfigRegisteredServiceInstanceMetadata
- Set-ConfigServiceGroupMetadata
- Set-ConfigServiceMetadata
- Set-ConfigSite
- Set-ConfigSiteMetadata
- Test-ConfigDBConnection
-
Unregister-ConfigRegisteredServiceInstance
-
Citrix.Host.Admin.V2:
- Get-HypDBConnection
- Get-HypDBSchema
- Get-HypDBVersionChangeScript
- Get-HypInstalledDBVersion
- Remove-HypServiceMetadata
- Reset-HypServiceGroupMembership
- Set-HypDBConnection
- Set-HypServiceMetadata
- Test-HypDBConnection
Citrix.ConfigurationLogging.Admin.V1:
- Get-LogDBConnection
- Get-LogDBSchema
- Get-LogDBVersionChangeScript
- Get-LogInstalledDBVersion
- Remove-LogOperation
- Remove-LogServiceMetadata
- Remove-LogSiteMetadata
- Reset-LogDataStore
- Reset-LogServiceGroupMembership
- Set-LogDBConnection
- Set-LogServiceMetadata
- Set-LogSite
- Set-LogSiteMetadata
- Test-LogDBConnection
Citrix.MachineCreation.Admin.V2:
- Get-ProvDBConnection
- Get-ProvDBSchema
- Get-ProvDBVersionChangeScript
- Get-ProvInstalledDBVersion
- Get-ProvServiceConfigurationData
- Remove-ProvServiceConfigurationData
- Remove-ProvServiceMetadata
- Reset-ProvServiceGroupMembership
- Set-ProvDBConnection
- Set-ProvServiceMetadata
- Test-ProvDBConnection
Citrix.EnvTest.Admin.V1:
- Get-EnvTestDBConnection
- Get-EnvTestDBSchema
- Get-EnvTestDBVersionChangeScript
- Get-EnvTestInstalledDBVersion
- Remove-EnvTestServiceMetadata
- Reset-EnvTestServiceGroupMembership
- Set-EnvTestDBConnection
- Set-EnvTestServiceMetadata
- Test-EnvTestDBConnection
Citrix.Monitor.Admin.V1:
- Get-MonitorConfiguration
- Get-MonitorDBConnection
- Get-MonitorDBSchema
- Get-MonitorDBVersionChangeScript
- Get-MonitorDataStore
- Get-MonitorDataStore
- Get-MonitorInstalledDBVersion
- Remove-MonitorServiceMetadata
- Reset-MonitorDataStore
- Reset-MonitorServiceGroupMembership
- Set-MonitorConfiguration
- Set-MonitorDBConnection
- Set-MonitorServiceMetadata
- Test-MonitorDBConnection
Citrix.Storefront.Admin.V1:
- Build-SfCluster
- Get-SfClusters
- Get-SfDBConnection
- Get-SfDBSchema
- Get-SfDBVersionChangeScript
- Get-SfInstalledDBVersion
Citrix DaaS Discovery-Modul für App-V-Pakete und -Server
Citrix DaaS kann Anwendungen, die in App-V-Paketen enthalten sind, über eine der folgenden Methoden an Ihre Endpunkte liefern:
- Verwaltungsmethode für einen einzelnen Administrator (Zugriff auf Pakete von einer Netzwerkfreigabe)
- Verwaltungsmethode für zwei Administratoren (Zugriff auf Pakete von einem Microsoft App-V Management Server)
Der Prozess der Registrierung von App-V-Paketen, Microsoft App-V Management- und Publishing-Servern bei der Anwendungsbibliothek mithilfe von Citrix DaaS unterscheidet sich geringfügig von der Registrierung von Paketen mithilfe einer lokalen Bereitstellung. Der Prozess der Zuweisung von Anwendungen an Benutzer und deren Start auf dem Endpunkt eines Benutzers ist jedoch identisch.
Die Citrix DaaS-Verwaltungskonsole in Citrix Cloud kann keine Dateien an einem Ressourcenstandort anzeigen. Außerdem kann sie App-V-Pakete oder Microsoft App-V-Server in Ihrer Infrastruktur nicht direkt erkennen. Das Discovery-Modul bietet Funktionen, die App-V-Paketinformationen in Ihrer lokalen Infrastruktur erkennen und die Paketinformationen in Ihr Citrix DaaS hochladen. Paketinformationen umfassen App-V-Pakete, Microsoft App-V-Server und die Anwendungen, die die Pakete enthalten.
Das Discovery-Modul verwendet das Virtual Apps and Desktops Remote PowerShell SDK. Es kann Paketinformationen entweder von einer Netzwerkfreigabe oder einem Microsoft App-V Management Server erkennen. Sie verwenden das Discovery-Modul auf einem Computer an Ihrem Ressourcenstandort.
Voraussetzungen für die Verwendung des Discovery-Moduls:
- Stellen Sie sicher, dass PowerShell 3.0 oder höher auf dem Computer verfügbar ist.
- Stellen Sie sicher, dass das Citrix Virtual Apps and Desktops Remote PowerShell SDK auf dem Computer installiert ist.
- Stellen Sie sicher, dass Sie Zugriff auf die Netzwerkfreigabe haben, die die App-V-Pakete enthält.
- Stellen Sie sicher, dass Sie Zugriff auf den Server haben, auf dem die Citrix Cloud Connectors installiert sind und der Microsoft App-V Management Server gehostet wird.
Hinzufügen von App-V-Paketen zur Anwendungsbibliothek in Citrix Cloud
Das folgende Verfahren gilt für das Hinzufügen von App-V-Paketen von Netzwerkfreigaben (Verwaltung durch einen einzelnen Administrator) und das Hinzufügen aller veröffentlichten App-V-Pakete vom Microsoft App-V Management Server (Verwaltung durch zwei Administratoren). Bei der Verwaltungsmethode für zwei Administratoren müssen Sie die hinzugefügten App-V-Pakete genauso verwalten wie bei der Verwaltungsmethode für einen einzelnen Administrator.
-
Laden Sie das Discovery-Modul von der Citrix DaaS-Downloadseite https://www.citrix.com/downloads/citrix-cloud/product-software/xenapp-and-xendesktop-service.html herunter. Extrahieren Sie die ZIP-Datei
Citrix.Cloud.AppLibrary.Admin.v1.psm1in einen geeigneten Ordner.Hinweis:
Diese Datei ist auch auf der Citrix Virtual Apps and Desktops ISO unter
Support\Tools\Scriptsverfügbar. Sie können sie lokal kopieren oder direkt vom CD-Laufwerk referenzieren. -
Stellen Sie sicher, dass das Virtual Apps and Desktops Remote PowerShell SDK auf Ihrem Computer installiert ist.
-
Navigieren Sie zu dem Ordner, der das Discovery-Modul enthält. Geben Sie im PowerShell-Fenster den vollständigen Pfad des Ordners ein, der das Discovery-Modul enthält, und drücken Sie dann die Eingabetaste.
-
Importieren Sie das Discovery-Modul mit dem Befehl
Import-Module.\Citrix.Cloud.AppLibrary.Admin.v1.psm1. -
Fügen Sie die App-V-Pakete mithilfe einer der folgenden Methoden zur Anwendungsbibliothek in Citrix Cloud hinzu.
-
Um App-V-Pakete von einer Netzwerkfreigabe hinzuzufügen, führen Sie das PowerShell-Cmdlet aus:
Import-AppVPackageToCloud.Beispiel:
Import-AppVPackageToCloud –PackagePath \\AppVSrv\share\Notepad++.appvFür Cmdlet-Hilfe geben Sie
Get-Help Import-AppVPackageToCloudein. -
Um App-V-Pakete von einem Microsoft App-V Management Server hinzuzufügen, führen Sie das PowerShell-Cmdlet aus:
Import-AppVPackagesFromManagementServerToCloudBeispiel:
Import-AppVPackagesFromManagementServerToCloud –ManagementSrvFQDN AppVMngSrv.domain.localFür Cmdlet-Hilfe geben Sie
Get-Help Import-AppVPackagesFromManagementServerToCloudein.Dieser Befehl importiert alle veröffentlichten App-V-Pakete vom Microsoft App-V Management Server in Citrix Cloud.
Nachdem Sie die App-V-Pakete zu Citrix Cloud hinzugefügt haben, müssen Sie diese wie bei der Verwaltungsmethode für einen einzelnen Administrator verwalten.
-
-
Melden Sie sich bei Citrix Cloud an. Wählen Sie den Zielkunden aus. Nachdem das Skript erfolgreich ausgeführt wurde, werden die App-V-Pakete zur Anwendungsbibliothek in Citrix Cloud hinzugefügt.
PowerShell-Funktionen auf hoher Ebene
Das Modul enthält die folgenden übergeordneten Funktionen, die Sie aus Ihrem eigenen PowerShell-Skript aufrufen können:
-
Import-AppVPackageToCloud -PackagePath <Vollständiger UNC-Pfad zum App-V-Paket>Erkennt und lädt alle Informationen, die zum Veröffentlichen von Anwendungen aus einem einzelnen App-V-Paket erforderlich sind, in Citrix DaaS hoch.
-
Import-AppVPackagesFromManagementServerToCloud -ManagementSrvFQDN <FQDN of a Microsoft App-V Management Server>Ermittelt die UNC-Pfade von Paketen, die vom Management Server veröffentlicht wurden, und ruft für jedes Paket nacheinander Import-AppVPackageToCloud auf.
Auf diese Weise ermittelte Pakete werden mit der Single-Admin-Verwaltungsmethode in Citrix DaaS geladen. Citrix DaaS kann Pakete nicht mit der Dual-Admin-Verwaltungsmethode bereitstellen.
-
Import-AppVDualAdminToCloud -ManagementSrvUrl <URL of a Microsoft App-V Management Server> -PublishingServerUrl <URL of a Microsoft App-V Publishing Server>Ermittelt Microsoft App-V Management- und Publishing-Server und importiert den Inhalt in die Anwendungsbibliothek. Dieses Cmdlet importiert alle Pakete, die mit dem Microsoft App-V Management Server verwaltet werden, sowie zugehörige Informationen. Server können über PowerShell hinzugefügt und entfernt werden.
Dieses Cmdlet fügt App-V-Pakete im Dual-Admin-Modus hinzu. Es werden nur App-V-Pakete importiert, die auf dem Microsoft App-V Management Server veröffentlicht sind und denen AD-Gruppen hinzugefügt wurden. Wenn Sie Änderungen am Microsoft App-V Management Server vornehmen, führen Sie dieses Cmdlet erneut aus, um die Anwendungsbibliothek mit dem Microsoft App-V Management Server zu synchronisieren.
-
Remove-AppVServerFromCloud -ManagementSrvUrl <URL of a Microsoft App-V Management Server> -PublishingServerUrl <URL of a Microsoft App-V Publishing Server>Entfernt die Microsoft App-V Management- und Publishing-Server, die der Anwendungsbibliothek hinzugefügt wurden.
Dieses Cmdlet entfernt die angegebenen Microsoft App-V Management- und Publishing-Server sowie alle zugehörigen App-V-Pakete.
Führen Sie das Erkennungsmodul für App-V-Pakete und -Server auf einem in die Domäne eingebundenen Computer innerhalb dieses Ressourcenstandorts aus. Befolgen Sie die Anweisungen unter Installieren und Verwenden des Remote PowerShell SDK, um zu beginnen. Führen Sie weiterhin PowerShell-Cmdlets oder -Skripte aus. Siehe die folgenden Beispiele.
Beispielaktivitäten
Importieren Sie das Citrix DaaS App-V-Paketerkennungsmodul.
import-module "D:\Support\Tools\Scripts\Citrix.Cloud.AppLibrary.Admin.v1.psm1"
<!--NeedCopy-->
Durchlaufen Sie das App-V-Paketspeicherverzeichnis und laden Sie jedes Paket hoch.
Get-ChildItem -Path "\\FileServer.domain.net\App-V Packages" -Filter *.appv |
Foreach-Object{
Import-AppVPackageToCloud -PackagePath $_.FullName
}
<!--NeedCopy-->
Ermitteln und laden Sie Pakete hoch, die bei einem Microsoft App-V Management Server registriert sind.
Import-AppVPackagesFromManagementServerToCloud -ManagementSrvFQDN AppVManagementServer.domain.net
<!--NeedCopy-->
Ermitteln Sie Microsoft App-V Management- und Publishing-Server und fügen Sie die Konfiguration der Anwendungsbibliothek hinzu. Dies importiert auch alle Pakete, die vom Microsoft App-V Management Server im Dual-Admin-Modus verwaltet werden.
Import-AppVDualAdminCloud -ManagementSrvUrl http://AppVManagementServer.domain.net –PublishingServerUrl http://AppVManagementServer.domain.net:8001
<!--NeedCopy-->
Lesen Sie die im Modul enthaltene PowerShell-Hilfedokumentation.
Get-Help Import-AppVPackageToCloud
<!--NeedCopy-->
Einschränkungen
- Sie können App-V-Pakete auf Ihrer Ressourcenstandortinfrastruktur nicht direkt über die Citrix DaaS-Verwaltungskonsole in Citrix Cloud ermitteln. Weitere Informationen zu Citrix Cloud finden Sie in der Citrix Cloud-Dokumentation.
- Die Citrix DaaS-Verwaltungskonsole in Citrix Cloud hat keine Live-Verbindung zum Microsoft App-V Management Server. Änderungen an Paketen und anderen Konfigurationen im Microsoft App-V Management Server werden erst in der Citrix DaaS-Verwaltungskonsole widergespiegelt, wenn
Import-AppVDualAdminClouderneut ausgeführt wird.
Monitor Service OData API
Zusätzlich zur Verwendung der Monitor-Funktionen zur Anzeige historischer Daten können Sie Daten über die API des Monitor Service abfragen. Verwenden Sie die API, um:
- Historische Trends für die Planung zu analysieren
- Detaillierte Fehlerbehebung bei Verbindungs- und Computerausfällen durchzuführen
- Informationen zur Einspeisung in andere Tools und Prozesse zu extrahieren; zum Beispiel die Verwendung von Microsoft Excels PowerPivot-Tabellen, um die Daten auf verschiedene Weisen anzuzeigen
- Eine benutzerdefinierte Benutzeroberfläche auf Basis der von der API bereitgestellten Daten zu erstellen
Details finden Sie unter Monitor Service OData API. Um auf die Monitor Service API zuzugreifen, siehe Access Monitor Service data using the OData v4 endpoint in Citrix Cloud.
Citrix DaaS APIs
Die Citrix DaaS APIs sind unter https://developer.cloud.com/citrixworkspace/citrix-daas verfügbar.
Haftungsausschluss
Diese Software / dieser Beispielcode wird Ihnen “WIE BESEHEN” und ohne Zusicherungen, Gewährleistungen oder Bedingungen jeglicher Art zur Verfügung gestellt. Sie dürfen sie auf eigenes Risiko verwenden, modifizieren und verbreiten. CITRIX LEHNT ALLE GEWÄHRLEISTUNGEN AB, OB AUSDRÜCKLICH, STILLSCHWEIGEND, SCHRIFTLICH, MÜNDLICH ODER GESETZLICH, EINSCHLIESSLICH, ABER NICHT BESCHRÄNKT AUF GEWÄHRLEISTUNGEN DER MARKTGÄNGIGKEIT, DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK, DES EIGENTUMS UND DER NICHTVERLETZUNG VON RECHTEN DRITTER. Ohne die Allgemeingültigkeit des Vorstehenden einzuschränken, erkennen Sie an und stimmen zu, dass (a) die Software / der Beispielcode Fehler, Designmängel oder andere Probleme aufweisen kann, die möglicherweise zu Datenverlust oder Sachschäden führen; (b) es möglicherweise nicht möglich ist, die Software / den Beispielcode vollständig funktionsfähig zu machen; und (c) Citrix ohne vorherige Ankündigung oder Haftung Ihnen gegenüber die aktuelle Version und/oder zukünftige Versionen der Software / des Beispielcodes einstellen kann. In keinem Fall darf die Software / der Code zur Unterstützung von ultra-gefährlichen Aktivitäten verwendet werden, einschließlich, aber nicht beschränkt auf lebenserhaltende oder Sprengaktivitäten. WEDER CITRIX NOCH SEINE VERBUNDENEN UNTERNEHMEN ODER VERTRETER HAFTEN, WEDER AUFGRUND VON VERTRAGSVERLETZUNG NOCH EINER ANDEREN HAFTUNGSTHEORIE, FÜR JEGLICHE SCHÄDEN, DIE SICH AUS DER VERWENDUNG DER SOFTWARE / DES BEISPIELCODES ERGEBEN, EINSCHLIESSLICH, ABER NICHT BESCHRÄNKT AUF DIREKTE, BESONDERE, ZUFÄLLIGE, STRAFENDE, FOLGE- ODER ANDERE SCHÄDEN, SELBST WENN AUF DIE MÖGLICHKEIT SOLCHER SCHÄDEN HINGEWIESEN WURDE. Sie erklären sich damit einverstanden, Citrix von allen Ansprüchen freizustellen und zu verteidigen, die sich aus Ihrer Verwendung, Modifikation oder Verbreitung des Codes ergeben.