IA-Connect JML
IA-Connect ist eine Roboter-Prozessautomatisierungs-RPA-Plattform, die RPA-Funktionen aus der Cloud zu lokalen virtuellen Computern oder über Citrix- oder Microsoft Remote Desktop -RDS-Verbindungen hinzufügt. Dies ist das Modul zum Automatisieren von Joiner-, Mover-, Leaver-Prozessen.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Ultima Business |
| Webseite | https://www.ultima.com/ultima-labs |
| Datenschutzrichtlinie | https://www.ultima.com/privacy-policy |
| Kategorien | IT-Vorgänge; Produktivität |
IA-Connect ist eine RPA-Plattform (Robot Process Automation), die RPA-Funktionen von Power Automate Cloud Flows zu lokalen virtuellen Computern oder über Citrix- oder RdS-Verbindungen (Microsoft Remote Desktop) hinzufügt. Die IA-Connect Connectors bieten über 800 Aktionen, sodass Sie jede Art von lokaler Anwendung direkt aus einem Power Automate Cloud Flow automatisieren können. Alle IA-Connect Aktionen stehen direkt aus Ihrem Power Automate Cloud Flow zur Verfügung, die eine einfache Integration zwischen Cloud-basierten und lokalen Anwendungen ermöglicht, die Möglichkeit, vorhandene Power Automate-Bedingungen, Schleifen, dynamische Inhalte, Ausdrücke und Ausnahmebehandlung in Ihren RPA-Prozessen zu nutzen. Die Verwendung der IA-Connect Connectors bietet außerdem vollständige Ausführungsverlauf und Auditierbarkeit aus dem Flussausführungsverlauf und entfernt gleichzeitig die Notwendigkeit, eine separate Anwendung/Konsole/Studio für die Entwicklung Ihrer RPA-Prozesse zu haben.
Voraussetzungen
Um einen der IA-Connect Connectors zu verwenden, müssen Sie die IA-Connect Software installieren. Dies ist kostenlos für 30 Tage zu testen, nachdem Sie eine IA-Connect Lizenz benötigen.
Die IA-Connect Software besteht aus zwei Hauptkomponenten:
Der IA-Connect Orchestrator, bei dem es sich um eine Azure WebApp handelt, die Sie in Ihrem eigenen Azure-Mandanten hosten würden. Dies behandelt das Routing und die Sicherheit von RPA-Flüssen an einen oder mehrere lokale oder cloudbasierte virtuelle Computer.
Der IA-Connect Agent und Director, der auf den virtuellen Computern installiert ist, auf denen die Software, auf die Sie automatisieren möchten, zugänglich ist. Darüber hinaus kann der IA-Connect-Agent innerhalb einer Citrix- oder Microsoft Remote Desktop Services (RDS)-Sitzung ausgeführt werden, in der die RPA-Befehle zur Ausführung in die Remotesitzung übergeben werden. Der IA-Connect Agent kann über eine Netzwerkfreigabe ausgeführt werden und erfordert keine Installation.
Verfügbare IA-Connect Connectors
Die verfügbaren IA-Connect Connectors sind:
- dynamischer Code IA-Connect
- IA-Connect Java
- IA-Connect JML
- IA-Connect Mainframe
- IA-Connect Microsoft Office
- IA-Connect SAP-GUI
- IA-Connect-Sitzung
- IA-Connect UI
- IA-Connect Webbrowser
So erhalten Sie Anmeldeinformationen
Um Ihre Lizenz zu erhalten und Ihre 30-tägige kostenlose Testversion zu beginnen, übermitteln Sie bitte eine Anfrage auf unserer Website (https://www.ultima.com/IA-Connect/Power-Automate).
Sobald eine Testanfrage eingegangen ist, werden wir Sie über die angegebene E-Mail-Adresse kontaktieren, um die Einrichtung der IA-Connect Software zu unterstützen und Ihnen die Testlizenz zur Verfügung zu stellen. Dies ist eine voll ausgestattete Testversion und ermöglicht es Ihnen, alle 800 Aktionen in allen 9 IA-Connect Connectors innerhalb Ihrer eigenen Umgebung während des Testzeitraums zu testen.
Erste Schritte mit Ihrem Connector
Nachdem Sie eine Testanforderung für IA-Connect eingereicht haben, können Sie eine ZIP-Datei herunterladen, die die IA-Connect Software und Dokumentation enthält, die die Installation und Einrichtung abdeckt. Wir werden Sie auch kontaktieren, um Support und Anleitungen über den Installationsprozess nach Bedarf anzubieten.
Support
Während des Testzeitraums können Sie sich an Ultima Labs (IAConnect@ultima.com) wenden, um Support und Unterstützung zu erhalten.
Beim Kauf IA-Connect Lizenzen erhalten Sie Supporttoken, die für maßgeschneiderte Schulungen oder Support von Ultimas UK Technical Service Centre (TSC) eingelöst werden können.
Bekannte Probleme, häufige Fehler und HÄUFIG gestellte Fragen
Unsere Knowledge Base enthält eine Reihe von Artikeln über bekannte Probleme, häufige Fehler, die bei verwendung der IA-Connect Connectors und häufig gestellten Fragen auftreten können. Dies ist verfügbar https://support.ultima.com/ultimalabs und ein Konto für den Zugriff auf diese Ressourcen wird während der IA-Connect Testversion und beim Kauf einer IA-Connect-Lizenz bereitgestellt.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API | Richtig |
| IA-Connect Orchestrator-Adresse | Schnur | Angeben der IA-Connect Orchestrator-Adresse ohne die HTTP(S)-Komponente | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Ablauf des Active Directory-Benutzerkontos löschen |
Löscht das Ablaufdatum für ein Active Directory-Konto. |
| Abrufen der Active Directory-OU aus Benutzer-DN |
Eine Hilfsfunktion. Gibt angesichts des Distinguished Name (DN) eines Active Directory-Benutzers die Organisationseinheit (ORGANISATIONSEINHEIT) zurück, in der sich der Benutzer befindet. |
| Abrufen der Microsoft Exchange-Postfachverteilergruppenmitgliedschaft |
Abrufen, in welchen Verteilergruppen ein Postfach Mitglied ist. |
| Abrufen der Office 365-Postfachverteilergruppenmitgliedschaft |
Abrufen, in welchen Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen ein Office 365- oder Exchange Online-Postfach Mitglied ist. |
| Abrufen des Domänen-FQDN der Active Directory-Domäne aus DN |
Eine Hilfsfunktion. Wenn der Distinguished Name (DN) eines Active Directory-Benutzers angegeben ist, wird die Active Directory-Domäne zurückgegeben, die den Benutzer enthält. |
| Abrufen des nächsten verfügbaren Kontonamens |
Details zum Benennungsformat für Active Directory- und Exchange-Kontonamen enthalten die Details des nächsten verfügbaren Ersatzkontonamens. Wird verwendet, um zu bestimmen, welches Active Directory- und Exchange-Konto für einen bestimmten Benutzer erstellt werden soll. Diese Aktion erstellt keine Konten, es enthält Informationen zur Namensverfügbarkeit. |
| Abrufen einer Microsoft Exchange Online-Postfach-E-Mail-Adressen |
Ruft eine Liste aller E-Mail-Adressen ab, die einem vorhandenen Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) zugewiesen sind. Dazu gehören die primäre SMTP-Adresse, Proxy-E-Mail-Adressen, X.400-Adressen und EUM-Adressen (Exchange Unified Messaging). Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. |
| Abrufen einer Microsoft Exchange-Postfach-E-Mail-Adressen |
Ruft eine Liste aller E-Mail-Adressen ab, die einem Microsoft Exchange-Postfach zugewiesen sind. Dazu gehören die primäre SMTP-Adresse, Proxy-E-Mail-Adressen, X.400-Adressen und EUM-Adressen (Exchange Unified Messaging). |
| Abrufen einer Office 365-Verteilergruppe |
Gibt die Eigenschaften der angegebenen Microsoft Exchange Online- oder Office 365-Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen zurück. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. |
| Abrufen eines Office 365-Postfachs |
Gibt die Eigenschaften des angegebenen Microsoft Exchange Online- oder Office 365-Postfachs zurück. |
| Abrufen von Active Directory-Domäneninformationen |
Ruft Informationen zu einer Active Directory-Domäne ab. |
| Abrufen von Active Directory-Gruppenmitgliedern |
Gibt eine Liste der Mitglieder einer Active Directory-Gruppe zurück. |
| Abrufen von Azure AD-Benutzerlizenzdienstplänen |
Ruft eine Liste der Lizenzenpläne ab, die einer angegebenen Azure AD-Benutzerlizenz (SKU) zugewiesen sind. Beispiel: Wenn dem Benutzer die FLOW_FREE Lizenz zugewiesen ist, können Sie dadurch anzeigen, welche Dienstpläne er für diese Lizenz bereitgestellt hat. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Abrufen von Azure AD-Benutzerlizenzen |
Ruft eine Liste der Lizenzen (SKU) ab, die einem Azure AD-Benutzer zugewiesen sind. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Abrufen von Azure AD-Benutzern |
Gibt die Details von Benutzern in Azure Active Directory zurück (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Sie können nach Objekt-ID oder mithilfe eines Filters suchen. Eine Objekt-ID-Suche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Abrufen von Azure AD-Gruppen |
Gibt die Details von Gruppen in Azure Active Directory zurück (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Sie können nach Objekt-ID oder mithilfe eines Filters suchen. Eine Objekt-ID-Suche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Abrufen von Azure AD-Gruppenmitgliedern |
Gibt eine Liste der Mitglieder einer Azure Active Directory-Gruppe zurück. Mitglieder können Benutzer, Gruppen, Geräte oder Dienstprinzipale /Unternehmensanwendungen sein. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Abrufen von Azure AD-Lizenz-SKUs |
Gibt eine Liste der Azure Active Directory-Lizenz-Lagerhaltungseinheiten (Stock Keeping Units, SKUs) zurück, die das verbundene Azure AD abonniert hat. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Abrufen von Microsoft Exchange Online-Postfachdetails |
Gibt die Eigenschaften des angegebenen Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfach) zurück. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. |
| Abrufen von Microsoft Exchange-Postfachdetails |
Gibt die Eigenschaften des angegebenen Exchange-Postfachs zurück. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. |
| Abrufen von Microsoft Exchange-Verteilergruppendetails |
Rufen Sie die Details einer Microsoft Exchange-Verteilergruppe ab. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. |
| Abrufen von Microsoft Exchange-Verteilergruppenmitgliedern |
Dient zum Abrufen einer Liste der Mitglieder einer Microsoft Exchange-Verteilergruppe. |
| Abrufen von Office 365-Verteilergruppenmitgliedern |
Dient zum Abrufen einer Liste der Mitglieder einer Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe. |
| Abrufen von Rollenzuweisungen für Azure AD-Benutzeradministratoren |
Gibt eine Liste der Azure Active Directory-Administratorrollen zurück, denen der angegebene Benutzer zugewiesen ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Active Directory-Benutzer abrufen |
Gibt die Eigenschaften eines angegebenen Active Directory-Benutzers zurück. Sie können entweder nach Identität (um einen einzelnen Benutzer zu finden) oder einen Filter verwenden (um einen oder mehrere Benutzer zu finden). |
| Active Directory-Benutzer aus allen Gruppen entfernen |
Entfernt einen Active Directory-Benutzer aus allen Active Directory-Gruppen, in denen sie Mitglied sind. IA-Connect entfernt den Benutzer aus so vielen Gruppen wie möglich und berichtet über das Ergebnis. Diese Aktion funktioniert nur mit Benutzerkonten, Sie können diese Aktion nicht verwenden, um die Gruppenmitgliedschaften einer Gruppe oder eines Computers zu entfernen. |
| Active Directory-Benutzer entfernen |
Entfernt einen Benutzer aus Active Directory. |
| Active Directory-Benutzergruppenmitgliedschaft abrufen |
Gibt eine Liste von Active Directory-Gruppen zurück, bei der der angegebene Benutzer Mitglied ist, abzüglich der primären Gruppe (in der Regel 'Domänenbenutzer'), da es technisch keine Mitgliedschaft ist. Diese Aktion funktioniert nur mit Benutzerkonten, Sie können diese Aktion nicht verwenden, um die Gruppenmitgliedschaft von Gruppen oder Computern abzufragen. |
| Active Directory-Benutzerkonto deaktivieren |
Deaktiviert ein Active Directory-Benutzerkonto. Wenn ein Benutzerkonto deaktiviert ist, kann sich der Benutzer nicht anmelden. |
| Active Directory-Gruppe abrufen |
Gibt die Eigenschaften einer angegebenen Active Directory-Gruppe oder -Gruppen zurück. Sie können entweder nach Identität (um eine einzelne Gruppe zu finden) oder einen Filter verwenden (um eine oder mehrere Gruppen zu finden). |
| Active Directory-Gruppe entfernen |
Entfernt eine Gruppe aus Active Directory. Wenn in der Gruppe Objekte (z. B. Benutzer, Gruppen oder Computer) vorhanden sind, werden diese Objekte im Rahmen des Gruppenlöschvorgangs entfernt. |
| Active Directory-Gruppenmitglied entfernen |
Entfernt ein Active Directory-Mitglied (Benutzer, Gruppe oder Computer) aus einer Active Directory-Gruppe. |
| Aktivieren des Active Directory-Benutzerkontos |
Aktiviert ein Active Directory-Benutzerkonto. Wenn das Konto nicht deaktiviert ist, führt dieser Befehl nichts aus. |
| Aktivieren des Azure AD-Benutzers |
Aktiviert einen Azure Active Directory-Benutzer. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
|
Ausführen des Active Directory Power |
Führt ein PowerShell-Skript im Active Directory-Runspace in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect-Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen ihres eigenen benutzerdefinierten Active Directory PowerShell-Codes. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden. |
|
Ausführen des Azure AD Power |
Führt ein PowerShell-Skript in Azure Active Directory (auch als Microsoft Entra ID, Azure AD oder AAD bezeichnet) in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen eigener benutzerdefinierter Azure AD PowerShell-Skripts. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden. Diese Aktion verwendet PowerShell-Module für Azure AD v2- oder Microsoft Graph-Benutzer. |
|
Ausführen eines Exchange Power |
Führt ein PowerShell-Skript im Exchange-Runspace in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen Ihres eigenen benutzerdefinierten Exchange PowerShell-Codes. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden. |
|
Ausführen eines Office 365 Power |
Führt ein PowerShell-Skript im Office 365-Runspace in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen Ihres eigenen benutzerdefinierten Office 365 Exchange Online PowerShell-Codes. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden. |
|
Ausführen von Active Directory Dir |
Führt eine Synchronisation zwischen Active Directory (lokal) und Azure Active Directory (Cloud) durch. Dieser Befehl muss auf dem Server mit der Rolle "DirSync" (d. h. dem Computer, der die Synchronisation ausführt) ausgegeben werden. |
| Azure AD-Benutzer aus Gruppe entfernen |
Entfernt einen Azure Active Directory-Benutzer aus einer Azure Active Directory-Gruppe. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Azure AD-Benutzer deaktivieren |
Deaktiviert einen Azure Active Directory-Benutzer. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Azure AD-Benutzergruppenmitgliedschaft abrufen |
Gibt eine Liste von Azure Active Directory-Gruppen zurück, bei der der angegebene Benutzer Mitglied ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Deaktivieren des Microsoft Exchange Online-Postfachs für einen Benutzer |
Deaktivieren Sie ein vorhandenes Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach). Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. |
| Deaktivieren des Microsoft Exchange-Postfachs für einen Benutzer |
Deaktivieren Sie ein vorhandenes Microsoft Exchange-Postfach. |
| Entfernen aller Azure AD-Benutzerlizenzen |
Entfernt alle Azure AD-Benutzerlizenzen (SKU), die einem Benutzer zugewiesen sind. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen der Active Directory-OU |
Entfernt eine Organisationseinheit (OU) aus Active Directory. Die OU kann nicht gelöscht werden, wenn objekte (z. B. Benutzer, Gruppen oder Computer) in der OU vorhanden sind. |
| Entfernen der Azure AD-Sicherheit oder microsoft 365-Gruppe |
Entfernen Sie eine Azure Active Directory-Sicherheitsgruppe oder Eine Microsoft 365-Gruppe. Diese Aktion kann keine E-Mail-aktivierten Sicherheitsgruppen oder Verteilerlisten entfernen: Verwenden Sie stattdessen die Aktion "Office 365-Verteilergruppe entfernen". Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen der Microsoft Exchange-Postfachberechtigung vom Benutzer |
Entfernen von Postfachberechtigungen aus einem bestimmten Postfachbenutzer, Benutzer oder einer Sicherheitsgruppe. |
| Entfernen der Office 365-Postfachberechtigung vom Benutzer |
Entfernen Von Microsoft Exchange Online- oder Office 365-Postfachberechtigungen aus einem bestimmten Postfachbenutzer, -Benutzer oder -Sicherheitsgruppe. |
| Entfernen des Active Directory-Objekts aus mehreren Gruppen |
Entfernt ein Active Directory-Objekt (in der Regel ein Benutzer, eine Gruppe oder einen Computer) aus mehreren vorhandenen Active Directory-Gruppen. IA-Connect entfernt das Objekt aus so vielen Gruppen wie möglich und berichtet über das Ergebnis. Wenn das Objekt kein Mitglied einer oder mehrerer der angegebenen Gruppen ist, wird dies als Erfolg gezählt. |
| Entfernen des Office 365-Postfachs aus allen Verteilergruppen |
Entfernen Eines Postfachs aus allen Microsoft Exchange Online- oder Office 365-Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen, bei denen es sich um ein Mitglied handelt. |
| Entfernen einer Microsoft Exchange-Verteilergruppe |
Entfernen Sie eine Microsoft Exchange-Verteilergruppe. |
| Entfernen einer Office 365-Verteilergruppe |
Entfernen Sie eine Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe. |
| Entfernen eines Azure AD-Benutzers |
Entfernen Sie einen Azure Active Directory-Benutzer. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen eines Azure AD-Benutzers aus allen Administratorrollenzuweisungen |
Entfernt einen Azure Active Directory-Benutzer (oder ein anderes Objekt) aus allen Azure Active Directory-Administratorrollen, denen sie zugewiesen sind. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen eines Azure AD-Benutzers aus allen Gruppen |
Entfernt einen Azure Active Directory-Benutzer aus allen Azure Active Directory-Gruppen, in denen er Mitglied ist. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen eines Azure AD-Benutzers aus der Administratorrollenzuweisung |
Entfernen Sie einen Azure Active Directory-Benutzer (oder ein anderes Objekt) aus einer vorhandenen Azure Active Directory-Administratorrollenzuweisung. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen eines Azure AD-Benutzers aus mehreren Administratorrollen |
Entfernt einen Azure Active Directory-Benutzer (oder ein anderes Objekt) aus einer oder mehreren vorhandenen Azure Active Directory-Administratorrollen. Diese Aktion durchläuft die Liste der Rollenzuweisungen des Benutzers und entfernt übereinstimmende Elemente. Wenn Sie also nicht vorhandene Rollen angeben, löst dies keinen Fehler aus (da der Benutzer nicht in dieser Rolle ist, wird nichts versucht). Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen eines Azure AD-Benutzers aus mehreren Gruppen |
Entfernt einen Azure Active Directory-Benutzer aus mehreren vorhandenen Azure Active Directory-Gruppen, in denen die Gruppen durch Objekt-ID oder Anzeigename angegeben werden. IA-Connect entfernt den Benutzer aus so vielen Gruppen wie möglich und berichtet über das Ergebnis. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Entfernen eines Microsoft Exchange-Mitglieds aus der Verteilergruppe |
Entfernen Eines Mitglieds (z. B. eines Benutzers) aus einer Exchange-Verteilergruppe. Wenn sich das Mitglied nicht in der Gruppe befindet, wird keine Aktion ausgeführt. |
| Entfernen eines Office 365-Mitglieds aus der Verteilergruppe |
Entfernen Eines Mitglieds aus einer Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe. |
| Entfernen mehrerer Active Directory-Gruppenmitglieder |
Entfernen Sie mindestens ein Active Directory-Objekt (in der Regel Benutzer, Gruppen oder Computer) aus einer vorhandenen Active Directory-Gruppe. IA-Connect entfernt so viele Mitglieder aus der Gruppe wie möglich und berichtet über das Ergebnis. Wenn sich Gruppen- und Gruppenmitglied in verschiedenen Domänen befinden, müssen Sie den Distinguished Name (DN) für Gruppen und Mitglieder angeben. Wenn einige der Objekte kein Mitglied der Gruppe sind, wird dies als Erfolg gezählt. |
| Entsperren des Active Directory-Kontos |
Entsperren Sie ein Active Directory-Konto. Wenn das Konto nicht gesperrt ist, führt dieser Befehl nichts aus. |
| Erstellen einer neuen Azure AD Microsoft 365-Gruppe |
Erstellt eine neue Azure Active Directory Microsoft 365-Gruppe. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Erstellen einer neuen Azure AD-Sicherheitsgruppe |
Erstellt eine neue Azure Active Directory-Sicherheitsgruppe. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Erstellen einer neuen Microsoft Exchange-Verteilergruppe |
Erstellt eine neue Microsoft Exchange-Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe. |
| Erstellen einer neuen Office 365-Verteilergruppe |
Erstellt eine neue Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe. |
| Erstellen eines freigegebenen Office 365-Postfachs und eines Benutzerkontos |
Erstellen Sie ein freigegebenes Postfach in Microsoft Exchange Online und ein Benutzerkonto in Azure Active Directory /Entra-ID. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht bereits in Azure Active Directory/Entra-ID vorhanden ist. Die SMTP-Adresse des freigegebenen Postfachs basiert auf dem Namen, alias oder der primären SMTP-Adresse (je nachdem, welche Eingaben bereitgestellt werden). |
| Erstellen eines Microsoft Exchange Online-Postfachs für einen Benutzer |
Erstellt ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) oder Archivpostfach für einen vorhandenen Benutzer in lokalem Active Directory, das noch nicht über ein Postfach verfügt. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. Sie können diese Aktion auch verwenden, um ein vorhandenes Remotepostfach zu archivieren. |
| Erstellen eines Microsoft Exchange Online-Postfachs und eines Benutzerkontos |
Erstellen Sie einen E-Mail-aktivierten Benutzer in lokalem Active Directory, und erstellen Sie ein zugeordnetes Remotepostfach in Microsoft Exchange Online oder Office 365. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht in lokalem Active Directory vorhanden ist. Wenn der Benutzer bereits vorhanden ist, verwenden Sie die Aktion "Microsoft Exchange Online-Postfach für einen Benutzer erstellen". Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. |
| Erstellen eines Microsoft Exchange-Postfachs für einen Benutzer |
Erstellt ein Microsoft Exchange-Postfach für einen vorhandenen Benutzer, der noch nicht über ein Postfach verfügt. |
| Erstellen eines Microsoft Exchange-Postfachs und eines Benutzerkontos |
Erstellen Sie einen E-Mail-aktivierten Benutzer in lokalem Active Directory, und erstellen Sie ein zugeordnetes Postfach in Microsoft Exchange. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht in lokalem Active Directory vorhanden ist. Wenn der Benutzer bereits vorhanden ist, verwenden Sie die Aktion "Erstellen eines Microsoft Exchange-Postfachs für einen Benutzer". |
| Erstellen eines Office 365-Archivpostfachs für vorhandene Benutzer |
Erstellt ein archiviertes Postfach in Microsoft Exchange online für einen vorhandenen Benutzer in Azure Active Directory /Entra ID. Der Benutzer muss bereits über ein Postfach und eine geeignete Lizenz verfügen. |
| Erstellen eines Office 365-Postfachs und eines Benutzerkontos |
Erstellen Sie ein Postfach in Microsoft Exchange Online und ein Benutzerkonto in Azure Active Directory/Entra-ID. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht bereits in Azure Active Directory/Entra-ID vorhanden ist. Wenn der Benutzer bereits vorhanden ist, weisen Sie dem Benutzerkonto stattdessen eine geeignete Lizenz zu. |
| Festlegen der Azure AD-Benutzerlizenz |
Fügt eine Azure AD-Benutzerlizenz (SKU) hinzu oder entfernt sie. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Festlegen der Eigenschaften für ein Microsoft Exchange Online-Postfach |
Legen Sie die Eigenschaften eines vorhandenen Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfach) fest. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. |
| Festlegen der Eigenschaften für ein Microsoft Exchange-Postfach |
Legen Sie die Eigenschaften eines vorhandenen Microsoft Exchange-Postfachs fest. |
| Festlegen der Eigenschaften für ein Office 365-Postfach |
Legen Sie die Eigenschaften für ein Microsoft Exchange Online- oder Office 365-Postfach fest. |
| Festlegen des Ablaufdatums des Active Directory-Benutzerkontos |
Legt das Ablaufdatum des Kontos für ein Active Directory-Benutzerkonto fest. Dies ist der letzte vollständige Tag, an dem das Konto nutzbar ist, also läuft das Konto technisch zu Beginn des nächsten Tages ab. Der IA-Connect Agent weiß dies und fügt automatisch 1 Tag zum bereitgestellten Eingabedatum hinzu, wenn das Datum in Active Directory gespeichert wird. |
| Festlegen des Active Directory-Servers |
Legt einen bestimmten Active Directory-Server fest, der für alle weiteren Active Directory-Aktionen verwendet werden soll. |
| Festlegen des Sendens von Exchange-Postfächern im Auftrag von |
Geben Sie an, wer im Auftrag dieses vorhandenen Postfachs senden kann. |
| Festlegen des Vorgesetzten des Azure AD-Benutzers |
Legen Sie den Vorgesetzten eines Azure Active Directory-Benutzers fest. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Festlegen eines Active Directory-Benutzers, der vor versehentlichem Löschen geschützt ist |
Legt fest, dass ein Active Directory-Konto vor versehentlichem Löschen geschützt (oder nicht geschützt) wird. Wenn Sie ein Konto vor versehentlichem Löschen schützen, können Sie dieses Konto erst löschen, wenn Sie den Schutz entfernen. |
| Festlegen von automatischen Antworten (Außer Haus) für ein Microsoft Exchange-Postfach |
Legen Sie automatische Antworten (Außer Haus) für ein Microsoft Exchange-Postfach fest. Diese Aktion funktioniert nicht für Remotepostfächer in Microsoft Exchange Online oder Office 365: Verwenden Sie stattdessen die Aktion "Automatische Antworten (Außer Haus) für ein Office 365-Postfach festlegen". |
| Festlegen von automatischen Antworten (Außer Haus) für ein Office 365-Postfach |
Legen Sie automatische Antworten (Außer Haus) für ein Microsoft Exchange Online- oder Office 365-Postfach fest. |
| Festlegen von Exchange zum Anzeigen der gesamten Active Directory-Gesamtstruktur |
Geben Sie an, ob die gesamte Active Directory-Gesamtstruktur (einschließlich Unterdomänen) beim Ausführen von Exchange-Aktionen durchsucht/angezeigt wird. Möglicherweise müssen Sie diese Aktion verwenden, wenn Sie über mehrere verknüpfte Domänen verfügen. |
| Gibt die Active Directory-Gruppe an |
Gibt zurück, ob eine angegebene Active Directory-Gruppe vorhanden ist. |
| Herstellen einer Verbindung mit Active Directory mit Anmeldeinformationen |
Ermöglicht es Ihnen, ein alternatives Konto anzugeben, das beim Ausführen von Active Directory-PowerShell-Befehlen verwendet werden soll. Dies wirkt sich auf alle Active Directory-Befehle aus, die nach dieser Aktion ausgegeben wurden. Wenn Sie diese Aktion nicht verwenden, werden alle Active Directory PowerShell-Befehle als Benutzerkonto ausgeführt, wie der IA-Connect Agent ausgeführt wird. |
| Herstellen einer Verbindung mit Azure AD mit Anmeldeinformationen |
Verbindet IA-Connect mit Azure Active Directory (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Diese Aktion (oder "Mit Azure AD mit Zertifikat verbinden") muss ausgestellt werden, bevor andere Azure AD-Aktionen ausgeführt werden. Diese Aktion erfordert entweder ein Konto, das MFA (2FA) nicht verwendet, oder Sie müssen das Benutzeroberflächenautomatisierungsmodul verwenden, um die 2FA-Komponente (d. h. das Popup für die einmalige Kennwortauthentifizierung) zu automatisieren. Alternativ können Sie die Aktion "Mit Azure AD mit Zertifikat verbinden" verwenden. Diese Aktion verwendet PowerShell-Module für Azure AD v2- oder Microsoft Graph-Benutzer. |
| Herstellen einer Verbindung mit Azure AD mit Zertifikat |
Verbindet IA-Connect mit Azure Active Directory (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Diese Aktion (oder "Mit Anmeldeinformationen verbinden") muss ausgegeben werden, bevor andere Azure AD-Aktionen ausgeführt werden. Für diese Aktion ist eine Azure Service Principal- und Azure AD-App-Registrierung mit zertifikatsbasiertem Setup in Azure AD erforderlich, bevor sie funktioniert, hat jedoch den Vorteil, dass MFA (2FA) nicht erforderlich ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph PowerShell-Module. |
| Herstellen einer Verbindung mit der Standardmäßigen Active Directory-Domäne |
Verbindet den IA-Connect Agent mit der Domäne, auf der der Computer, auf dem der IA-Connect Agent ausgeführt wird, mitglied ist, wobei das Konto verwendet wird, in dem der IA-Connect Agent ausgeführt wird (d. h. das Standardverhalten). |
| Herstellen einer Verbindung mit JML-Umgebung |
Stellen Sie eine Verbindung mit einer JML-Umgebung her, in der die Details dieser Umgebung im IA-Connect Orchestrator enthalten sind. Diese Details können Anmeldeinformationen, Adressen und andere Verbindungseinstellungen enthalten. Sie können diese Aktion beispielsweise verwenden, um eine Verbindung mit Active Directory, Microsoft Exchange, Azure AD oder Office 365 Exchange Online herzustellen. |
| Herstellen einer Verbindung mit Microsoft Exchange |
Verbindet IA-Connect mit einem Microsoft Exchange-Server. Diese Aktion muss ausgegeben werden, bevor andere Exchange-Aktionen ausgeführt werden. Wenn Sie einen Benutzernamen und ein Kennwort angeben, werden alle nachfolgenden Exchange-Aktionen als dieses Konto ausgeführt. Wenn Sie keinen Benutzernamen und ein Kennwort angeben, werden alle nachfolgenden Exchange-Aktionen als Benutzerkonto ausgeführt, wie der IA-Connect Agent ausgeführt wird. |
| Herstellen einer Verbindung mit Office 365 mit Anmeldeinformationen |
Verbindet IA-Connect mit Office 365 mithilfe der Office 365 PowerShell-Module. Diese Aktion (oder "Mit Office 365 mit Zertifikat verbinden") muss ausgestellt werden, bevor andere Office 365-Aktionen ausgeführt werden. Diese Aktion erfordert entweder ein Konto, für das keine MFA (2FA) erforderlich ist, oder Sie müssen das Benutzeroberflächenautomatisierungsmodul verwenden, um die 2FA-Komponente (d. h. das Einmalige Kennwortauthentifizierungspopup) zu automatisieren. Verwenden Sie alternativ die Aktion "Mit Office 365 mit Zertifikat verbinden". |
| Herstellen einer Verbindung mit Office 365 mit Zertifikat |
Verbindet IA-Connect mit Office 365 mithilfe der Office 365 PowerShell-Module. Diese Aktion (oder "Mit Anmeldeinformationen verbinden") muss ausgegeben werden, bevor andere Office 365-Aktionen ausgeführt werden. Für diese Aktion ist eine Azure AD-App-Registrierung mit Zertifikaten und die richtigen Rollen erforderlich, die in Azure AD eingerichtet werden müssen, bevor sie funktioniert, hat jedoch den Vorteil, dass MFA (2FA) nicht erforderlich ist. |
| Hinzufügen der Microsoft Exchange-Postfachberechtigung |
Zuweisen von Postfachberechtigungen zu einem Active Directory-Objekt (z. B. Benutzer oder Gruppe). |
| Hinzufügen der Microsoft Exchange-Postfachberechtigung zum Benutzer |
Zuweisen von Postfachberechtigungen zu einem bestimmten Postfachbenutzer, Benutzer oder einer Sicherheitsgruppe. |
| Hinzufügen der Office 365-Postfachberechtigung zum Benutzer |
Weisen Sie einem bestimmten Postfachbenutzer, einem bestimmten Benutzer oder einer Sicherheitsgruppe Microsoft Exchange Online oder Office 365-Postfachberechtigungen zu. |
| Hinzufügen einer Active Directory-Gruppe |
Erstellt eine neue Active Directory-Gruppe. |
| Hinzufügen einer Active Directory-OU |
Erstellt eine neue Active Directory-Organisationseinheit (OU). |
| Hinzufügen eines Active Directory-Benutzers |
Erstellt ein neues Active Directory-Benutzerkonto. |
| Hinzufügen eines Active Directory-Gruppenmitglieds |
Hinzufügen eines Active Directory-Objekts (in der Regel ein Benutzer, eine Gruppe oder einen Computer) zu einer vorhandenen Active Directory-Gruppe. Wenn sich Gruppen- und Gruppenmitglied in verschiedenen Domänen befinden, müssen Sie den Distinguished Name (DN) für Gruppen und Mitglieder angeben. |
| Hinzufügen eines Active Directory-Objekts zu mehreren Gruppen |
Fügen Sie ein Active Directory-Objekt (in der Regel ein Benutzer, eine Gruppe oder einen Computer) zu mehreren vorhandenen Active Directory-Gruppen hinzu. IA-Connect fügt das Objekt so viele Gruppen wie möglich hinzu und berichtet über das Ergebnis. Wenn das Objekt bereits Mitglied einer oder mehrerer der angegebenen Gruppen ist, wird dies als Erfolg gezählt. |
| Hinzufügen eines Azure AD-Benutzers |
Erstellt ein neues Azure Active Directory-Benutzerkonto. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Hinzufügen eines Azure AD-Benutzers zu mehreren Gruppen |
Fügt einen Azure Active Directory-Benutzer mehreren vorhandenen Azure Active Directory-Gruppen hinzu, in denen die Gruppen durch Objekt-ID oder Anzeigename angegeben werden. IA-Connect fügt den Benutzer so viele Gruppen wie möglich hinzu und berichtet über das Ergebnis. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Hinzufügen eines Azure AD-Benutzers zur Gruppe |
Fügen Sie einen Azure Active Directory-Benutzer zu einer vorhandenen Azure Active Directory-Sicherheits- oder M365-Gruppe hinzu. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Hinzufügen eines Microsoft Exchange-Mitglieds zur Verteilergruppe |
Hinzufügen eines Mitglieds (z. B. eines Benutzers) zu einer Exchange-Verteilergruppe. Wenn sich das Mitglied bereits in der Gruppe befindet, wird keine Aktion ausgeführt. |
| Hinzufügen eines Office 365-Mitglieds zur Verteilergruppe |
Hinzufügen eines Mitglieds zu einer Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe. |
| Hinzufügen mehrerer Active Directory-Gruppenmitglieder |
Fügen Sie einer vorhandenen Active Directory-Gruppe ein oder mehrere Active Directory-Objekte (in der Regel Benutzer, Gruppen oder Computer) hinzu. IA-Connect fügt der Gruppe so viele Mitglieder wie möglich hinzu und berichtet über das Ergebnis. Wenn sich Gruppen- und Gruppenmitglied in verschiedenen Domänen befinden, müssen Sie den Distinguished Name (DN) für Gruppen und Mitglieder angeben. Wenn einige der Objekte bereits Mitglied der Gruppe sind, wird dies als Erfolg gezählt. |
| Ist Azure AD-Benutzer Administratorrolle zugewiesen |
Gibt zurück, ob einem Azure Active Directory-Benutzer eine Azure Active Directory-Administratorrolle zugewiesen ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Ist Benutzer in Azure AD-Benutzergruppe |
Gibt zurück, ob ein Benutzer Mitglied einer Azure Active Directory-Gruppe ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
|
Ist das Azure AD Power |
Meldet, ob die für Azure Active Directory erforderlichen PowerShell-Module (auch als Microsoft Entra ID, Azure AD oder AAD bezeichnet) auf dem Computer installiert werden, auf dem der IA-Connect Agent ausgeführt wird. Diese Aktion überprüft die PowerShell-Module Azure AD v2 und Microsoft Graph-Benutzer. |
| Ist das Microsoft Exchange Online-Postfach vorhanden |
Gibt zurück, ob das angegebene Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) vorhanden ist. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. |
| Ist das Microsoft Exchange-Postfach vorhanden |
Gibt zurück, ob das angegebene Exchange-Postfach vorhanden ist. |
| Ist mit Active Directory verbunden |
Meldet, ob IA-Connect mit Active Directory verbunden ist. Standardmäßig ist IA-Connect automatisch mit der Domäne verbunden, in der der Computer, auf dem der IA-Connect Agent ausgeführt wird, mitglied ist, wobei das Konto verwendet wird, in dem der IA-Connect Agent ausgeführt wird. Verwenden Sie die Aktion "Mit Active Directory mit Anmeldeinformationen verbinden", um eine Verbindung mit alternativen Anmeldeinformationen oder mit einer alternativen Domäne herzustellen. |
| Ist mit Azure AD verbunden |
Meldet, ob IA-Connect mit Azure Active Directory verbunden ist (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Verwenden Sie eine der Aktionen "Mit Azure AD verbinden", um eine Verbindung herzustellen. |
| Ist mit Microsoft Exchange verbunden |
Meldet, ob IA-Connect mit einem Microsoft Exchange-Server verbunden ist. Verwenden Sie die Aktion "Mit Microsoft Exchange verbinden", um eine Verbindung herzustellen. |
| Ist mit Office 365 verbunden |
Meldet, ob IA-Connect mithilfe der Office 365 PowerShell-Module mit Office 365 verbunden ist. Verwenden Sie die Aktion "Mit Office 365 verbinden", um eine Verbindung herzustellen. |
| Klonen der Active Directory-Benutzergruppenmitgliedschaft |
Fügt den Active Directory-Zielbenutzer zu den gleichen Active Directory-Gruppen hinzu, bei denen der erste Benutzer Mitglied ist, abzüglich der primären Gruppe (in der Regel 'Domänenbenutzer'), da es technisch keine Mitgliedschaft ist. |
| Klonen von Active Directory-Benutzereigenschaften |
Konfiguriert die angegebenen Eigenschaften/Attribute des Active Directory-Quellbenutzers für den Active Directory-Zielbenutzer. |
| Verbindung mit Active Directory trennen |
Wenn Sie die Aktion "Active Directory PowerShell-Runspace mit Anmeldeinformationen öffnen" zum Ausführen von Active Directory PowerShell-Befehlen als alternatives Benutzerkonto oder zu einer alternativen Domäne verwendet haben, gibt diese Aktion den IA-Connect Agent an das Standardverhalten der Ausführung von Active Directory-Aktionen als Benutzerkonto zurück, als der IA-Connect Agent ausgeführt wird. |
| Verbindung mit Azure AD trennen |
Trennt IA-Connect von Azure Active Directory (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Sie können Azure AD-Aktionen erst dann erneut ausstellen, wenn Sie die Verbindung erneut herstellen. Diese Aktion verwendet PowerShell-Module für Azure AD v2- oder Microsoft Graph-Benutzer, je nachdem, welches zum ursprünglichen Herstellen einer Verbindung verwendet wurde. |
| Verbindung mit Microsoft Exchange trennen |
Trennt IA-Connect von einem Microsoft Exchange-Server (verbunden mit der Aktion "Mit Microsoft Exchange verbinden"). Sie können Microsoft Exchange PowerShell-Aktionen erst dann erneut ausstellen, wenn Sie die Verbindung erneut herstellen. |
| Verbindung mit Office 365 trennen |
Trennt IA-Connect von Office 365 mithilfe der Office 365 PowerShell-Module (verbunden mit der Aktion "Mit Office 365 verbinden"). Sie können Office 365 PowerShell-Aktionen erst erneut ausstellen, wenn Sie die Verbindung erneut herstellen. |
| Verfügt das Office 365-Postfach über ein Archiv |
Meldet, ob ein vorhandenes Postfach in Microsoft Exchange Online über ein Archivpostfach verfügt. Wenn das Postfach nicht vorhanden ist, wird eine Ausnahme ausgelöst. |
| Verschieben des Active Directory-Benutzers in die OU |
Verschiebt einen Active Directory-Benutzer zu einer vorhandenen Active Directory-Organisationseinheit (OU). |
| Warten auf ein Office 365-Postfach |
Warten Sie, bis ein angegebenes Microsoft Exchange Online- oder Office 365-Postfach vorhanden ist. Dies ist häufig der Fall, wenn Sie auf eine AD-Synchronisierungs- oder Lizenzeinstellung warten, die wirksam wird. Wenn das Postfach bereits vorhanden ist, wird die Aktion sofort erfolgreich zurückgegeben. |
| Zurücksetzen der Eigenschaften in einem Microsoft Exchange Online-Postfach |
Legen Sie die angegebenen Eigenschaften eines vorhandenen Microsoft Exchange Online- oder Office 365(Remote)-Postfachs auf leer fest. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. |
| Zurücksetzen der Eigenschaften in einem Microsoft Exchange-Postfach |
Legen Sie die angegebenen Eigenschaften eines vorhandenen Microsoft Exchange-Postfachs auf leer fest. |
| Zurücksetzen des Active Directory-Benutzerkennworts |
Setzt das Kennwort eines Active Directory-Benutzers mit einem neuen Kennwort zurück und legt optional Kennworteigenschaften fest. |
| Zurücksetzen des Azure AD-Benutzerkennworts |
Setzt das Kennwort eines Azure Active Directory-Benutzers mit einem neuen Kennwort zurück. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Zurücksetzen von Azure AD-Benutzereigenschaften |
Setzen Sie allgemeine Eigenschaften eines Azure Active Directory-Benutzers auf einen leeren Wert zurück. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Zuweisen eines Azure AD-Benutzers zu mehreren Administratorrollen |
Weisen Sie einem oder mehreren vorhandenen Azure Active Directory-Administratorrollen einen Azure Active Directory-Benutzer (oder ein anderes Objekt) zu. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Zuweisen eines Azure AD-Benutzers zur Administratorrolle |
Weisen Sie einer vorhandenen Azure Active Directory-Administratorrolle einen Azure Active Directory-Benutzer (oder ein anderes Objekt) zu. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Ändern allgemeiner Active Directory-Benutzereigenschaften |
Ändern allgemeiner Eigenschaften eines Active Directory-Benutzers. Sie können eigenschaften nur Werte zuweisen und nicht auf "leer" festlegen. Verwenden Sie die Aktion "Active Directory-Benutzerzeichenfolgeneigenschaften ändern", um Eigenschaften auf "Leer" festzulegen. |
| Ändern der booleschen Active Directory-Benutzereigenschaft |
Ändern Einer einzelnen booleschen Eigenschaft (true /false) eines Active Directory-Benutzers. Auf diese Weise können Sie eine sehr bestimmte Benutzereinstellung ändern, einschließlich benutzerdefinierter Eigenschaften. |
| Ändern des Active Directory-Benutzerstartordners |
Legt den Startordner /Verzeichnis/Laufwerk für einen Active Directory-Benutzer fest. |
| Ändern einer Microsoft Exchange Online-Postfach-E-Mail-Adressen |
Ändern Sie die E-Mail-Adressen in einem vorhandenen Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach). Sie können primäre und Alias-E-Mail-Adressen hinzufügen, entfernen und ersetzen. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. |
| Ändern einer Microsoft Exchange-Postfach-E-Mail-Adressen |
Ändern Sie die E-Mail-Adressen in einem Microsoft Exchange-Postfach. Sie können primäre und Alias-E-Mail-Adressen hinzufügen, entfernen und ersetzen. |
| Ändern von Active Directory-Benutzerzeichenfolgeneigenschaften |
Ändern einzelner Zeichenfolgeneigenschaften eines Active Directory-Benutzers. Auf diese Weise können Sie sehr spezifische Benutzereinstellungen ändern, einschließlich benutzerdefinierter Eigenschaften. Sie können auch einzelne Benutzereigenschaften auf leer festlegen. |
| Ändern von Azure AD-Benutzereigenschaften |
Ändern sie allgemeine Eigenschaften eines Azure Active Directory-Benutzers. Sie können Eigenschaften nur Werte zuweisen, sie nicht auf "leer" festlegen, da ein leerer Wert als Absicht interpretiert wird, den Wert unverändert zu lassen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen. |
| Überprüfen, ob die Active Directory-OU vorhanden ist |
Meldet, ob eine Active Directory-Organisationseinheit (OU) vorhanden ist. |
Ablauf des Active Directory-Benutzerkontos löschen
Löscht das Ablaufdatum für ein Active Directory-Konto.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryClearADUserAccountExpirationResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Abrufen der Active Directory-OU aus Benutzer-DN
Eine Hilfsfunktion. Gibt angesichts des Distinguished Name (DN) eines Active Directory-Benutzers die Organisationseinheit (ORGANISATIONSEINHEIT) zurück, in der sich der Benutzer befindet.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-DN
|
UserDN | True | string |
Der Distinguished Name des Suchbenutzers (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local). |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzer-OU
|
UserOU | string |
Die Organisationseinheit (ORGANISATIONSEINHEIT), in der sich der Benutzer befindet. |
Abrufen der Microsoft Exchange-Postfachverteilergruppenmitgliedschaft
Abrufen, in welchen Verteilergruppen ein Postfach Mitglied ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste der Microsoft Exchange-Verteilergruppen, in der das Postfach mitglied ist, im JSON-Format. |
|
Anzahl der gefundenen Verteilergruppen
|
CountOfDistributionGroupsFound | integer |
Die Anzahl der Microsoft Exchange-Verteilergruppen, bei der das Postfach Mitglied ist. |
Abrufen der Office 365-Postfachverteilergruppenmitgliedschaft
Abrufen, in welchen Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen ein Office 365- oder Exchange Online-Postfach Mitglied ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
MailboxIdentity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Abzurufende Eigenschaften
|
PropertiesToRetrieveJSON | string |
Eine Liste der Elementeigenschaften, die im JSON- oder CSV-Format abgerufen werden sollen. Beispiel: ["Identity", "DistinguishedName"] (JSON-Arrayformat) oder "Identity","DistinguishedName" (CSV-Format). Allgemeine Gruppeneigenschaften sind: Alias, DisplayName, DistinguishedName, GroupType, Identity, Name, PrimarySmtpAddress und SamAcountName. Wenn Sie dieses Feld leer lassen, werden standardmäßige Eigenschaften abgerufen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste von Office 365- oder Exchange Online-Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen, in denen das Postfach mitglied ist, im JSON-Format. |
|
Anzahl der gefundenen Verteilergruppen
|
CountOfDistributionGroupsFound | integer |
Die Anzahl der Office 365- oder Exchange Online-Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen, bei denen das Postfach Mitglied ist. |
Abrufen des Domänen-FQDN der Active Directory-Domäne aus DN
Eine Hilfsfunktion. Wenn der Distinguished Name (DN) eines Active Directory-Benutzers angegeben ist, wird die Active Directory-Domäne zurückgegeben, die den Benutzer enthält.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-DN
|
DN | True | string |
Der Distinguished Name des Suchbenutzers (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local). |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Domänen-FQDN
|
DomainFQDN | string |
Die Active Directory-Domäne, die den Benutzer enthält. |
Abrufen des nächsten verfügbaren Kontonamens
Details zum Benennungsformat für Active Directory- und Exchange-Kontonamen enthalten die Details des nächsten verfügbaren Ersatzkontonamens. Wird verwendet, um zu bestimmen, welches Active Directory- und Exchange-Konto für einen bestimmten Benutzer erstellt werden soll. Diese Aktion erstellt keine Konten, es enthält Informationen zur Namensverfügbarkeit.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vorname
|
FirstName | string |
Der Vorname des Benutzers. Lassen Sie es leer, wenn der Vorname eines Benutzers nicht zum Erstellen von Kontonamen verwendet wird (selten). |
|
|
Zweiter Vorname
|
MiddleName | string |
Der zweite Name des Benutzers (optional). Lassen Sie leer, wenn der zweite Name eines Benutzers nicht zum Erstellen von Kontonamen verwendet wird. |
|
|
Nachname
|
LastName | string |
Der Letzte / Familie / Name des Benutzers. Lassen Sie es leer, wenn der Nachname eines Benutzers nicht zum Erstellen von Kontonamen verwendet wird. |
|
|
Feld A
|
FieldA | string |
Ein zusätzliches Feld, das zum Erstellen von Kontonamen verwendet wird. Lassen Sie keinen Wert leer, wenn zum Erstellen eines Kontonamens keine zusätzlichen Felder erforderlich sind. |
|
|
Feld B
|
FieldB | string |
Ein zusätzliches Feld, das zum Erstellen von Kontonamen verwendet wird. Lassen Sie keinen Wert leer, wenn zum Erstellen eines Kontonamens keine zusätzlichen Felder erforderlich sind. |
|
|
Feld C
|
FieldC | string |
Ein zusätzliches Feld, das zum Erstellen von Kontonamen verwendet wird. Lassen Sie keinen Wert leer, wenn zum Erstellen eines Kontonamens keine zusätzlichen Felder erforderlich sind. |
|
|
Feld D
|
FieldD | string |
Ein zusätzliches Feld, das zum Erstellen von Kontonamen verwendet wird. Lassen Sie keinen Wert leer, wenn zum Erstellen eines Kontonamens keine zusätzlichen Felder erforderlich sind. |
|
|
M-Anfangswert
|
VariableMStartValue | integer |
Optional können Sie den Anfangswert für die {M}-Variable festlegen, die im Eigenschaftenformat verwendet werden kann, um eine Variable darzustellen, die bei jeder Iteration zunimmt. |
|
|
N-Startwert
|
VariableNStartValue | integer |
Optional können Sie den Anfangswert für die {N}-Variable festlegen, die im Eigenschaftenformat verwendet werden kann, um eine Variable darzustellen, die bei jeder Iteration zunimmt. |
|
|
X-Anfangswert
|
VariableXStartValue | integer |
Optional können Sie den Anfangswert für die {X}-Variable festlegen, die im Eigenschaftenformat verwendet werden kann, um eine Variable darzustellen, die bei jeder Iteration zunimmt. |
|
|
Maximale Versuche
|
MaxAttempts | integer |
Die maximale Anzahl von Versuchen (unterschiedliche Werte), bevor IA-Connect versucht, ein verfügbares Konto zu finden. |
|
|
Fallback verursacht erneuten Test
|
FallbackCausesRetest | boolean |
Wenn "true" festgelegt ist: Wenn für eine Verfügbarkeitsprüfung für eine Regel ein Rückfall auf ein anderes Format erforderlich ist, werden Die Tests vom Anfang der Liste neu gestartet, um sicherzustellen, dass alle Eigenschaften dasselbe Format verwenden (z. B. primäre, primäre, primäre, primäre oder Fallback, Fallback, Fallback). Dadurch werden die Ergebnisse synchronisiert und der empfohlene Wert. Nur auf "false" festgelegt, wenn Sie genau wissen, was Sie tun. |
|
|
Liste der nicht zu verwendenden Zahlen
|
NumbersNotToUse | string |
Eine durch Trennzeichen getrennte Liste von Zahlen, die nicht für Werte von M, N oder X verwendet werden sollen. Beispiel: "13, 666". |
|
|
Zeichen, die aus Eingaben entfernt werden sollen
|
CharactersToRemoveFromInputs | string |
Eine Zeichenfolge mit allen Zeichen, die Sie aus den Eingaben entfernen möchten (z. B. wenn der Name eines Benutzers ungültige Zeichen enthält). Beispiel: !@&?^*. |
|
|
Diakritische Zeichen aus Eingaben entfernen
|
RemoveDiacriticsFromInputs | boolean |
Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, alle diakritischen Zeichen aus den Eingabefeldern zu entfernen, wobei Zeichen durch ein diakritisches Zeichen ohne das diakritische Zeichen ersetzt werden. Beispiel: Ersetzen von "akut akzentiert a" durch "a". In Szenarien, in denen keine direkte Zuordnung zu einem einfachen Zeichen vorhanden ist, wird das Zeichen entfernt. Beispiel: Der deutsche scharfe S wird entfernt. |
|
|
Entfernen nicht alphanumerischer Elemente aus Eingaben
|
RemoveNonAlphaNumericFromInputs | boolean |
Wenn dieser Wert auf "true" festgelegt ist, entfernt IA-Connect alle nicht alphanumerischen Zeichen aus den Eingabefeldern. |
|
|
Sequenz A1
|
SequenceA1 | string |
Eine durch Trennzeichen getrennte Liste von Zeichenfolgen, die für die {A1}-Variable verwendet werden kann, die im Eigenschaftenformat verwendet werden kann, um einen Wert darzustellen, der sich bei jedem Versuch ändert, ein verfügbares Konto zu finden. Beispiel: Wenn Sie "A,B,C,D,E,F" für diesen Wert angeben, überprüft das Format "{FirstName}{A1}" die Verfügbarkeit von {FirstName}A gefolgt von {FirstName}B usw. |
|
|
Eigentum
|
PropertyToCheck | string |
Welche Kontoeigenschaft auf Verfügbarkeit überprüft werden soll |
|
|
Format
|
PropertyNameFormat | string |
Das Format für den Wert dieser Eigenschaft. Beispiel: {FirstName}. {LastName} oder {FirstName first 1}. {Nachname} |
|
|
Format-Fallback
|
PropertyNameFallbackFormat | string |
Das Fallbackformat für den Wert dieser Eigenschaft, wenn der Wert bereits verwendet wird. Beispiel: {FirstName}. {Nachname}{NN} oder {FirstName first 1}. {Nachname}{NN} |
|
|
Zweiten Fallback formatieren
|
PropertyNameFallbackFormat2 | string |
Das zweite Fallbackformat für den Wert dieser Eigenschaft, wenn der Wert und der erste Fallback bereits übernommen werden. Beispiel: {FirstName}. {Nachname}{NN} oder {FirstName first 1}. {Nachname}{NN} |
|
|
Maximale Länge des Werts
|
PropertyNameMaxLength | integer |
Die maximale Länge für den Wert dieses Felds, bevor etwas ausgeschnitten werden muss |
|
|
Feld, das abgeschnitten werden soll, wenn die maximale Länge
|
PropertyNameMaxLengthFieldToCut | string |
Wenn die maximale Länge für den Wert dieses Felds überschritten wird, sollte die Eingabe ausgeschnitten werden. Beispiel: Wählen Sie "Nachname" aus, wenn Sie aus dem Nachnamen /Familiennamen /Nachnamen ausschneiden möchten, um den Eigenschaftswert zu kürzen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD User SAMAccountName
|
ActiveDirectorySAMAccountName | string |
Der verfügbare Active Directory-Benutzer SAMAccountName (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
AD-Benutzerkontoname
|
ActiveDirectoryAccountName | string |
Der verfügbare Active Directory-Benutzerkontoname (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
AD-Benutzerprinzipalname
|
ActiveDirectoryUPN | string |
Der verfügbare Active Directory-Benutzerprinzipalname (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
AD-Benutzer-E-Mail-Adresse
|
ActiveDirectoryEmailAddress | string |
Die verfügbare Active Directory-E-Mail-Adresse (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
E-Mail-Adresse des Exchange-Postfachs
|
ExchangeMailboxAddress | string |
Die verfügbare Exchange-E-Mail-Postfachadresse (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
Exchange-Postfachalias
|
ExchangeMailboxAlias | string |
Der verfügbare Exchange-Postfachalias (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
Exchange-Remotepostfachadresse
|
ExchangeRemoteMailboxAddress | string |
Die verfügbare Exchange-Remotepostfachadresse (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
Azure AD-Benutzerprinzipalname
|
AzureADUPN | string |
Der verfügbare Azure Active Directory-Benutzerprinzipalname (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
Office 365-Benutzerprinzipalname
|
Office365UPN | string |
Der verfügbare Office 365-Benutzerprinzipalname (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
E-Mail-Adresse des Office 365-Postfachs
|
Office365MailboxEmailAddress | string |
Die verfügbare Office 365-E-Mail-Postfachadresse (wenn es sich um eine der Eigenschaften handelte, die auf Verfügbarkeit überprüft werden sollen). |
|
M-Endwert
|
MValue | integer |
Der endgültige Wert der Variablen M, wenn sie verwendet wurde. |
|
N Endwert
|
NValue | integer |
Der endgültige Wert der Variablen N, wenn sie verwendet wurde. |
|
X-Endwert
|
XValue | integer |
Der endgültige Wert der Variablen X, wenn sie verwendet wurde. |
|
Verwendeter Formatindex
|
FormatIndexUsed | integer |
Der Index des Formats, das zum Abgleichen von Eigenschaften verwendet wurde. 1 = Primäres Format, 2 = Fallbackformat, 3 = Zweites Fallbackformat. Auf diese Weise erfahren Sie, ob Das ursprüngliche Format zu einem verfügbaren Konto führte oder ob IA-Connect auf ein anderes bereitgestelltes Format zurückgreifen musste. |
Abrufen einer Microsoft Exchange Online-Postfach-E-Mail-Adressen
Ruft eine Liste aller E-Mail-Adressen ab, die einem vorhandenen Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) zugewiesen sind. Dazu gehören die primäre SMTP-Adresse, Proxy-E-Mail-Adressen, X.400-Adressen und EUM-Adressen (Exchange Unified Messaging). Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfachs). Sie können ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) nach Active Directory-Objekt-ID, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, E-Mail-Adresse, GUID oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Postfach-E-Mail-Adressen
|
MailboxEmailAddresses | array of string |
Die E-Mail-Adressen des Postfachs. Die primäre SMTP-E-Mail-Adresse wird als SMTP:emailaddress, sekundäre (Proxy)-SMTP-E-Mail-Adressen als smtp:emailaddress angezeigt, X.400-E-Mail-Adressen werden als x400:address und Exchange Unified Messaging (EUM)-Adressen als "eum:address" angezeigt. |
Abrufen einer Microsoft Exchange-Postfach-E-Mail-Adressen
Ruft eine Liste aller E-Mail-Adressen ab, die einem Microsoft Exchange-Postfach zugewiesen sind. Dazu gehören die primäre SMTP-Adresse, Proxy-E-Mail-Adressen, X.400-Adressen und EUM-Adressen (Exchange Unified Messaging).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Postfach-E-Mail-Adressen
|
MailboxEmailAddresses | array of string |
Die E-Mail-Adressen des Postfachs. Die primäre SMTP-E-Mail-Adresse wird als SMTP:emailaddress, sekundäre (Proxy)-SMTP-E-Mail-Adressen als smtp:emailaddress angezeigt, X.400-E-Mail-Adressen werden als x400:address und Exchange Unified Messaging (EUM)-Adressen als "eum:address" angezeigt. |
Abrufen einer Office 365-Verteilergruppe
Gibt die Eigenschaften der angegebenen Microsoft Exchange Online- oder Office 365-Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen zurück. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | string |
Die Identität der Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Verteilergruppen gefiltert werden sollen. Allgemeine Eigenschaftennamen sind: DisplayName, Name, GroupType, PrimarySMTPAddress. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Wert der Filtereigenschaft "JohnDoe" lauten). |
|
|
Ist kein Ergebnis eine Ausnahme
|
NoResultIsAnException | boolean |
Legen Sie "true" fest, um eine Ausnahme auszuheben, wenn keine Verteilergruppen gefunden werden. Legen Sie "false" fest, um einfach die Anzahl 0 zu melden, wenn keine Verteilergruppen gefunden werden. Beachten Sie, dass die Option "false" möglicherweise nicht funktioniert, wenn sie in nicht englischen Sprachen mit Identität verwendet wird, sodass Sie stattdessen die Suche mithilfe von Filtern in Betracht ziehen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Anzahl der gefundenen Gruppen
|
CountOfGroupsFound | integer |
Die Anzahl der Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen, die der Suchidentität entsprechen. Normalerweise 1. |
Abrufen eines Office 365-Postfachs
Gibt die Eigenschaften des angegebenen Microsoft Exchange Online- oder Office 365-Postfachs zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Postfächer gefiltert werden sollen. Allgemeine Eigenschaftennamen sind: Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Wert der Filtereigenschaft "JohnDoe" lauten). |
|
|
Empfängertypdetails
|
RecipientTypeDetails | string |
Der Typ des postfachs, nach dem gesucht werden soll. Wenn dieses Feld leer bleibt, werden alle Postfachtypen in die Suche einbezogen. |
|
|
Ist kein Ergebnis eine Ausnahme
|
NoResultIsAnException | boolean |
Legen Sie "true" fest, um eine Ausnahme auszuheben, wenn keine Postfächer gefunden werden. Legen Sie "false" fest, um einfach die Anzahl 0 zu melden, wenn keine Postfächer gefunden werden. Beachten Sie, dass die Option "false" möglicherweise nicht funktioniert, wenn sie in nicht englischen Sprachen mit Identität verwendet wird, sodass Sie stattdessen die Suche mithilfe von Filtern in Betracht ziehen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste der Postfächer (und deren Eigenschaften), die der Suchidentität im JSON-Format entsprechen. |
|
Anzahl der gefundenen Postfächer
|
CountOfMailboxesFound | integer |
Die Anzahl der Gefundenen, die der Suchidentität entsprechen. Normalerweise 1. |
Abrufen von Active Directory-Domäneninformationen
Ruft Informationen zu einer Active Directory-Domäne ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), an den die Domänenanforderung gesendet werden soll. Der Domänencontroller ruft dann die angeforderten Informationen für die angegebene Domäne ab. |
|
|
Vordefinierte Domänenidentität
|
PredefinedIdentity | string |
Benutzer: Informationen werden für die Domäne abgerufen, zu der der aktuell angemeldete Benutzer gehört. Computer: Informationen werden für die Domäne abgerufen, zu der der Computer gehört (auf dem die IA-Connect Sitzung ausgeführt wird). Manuell: Geben Sie die Active Directory-Domäne in das Feld "Domänenidentität" ein. Wenn dieses Feld leer ist und das Feld "Domänenidentität" einen Wert aufweist, wird dieser Wert verwendet. |
|
|
Domänenidentität
|
Identity | string |
Dieses Feld wird nur verwendet, wenn die "Vordefinierte Domänenidentität" auf "Manuell" (oder leer) festgelegt ist. Die Identität einer Active Directory-Domäne zum Abrufen von Domäneninformationen. Sie können eine Active Directory-Domäne durch Distinguished Name (z. B. DC=mydomain,DC=local), GUID, SID, DNS-Domänenname (z. B. mydomain.local) oder NetBIOS-Name (z. B. MYDOMAIN) angeben. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Distinguished Name
|
DistinguishedName | string |
Der Distinguished Name (DN) der Domäne. |
|
DNS-Stammname
|
DNSRoot | string |
Der Name des DNS-Stamms der obersten Ebene der Domäne. |
|
Domänenmodus
|
DomainMode | string |
Der Modus oder die Ebene der Domäne (z. B. Windows2003Domain oder Windows2016Domain). |
|
Domänen-SID
|
DomainSID | string |
Die Sicherheits-ID (SID) der Domäne. |
|
Gesamtstruktur
|
Forest | string |
Der Name der Active Directory-Gesamtstruktur (der am häufigsten logische Container). |
|
Infrastrukturmaster
|
InfrastructureMaster | string |
Der Name des Domänencontrollers (DC) mit der Infrastrukturmasterrolle. |
|
Domain NetBIOS name
|
NetBIOSName | string |
Der NetBIOS-Name der Domäne (z. B. MYDOMAIN). |
|
Domänen-GUID
|
ObjectGUID | string |
Die GUID der Domäne. |
|
PDC-Emulator
|
PDCEmulator | string |
Der Name des Domänencontrollers (DC) mit der PDC-Emulatorrolle. |
|
RID-Master
|
RIDMaster | string |
Der Name des Domänencontrollers (DC) mit der RID-Masterrolle. |
Abrufen von Active Directory-Gruppenmitgliedern
Gibt eine Liste der Mitglieder einer Active Directory-Gruppe zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenidentität
|
GroupIdentity | True | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
Rekursiv
|
Recursive | boolean |
Bei Festlegung auf "false" (Standardeinstellung) werden nur direkte Mitglieder der Gruppe zurückgegeben. Wenn dieser Wert auf "true" festgelegt ist, werden direkte Mitglieder und Mitglieder von Mitgliedern zurückgegeben, wobei im Wesentlichen alle AD-Mitglieder auf allen Ebenen zurückgegeben werden. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON der Gruppenmitglieder
|
GroupMembersJSON | string |
Die Liste der AD-Gruppenmitglieder im JSON-Format. |
|
Anzahl der gefundenen Gruppenmitglieder
|
CountOfGroupMembersFound | integer |
Die Anzahl der AD-Gruppenmitglieder. |
Abrufen von Azure AD-Benutzerlizenzdienstplänen
Ruft eine Liste der Lizenzenpläne ab, die einer angegebenen Azure AD-Benutzerlizenz (SKU) zugewiesen sind. Beispiel: Wenn dem Benutzer die FLOW_FREE Lizenz zugewiesen ist, können Sie dadurch anzeigen, welche Dienstpläne er für diese Lizenz bereitgestellt hat. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Lizenz-SKU-Teilenummer
|
LicenseSKUPartNumber | True | string |
Die Teilnummer der Lizenz-SKU. Beispiel: FLOW_FREE oder SPE_E3. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON-Json für SKU-Dienstpläne für Benutzerlizenzen
|
UserLicenseSKUServicePlansJSONOutput | string |
Die Liste der Dienstpläne, die der angegebenen Azure AD-Lizenz-SKU zugewiesen sind, die dem Benutzer im JSON-Format zugewiesen ist. |
|
Anzahl der gefundenen Lizenz-SKU-Dienstpläne
|
CountOfUserLicenseSKUServicePlansFound | integer |
Die Anzahl der Azure AD-Dienstpläne, die der angegebenen Lizenz-SKU zugewiesen sind, die dem Benutzer zugewiesen ist. |
Abrufen von Azure AD-Benutzerlizenzen
Ruft eine Liste der Lizenzen (SKU) ab, die einem Azure AD-Benutzer zugewiesen sind. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
SKU-JSON der Benutzerlizenz
|
UserLicenseSKUJSONOutput | string |
Die Liste der Azure AD-Lizenz-SKUs, die dem Benutzer zugewiesen sind, im JSON-Format. |
|
Anzahl der gefundenen Benutzerlizenz-SKUs
|
CountOfUserLicenseSKUsFound | integer |
Die Anzahl der Azure AD-Lizenz-SKUs, die dem Benutzer zugewiesen sind. |
Abrufen von Azure AD-Benutzern
Gibt die Details von Benutzern in Azure Active Directory zurück (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Sie können nach Objekt-ID oder mithilfe eines Filters suchen. Eine Objekt-ID-Suche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | string |
Die Objekt-ID eines Azure Active Directory-Benutzers, nach dem gesucht werden soll. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach benutzerobjekt-ID den Namen der Eigenschaft an, nach der die Benutzer gefiltert werden sollen. Allgemeine Eigenschaftsnamen sind: UserPrincipalName und DisplayName. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Benutzerobjekt-ID suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "UserPrincipalName" lautet, kann der Vergleich gleich oder "beginnt mit" sein). Wenn Sie einen unformatierten Filter (im ODATA 3-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Benutzerobjekt-ID suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "UserPrincipalName" lautet, kann der Wert der Filtereigenschaft "JohnDoe@mydomain.com'" lauten). |
|
|
Ist kein Ergebnis eine Ausnahme
|
NoResultIsAnException | boolean |
Legen Sie "true" fest, um eine Ausnahme auszuheben, wenn keine Benutzer gefunden werden. Legen Sie "false" fest, um einfach die Anzahl 0 zu melden, wenn keine Postfächer gefunden werden. Beachten Sie, dass die Option "false" möglicherweise nicht funktioniert, wenn sie in nicht englischen Sprachen mit Identität verwendet wird, sodass Sie stattdessen die Suche mithilfe von Filtern in Betracht ziehen. |
|
|
Zurückzugebende Eigenschaften
|
PropertiesToReturn | string |
Eine durch Trennzeichen getrennte Liste von Benutzereigenschaften, die zurückgegeben werden sollen (abrufen). Allgemeine Eigenschaften sind: AccountEnabled, City, CompanyName, Country, Department, DisplayName, GivenName, JobTitle, PostalCode, State, StreetAddress, Surname, UserPrincipalName. Wenn Sie dieses Feld leer lassen, werden standardmäßige Eigenschaften abgerufen. Wenn Sie abzurufende Eigenschaften angeben, werden nur diese Eigenschaften abgerufen. Hat keine Auswirkung, wenn Sie die PowerShell-Module von Azure AD v2 verwenden. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste der Benutzer, die dem Suchfilter im JSON-Format entsprechen. |
|
Anzahl der gefundenen Benutzer
|
CountOfUsersFound | integer |
Die Anzahl der Gefundenen, die der Suchobjekt-ID, dem UPN oder dem Filter entsprechen. |
Abrufen von Azure AD-Gruppen
Gibt die Details von Gruppen in Azure Active Directory zurück (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Sie können nach Objekt-ID oder mithilfe eines Filters suchen. Eine Objekt-ID-Suche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Group-Objekt-ID
|
ObjectId | string |
Die Objekt-ID einer Azure Active Directory-Gruppe, nach der gesucht werden soll. Sie können eine Gruppe nach Anzeigename (z. B. "Finanzbenutzer") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Gruppenobjekt-ID den Namen der Eigenschaft an, nach der die Gruppen gefiltert werden sollen. Allgemeine Gruppeneigenschaftennamen sind: Beschreibung, DisplayName und Mail. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn sie nach Filter als Alternative zur Suche nach Gruppenobjekt-ID suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft 'DisplayName' lautet, kann der Vergleich gleich' oder 'beginnt mit' sein). Wenn Sie einen unformatierten Filter (im ODATA 3-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Gruppenobjekt-ID suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B. wenn der Name der Filtereigenschaft "DisplayName" lautet, kann der Wert der Filtereigenschaft "London users" lauten). |
|
|
Ist kein Ergebnis eine Ausnahme
|
NoResultIsAnException | boolean |
Legen Sie "true" fest, um eine Ausnahme auszuheben, wenn keine Gruppen gefunden werden. Legen Sie "false" fest, um einfach die Anzahl 0 zu melden, wenn keine Gruppen gefunden werden. Beachten Sie, dass die Option "false" möglicherweise nicht funktioniert, wenn sie in nicht englischen Sprachen mit Identität verwendet wird, sodass Sie stattdessen die Suche mithilfe von Filtern in Betracht ziehen. |
|
|
Zurückzugebende Eigenschaften
|
PropertiesToReturn | string |
Eine durch Trennzeichen getrennte Liste (CSV) aller Gruppeneigenschaften, die zurückgegeben werden sollen (abrufen). Wenn leer (Standardeinstellung), gibt IA-Connect einen Standardsatz allgemeiner Gruppeneigenschaften zurück. Wenn Sie die PowerShell-Module von Microsoft Graph-Benutzern verwenden, können Sie mit der Eingabe die zurückgegebenen Eigenschaften einschränken oder zusätzliche Eigenschaften zurückgeben. Wenn Sie Azure AD v2 verwenden, können Sie mit der Eingabe nur die zurückgegebenen Eigenschaften einschränken. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste von Gruppen, die der Suchobjekt-ID oder dem Filter im JSON-Format entsprechen. |
|
Anzahl der gefundenen Gruppen
|
CountOfGroupsFound | integer |
Die Anzahl der gefundenen Gruppen, die der Suchobjekt-ID oder dem Suchfilter entsprechen. |
Abrufen von Azure AD-Gruppenmitgliedern
Gibt eine Liste der Mitglieder einer Azure Active Directory-Gruppe zurück. Mitglieder können Benutzer, Gruppen, Geräte oder Dienstprinzipale /Unternehmensanwendungen sein. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenobjekt-ID oder UPN
|
GroupObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Zurückzugebende Eigenschaften
|
PropertiesToReturn | string |
Eine durch Trennzeichen getrennte Liste (CSV) aller Elementeigenschaften, die zurückgegeben werden sollen (abrufen). Wenn leer (Standardeinstellung), gibt IA-Connect AccountEnabled, DirSyncEnabled, DisplayName, Mail, Mail, MailNickName, ObjectId, ObjectType, SecurityEnabled, UserPrincipalName zurück. Geben Sie * ein, um alle Eigenschaften zu empfangen. |
|
|
Elementobjekttypen, die zurückgegeben werden sollen
|
MemberObjectTypesToReturn | string |
Eine durch Trennzeichen getrennte Liste (CSV) aller Elementobjekttypen, die zurückgegeben werden sollen (abrufen). Wenn leer (Standardeinstellung) gibt IA-Connect alle Elementobjekttypen zurück, die eine oder mehrere der folgenden Typen sein können: Benutzer,Gruppe,Gerät,ServicePrincipal. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON der Gruppenmitglieder
|
PowerShellJSONOutput | string |
Die Liste der AD-Gruppenmitglieder im JSON-Format. |
|
Anzahl der gefundenen Gruppenmitglieder
|
CountOfGroupMembersFound | integer |
Die Anzahl der Azure AD-Gruppenmitglieder. |
Abrufen von Azure AD-Lizenz-SKUs
Gibt eine Liste der Azure Active Directory-Lizenz-Lagerhaltungseinheiten (Stock Keeping Units, SKUs) zurück, die das verbundene Azure AD abonniert hat. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Expand-Eigenschaft
|
ExpandProperty | string |
Eine optionale Lizenzeigenschaft, die erweitert und in die Ausgabe aufgenommen werden soll. Wenn Sie "PrepaidUnits" erweitern, werden Lizenzinformationen einschließlich der Gesamtzahl der aktivierten Lizenzen in die Ausgabe einbezogen. Wenn Sie "ServicePlans" erweitern, wird jeder einzelne Serviceplan innerhalb einer Sku als separates Ausgabezeilenelement zurückgegeben. Sie können jeweils nur eine Eigenschaft erweitern. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Lizenz-SKU-JSON
|
LicenseSKUJSONOutput | string |
Die Liste der abonnierten Aktienhaltungseinheiten im JSON-Format. |
|
Anzahl der gefundenen SKUs
|
CountOfSKUsFound | integer |
Die Anzahl der abonnierten Azure AD Stock Keeping Units (SKUs). |
Abrufen von Microsoft Exchange Online-Postfachdetails
Gibt die Eigenschaften des angegebenen Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfach) zurück. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | string |
Die Identität des Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfachs). Sie können ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) nach Active Directory-Objekt-ID, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, E-Mail-Adresse, GUID oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Postfächer gefiltert werden sollen. Allgemeine Eigenschaftennamen sind: Name, Alias, PrimarySMTPAddress, DisplayName. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Wert der Filtereigenschaft "JohnDoe" lauten). |
|
|
Ist kein Ergebnis eine Ausnahme
|
NoResultIsAnException | boolean |
Legen Sie "true" fest, um eine Ausnahme auszuheben, wenn keine Postfächer gefunden werden. Legen Sie "false" fest, um einfach die Anzahl 0 zu melden, wenn keine Postfächer gefunden werden. Beachten Sie, dass die Option "false" möglicherweise nicht funktioniert, wenn sie in nicht englischen Sprachen mit Identität verwendet wird, sodass Sie stattdessen die Suche mithilfe von Filtern in Betracht ziehen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste der Microsoft Exchange Online- oder Office 365-Postfächer (und deren angeforderte Eigenschaften), die der Suchidentität im JSON-Format entsprechen. |
|
Anzahl der gefundenen Postfächer
|
CountOfMailboxesFound | integer |
Die Anzahl der Microsoft Exchange Online- oder Office 365-Postfächer, die mit der Suchidentität oder dem Suchfilter übereinstimmen. Normalerweise 1. |
Abrufen von Microsoft Exchange-Postfachdetails
Gibt die Eigenschaften des angegebenen Exchange-Postfachs zurück. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Postfächer gefiltert werden sollen. Allgemeine Eigenschaftennamen sind: Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Wert der Filtereigenschaft "JohnDoe" lauten). |
|
|
Empfängertypdetails
|
RecipientTypeDetails | string |
Der Typ des postfachs, nach dem gesucht werden soll. Wenn dieses Feld leer bleibt, werden alle Postfachtypen in die Suche einbezogen. |
|
|
Ist kein Ergebnis eine Ausnahme
|
NoResultIsAnException | boolean |
Legen Sie "true" fest, um eine Ausnahme auszuheben, wenn keine Postfächer gefunden werden. Legen Sie "false" fest, um einfach die Anzahl 0 zu melden, wenn keine Postfächer gefunden werden. Beachten Sie, dass die Option "false" möglicherweise nicht funktioniert, wenn sie in nicht englischen Sprachen mit Identität verwendet wird, sodass Sie stattdessen die Suche mithilfe von Filtern in Betracht ziehen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste der Exchange-Postfächer (und deren angeforderte Eigenschaften), die der Suchidentität im JSON-Format entsprechen. |
|
Anzahl der gefundenen Postfächer
|
CountOfMailboxesFound | integer |
Die Anzahl der Exchange-Postfächer, die mit der Suchidentität oder dem Suchfilter übereinstimmen. 1 Ergebnis wird erwartet, wenn nach Identität gesucht wird. 0 oder mehr Ergebnisse werden erwartet, wenn nach Filter gesucht wird. |
Abrufen von Microsoft Exchange-Verteilergruppendetails
Rufen Sie die Details einer Microsoft Exchange-Verteilergruppe ab. Sie können nach Identität suchen oder einen Filter verwenden. Eine Identitätssuche sollte 0 oder 1 Ergebnisse zurückgeben. Eine Filtersuche kann 0 oder mehr Ergebnisse zurückgeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | string |
Die Identität der zu suchden Verteilergruppe. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Verteilergruppen gefiltert werden sollen. Allgemeine Eigenschaftennamen sind: DisplayName, Name, GroupType, PrimarySMTPAddress. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Wert der Filtereigenschaft "JohnDoe" lauten). |
|
|
Ist kein Ergebnis eine Ausnahme
|
NoResultIsAnException | boolean |
Legen Sie "true" fest, um eine Ausnahme auszuheben, wenn keine Verteilergruppen gefunden werden. Legen Sie "false" fest, um einfach die Anzahl 0 zu melden, wenn keine Verteilergruppen gefunden werden. Beachten Sie, dass die Option "false" möglicherweise nicht funktioniert, wenn sie in nicht englischen Sprachen mit Identität verwendet wird, sodass Sie stattdessen die Suche mithilfe von Filtern in Betracht ziehen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste der Microsoft Exchange-Verteilergruppen, die der Suchidentität oder dem Suchfilter im JSON-Format entsprechen. |
|
Anzahl der gefundenen Verteilergruppen
|
CountOfDistributionGroupsFound | integer |
Die Anzahl der Microsoft Exchange-Verteilergruppen, die mit der Suchidentität oder dem Suchfilter übereinstimmen. Normalerweise 1. |
Abrufen von Microsoft Exchange-Verteilergruppenmitgliedern
Dient zum Abrufen einer Liste der Mitglieder einer Microsoft Exchange-Verteilergruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | True | string |
Die Identität der zu suchden Verteilergruppe. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Verteilergruppenmitglieder
|
DistributionGroupMembersJSON | string |
Eine Liste der Mitglieder der Exchange-Verteilergruppe im JSON-Format. |
|
Anzahl der Verteilergruppenmitglieder
|
CountOfDistributionGroupsMembers | integer |
Die Anzahl der Mitglieder der Microsoft Exchange-Verteilergruppe. |
Abrufen von Office 365-Verteilergruppenmitgliedern
Dient zum Abrufen einer Liste der Mitglieder einer Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
GroupIdentity | True | string |
Die Identität der zu suchden Verteilergruppe. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Abzurufende Eigenschaften
|
PropertiesToRetrieveJSON | string |
Eine Liste der Elementeigenschaften, die im JSON- oder CSV-Format abgerufen werden sollen. Beispiel: ["Identity", "DistinguishedName"] (JSON-Arrayformat) oder "Identity","DistinguishedName" (CSV-Format). Allgemeine Membereigenschaften sind: Alias, DisplayName, DistinguishedName, Identity, Name, PrimarySMTPAddress, RecipientType und SamAccountName. Wenn Sie dieses Feld leer lassen, werden standardmäßige Eigenschaften abgerufen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Verteilergruppenmitglieder
|
O365DistributionGroupMembersJSON | string |
Eine Liste der Mitglieder der Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe im JSON-Format. |
|
Anzahl der Verteilergruppenmitglieder
|
O365CountOfDistributionGroupsMembers | integer |
Die Anzahl der Mitglieder der Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe. |
Abrufen von Rollenzuweisungen für Azure AD-Benutzeradministratoren
Gibt eine Liste der Azure Active Directory-Administratorrollen zurück, denen der angegebene Benutzer zugewiesen ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Abrufen von Administratorrollennamen
|
RetrieveAdminRoleNames | boolean |
Wenn dieser Wert auf "true" festgelegt ist, ruft der IA-Connect Agent zusätzlich zu den Rollen-IDs die Namen jeder Rolle ab. Dies dauert länger, bietet aber besser lesbare Informationen. Wenn dieser Wert auf "false" festgelegt ist, ruft der IA-Connect Agent keine Rollennamen ab. |
|
|
Zurückgeben von Zuordnungs-IDs
|
ReturnAssignmentIds | boolean |
Wenn dieser Wert auf "true" festgelegt ist, ruft der IA-Connect Agent die Zuordnungs-IDs für jede Rollenzuweisung ab. Zuordnungs-IDs sind nur erforderlich, wenn Sie einige benutzerdefinierte Aktionen für die Rollenzuweisung ausführen möchten (anstatt integrierte IA-Connect Aktionen zu verwenden). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Rollenzuweisungen
|
PowerShellJSONOutput | string |
Die Liste der Azure AD-Administratorrollen, denen der Benutzer im JSON-Format zugewiesen ist. |
|
Anzahl der gefundenen Rollenzuweisungen
|
CountOfRoleAssignmentsFound | integer |
Die Anzahl der Azure AD-Administratorrollen, denen der Benutzer zugewiesen ist. |
Active Directory-Benutzer abrufen
Gibt die Eigenschaften eines angegebenen Active Directory-Benutzers zurück. Sie können entweder nach Identität (um einen einzelnen Benutzer zu finden) oder einen Filter verwenden (um einen oder mehrere Benutzer zu finden).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Identität
|
Identity | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Benutzer gefiltert werden sollen. Allgemeine Eigenschaftsnamen sind: Stadt, Unternehmen, Land, Abteilung, Beschreibung, Anzeigename, Division, E-Mail-Adresse, aktiviert, Vorname, HomeDirectory, Homedrive, Homephone, Initialen, Manager, Office, Organisation, Postleitzahl, Profilpfad, samaccountname, Scriptpath, State, Streetaddress, Nachname, Titel, Benutzerprincipalname. Wenn Sie die Eingabe "Filtereigenschaftsvergleich" auf "Raw" oder LDAP festlegen, können Sie diese Eingabe leer lassen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. Wenn Sie einen LDAP-Filter eingeben möchten, wählen Sie einen Vergleichstyp von "LDAP: LDAP-Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Als Alternative zur Suche nach Identität wird der Wert des Namens der Filtereigenschaft verwendet, nach dem die Benutzer gefiltert werden sollen. |
|
|
Such-OU-Basis
|
SearchOUBase | string |
Die Organisationseinheit der obersten Ebene (OU), unter der gesucht werden soll. Wird nur bei der Suche mit einem Filter unterstützt, nicht nach Identität. Wenn nicht angegeben, wird die gesamte Domäne durchsucht. Die Suchbasis-OU kann im Distinguished Name-Format angegeben werden (z. B. OU=London,OU=MyUsers,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyUsers\London). |
|
|
Such-OU-Basisunterstruktur
|
SearchOUBaseSubtree | boolean |
Wenn "true" (Standard) und eine Such-OU-Basis bereitgestellt wird, werden die Such-OU-Basis und alle Unter-OUs durchsucht. Wenn dieser Wert auf "false" festgelegt ist und eine Such-OU-Basis bereitgestellt wird, wird nur die Such-OU-Basis durchsucht. Diese Eingabe wird nicht verwendet, wenn keine Such-OU-Basis bereitgestellt wird oder wenn Sie nach Identität suchen. |
|
|
Abzurufende Eigenschaften
|
Properties | string |
Eine durch Trennzeichen getrennte Liste mit zusätzlichen Benutzereigenschaften, die abgerufen werden sollen. Allgemeine Eigenschaften sind: Stadt, Unternehmen, Land, Abteilung, Beschreibung, Anzeigename, Division, E-Mail-Adresse, aktiviert, Vorname, HomeDirectory, Homedrive, Homephone, Initialen, Manager, Office, Organisation, Postleitzahl, Profilpfad, samaccountname, Scriptpath, State, Streetaddress, Nachname, Titel, Benutzerprincipalname. Wenn Sie dieses Feld leer lassen, wird ein Standardsatz von Eigenschaften zurückgegeben. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Eigenschaften, die als Sammlung zurückgegeben werden sollen
|
PropertiesToReturnAsCollectionJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Namen) IA-Connect versuchen sollen, als Sammlung zurückzugeben. Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe kann im JSON- oder CSV-Format eingegeben werden. Beispiel: Geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein, um die Eigenschaften "EmailAddresses" und "MemberOf" zurückzugeben. |
|
|
Zu serialisierende Eigenschaftsnamen
|
PropertyNamesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Name) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (den Sie nach dem Empfang deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die Verwendung der alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftstypen zum Serialisieren" in Betracht ziehen (wählen Sie eine aus). Beispiel: Um die Eigenschaften EmailAddresses und MemberOf zu serialisieren, geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein. |
|
|
Zu serialisierende Eigenschaftstypen
|
PropertyTypesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Typ) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (die Sie nach Erhalt deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftsnamen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe ist eine Auflistung mit einem einzelnen 'PropertyType'-Feld. Beispiel: Geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] ein. (JSON-Tabellenformat), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-Arrayformat) oder "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV-Format). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste der Benutzer (und deren angeforderte Eigenschaften), die der Suchidentität im JSON-Format entsprechen. |
|
Anzahl der gefundenen Benutzer
|
CountOfUsersFound | integer |
Die Anzahl der Gefundenen, die der Suchidentität entsprechen. In der Regel 0 oder 1, wenn nach Identität gesucht wird, oder 0 oder mehr, wenn nach Filtereigenschaft gesucht wird. |
Active Directory-Benutzer aus allen Gruppen entfernen
Entfernt einen Active Directory-Benutzer aus allen Active Directory-Gruppen, in denen sie Mitglied sind. IA-Connect entfernt den Benutzer aus so vielen Gruppen wie möglich und berichtet über das Ergebnis. Diese Aktion funktioniert nur mit Benutzerkonten, Sie können diese Aktion nicht verwenden, um die Gruppenmitgliedschaften einer Gruppe oder eines Computers zu entfernen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | string |
Der Benutzer, der aus allen Gruppen entfernt werden soll. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
|
AD-Gruppen, die ausgeschlossen werden sollen
|
GroupsToExcludeJSON | string |
Eine Liste von AD-Gruppen, die aus der Entfernung ausgeschlossen werden sollen, im JSON- oder CSV-Format. Beispiel: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-Tabellenformat), ["Group 1", "Group 2"] (JSON-Arrayformat) oder Gruppe 1,Gruppe 2 (CSV-Format). Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
|
Ausnahme, wenn keine ausgeschlossene Gruppe vorhanden ist
|
ExceptionIfExcludedGroupDoesNotExist | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine der ausgeschlossenen Gruppen nicht vorhanden ist (IA-Connect muss die Gruppe nachschlagen, um die Gruppe DN abzurufen). Wenn dieser Wert auf "false" festgelegt ist (Standardeinstellung): Wenn eine ausgeschlossene Gruppe nicht vorhanden ist, wird sie ignoriert, da der Benutzer möglicherweise kein Mitglied dieser Gruppe sein kann. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Als Thread ausführen
|
RunAsThread | boolean |
Wenn dieser Wert auf "false" festgelegt ist, führt der IA-Connect Agent die Aktion sofort aus und gibt die Ergebnisse zurück, wenn die Aktion abgeschlossen ist, schlägt jedoch fehl, wenn das Timeout des Arbeits-/RPA-Befehls länger dauert. Wenn dieser Wert auf "true" festgelegt ist, führt der IA-Connect Agent diese Aktion als Agent-Thread aus und überwacht sie, bis er abgeschlossen ist. Dadurch kann die Aktion länger als das Timeout des Arbeits-/RPA-Befehls ausgeführt werden. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie diese Aktion zuvor als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Legen Sie diesen Wert auf 0 (Standardeinstellung) fest, wenn Sie diese Aktion einfach ausführen (und daher nicht die Ergebnisse einer vorherigen Instanz dieser Aktion abrufen, die als Agent-Thread ausgeführt wird). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Als Thread ausführen" auf "true" festgelegt ist, wie viele Sekunden warten, bis der Agentthread abgeschlossen ist. Wenn der Agent-Thread, der diese Aktion ausführt, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent führt die Aktion weiter aus, steht aber auch für die nächste Aktion zur Verfügung. Sie können die Aktionsergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis der Agent-Thread erfolgreich abgeschlossen ist" verwenden, um auf den Abschluss des Agent-Threads zu warten, und dann diese Aktion "Active Directory-Benutzer aus allen Gruppen entfernen" erneut ausführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD-Gruppen wurden erfolgreich entfernt.
|
ADGroupsRemovedSuccessfully | integer |
Die Anzahl der AD-Gruppen, aus der der Benutzer erfolgreich entfernt wurde. |
|
AD-Gruppen konnten nicht entfernt werden.
|
ADGroupsFailedToRemove | integer |
Die Anzahl der AD-Gruppen, aus denen der Benutzer nicht entfernt werden konnte. |
|
VON der Entfernung ausgeschlossene AD-Gruppen
|
ADGroupsExcludedFromRemoval | integer |
Die Anzahl der AD-Gruppen, die aus der Entfernung ausgeschlossen sind. |
|
Fehlermeldung zum Entfernen von AD-Gruppen
|
RemoveADGroupsMasterErrorMessage | string |
Wenn der Benutzer einige der AD-Gruppen nicht entfernen konnte, enthält diese Fehlermeldung Details zum Problem. |
|
Thread-ID
|
ThreadId | integer |
Wenn diese Aktion als Agentthread ausgeführt wird, enthält diese Ausgabe die Agentthread-ID, mit der die Ausführung der Aktion überwacht und die Ergebnisse abgerufen werden kann, wenn die Aktion abgeschlossen wurde. |
Active Directory-Benutzer entfernen
Entfernt einen Benutzer aus Active Directory.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Entfernen des Schutzes vor versehentlichem Löschen
|
RemoveProtectionFromAccidentalDeletion | boolean |
Legen Sie den Wert auf "true" fest, um den Schutz vor versehentlichem Löschen zu entfernen, bevor Sie versuchen, den Benutzer zu entfernen. |
|
|
Entfernen, auch wenn der Benutzer Unterobjekte hat
|
DeleteEvenIfUserHasSubObjects | boolean |
Wenn ein Benutzerkonto Unterobjekte aufweist (d. h. der Benutzer ist kein Blattobjekt), schlägt der normale Befehl zum Entfernen des Benutzers fehl. Legen Sie diese Eingabe auf "true" fest, wenn Sie auf eine alternative Löschmethode zurückgreifen möchten, wenn Unterobjekte erkannt werden. |
|
|
Rekursives Löschen erzwingen
|
ForceDeleteRecursive | boolean |
Wenn ein Benutzerkonto Unterobjekte aufweist (d. h. der Benutzer ist kein Blattobjekt), schlägt der normale Befehl zum Entfernen des Benutzers fehl. Legen Sie diese Eingabe auf "true" fest, wenn Sie ein rekursives Unterobjekt löschen möchten, ohne zuerst zu versuchen, den Benutzer normal zu entfernen. Dies kann nützlich sein, wenn die Fallbackerkennung nicht funktioniert. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryRemoveADUserByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Active Directory-Benutzergruppenmitgliedschaft abrufen
Gibt eine Liste von Active Directory-Gruppen zurück, bei der der angegebene Benutzer Mitglied ist, abzüglich der primären Gruppe (in der Regel 'Domänenbenutzer'), da es technisch keine Mitgliedschaft ist. Diese Aktion funktioniert nur mit Benutzerkonten, Sie können diese Aktion nicht verwenden, um die Gruppenmitgliedschaft von Gruppen oder Computern abzufragen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Der Benutzer, der die Gruppenmitgliedschaft abfragen soll. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON der Gruppenmitgliedschaft
|
GroupMembershipJSON | string |
Die Liste der AD-Gruppen, deren Benutzer mitglied ist, im JSON-Format. |
|
Anzahl der gefundenen Gruppen
|
CountOfGroupsFound | integer |
Die Anzahl der AD-Gruppen, bei denen der Benutzer mitglied ist, abzüglich der primären Gruppe (in der Regel "Domänenbenutzer"), die nicht gezählt wird. |
Active Directory-Benutzerkonto deaktivieren
Deaktiviert ein Active Directory-Benutzerkonto. Wenn ein Benutzerkonto deaktiviert ist, kann sich der Benutzer nicht anmelden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryDisableADUserByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Active Directory-Gruppe abrufen
Gibt die Eigenschaften einer angegebenen Active Directory-Gruppe oder -Gruppen zurück. Sie können entweder nach Identität (um eine einzelne Gruppe zu finden) oder einen Filter verwenden (um eine oder mehrere Gruppen zu finden).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Identität
|
Identity | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Gruppen gefiltert werden sollen. Allgemeine Eigenschaftennamen für eine Gruppensuche sind: Name, Beschreibung, samaccountname. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. Wenn Sie einen LDAP-Filter eingeben möchten, wählen Sie einen Vergleichstyp von "LDAP: LDAP-Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Als Alternative zur Suche nach Identität ist der Wert des Namens der Filtereigenschaft zum Filtern der Gruppen nach. |
|
|
Such-OU-Basis
|
SearchOUBase | string |
Die Organisationseinheit der obersten Ebene (OU), unter der gesucht werden soll. Wird nur bei der Suche mit einem Filter unterstützt, nicht nach Identität. Wenn nicht angegeben, wird die gesamte Domäne durchsucht. Die OU kann im Distinguished Name-Format angegeben werden (z. B. OU=London,OU=MyGroups,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyGroups\London). |
|
|
Such-OU-Basisunterstruktur
|
SearchOUBaseSubtree | boolean |
Wenn "true" (Standard) und eine Such-OU-Basis bereitgestellt wird, werden die Such-OU-Basis und alle Unter-OUs durchsucht. Wenn dieser Wert auf "false" festgelegt ist und eine Such-OU-Basis bereitgestellt wird, wird nur die Such-OU-Basis durchsucht. Diese Eingabe wird nicht verwendet, wenn keine Such-OU-Basis bereitgestellt wird oder wenn Sie nach Identität suchen. |
|
|
Auslösen einer Ausnahme, wenn die Gruppe nicht vorhanden ist
|
RaiseExceptionIfGroupDoesNotExist | boolean |
Wenn "true" festgelegt ist und die Gruppe nicht vorhanden ist, wird eine Ausnahme ausgelöst. Wenn "false" festgelegt ist und die Gruppe nicht vorhanden ist, meldet die Aktion erfolg, aber die Ausgabe meldet, dass keine Gruppen gefunden wurden. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Eine Liste von Gruppen (und deren angeforderten Eigenschaften), die der Suchidentität entsprechen. |
|
Anzahl der gefundenen Gruppen
|
CountOfGroupsFound | integer |
Die Anzahl der gefundenen Gruppen, die der Suchidentität entsprechen. Erwartete Werte sind 0 oder 1 für eine Identitätssuche oder einen beliebigen Wert für eine Filtersuche. |
Active Directory-Gruppe entfernen
Entfernt eine Gruppe aus Active Directory. Wenn in der Gruppe Objekte (z. B. Benutzer, Gruppen oder Computer) vorhanden sind, werden diese Objekte im Rahmen des Gruppenlöschvorgangs entfernt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenidentität
|
GroupIdentity | True | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
Löschen, auch wenn geschützt
|
DeleteEvenIfProtected | boolean |
Legen Sie den Wert auf "true" fest, um die Gruppe zu löschen, auch wenn sie vor dem Löschen geschützt ist. Auf "false" festlegen, um die Gruppe nur zu löschen, wenn sie nicht vor dem Löschen geschützt ist, und lösen Sie eine Ausnahme aus, wenn die Gruppe geschützt ist. |
|
|
Auslösen einer Ausnahme, wenn die Gruppe nicht vorhanden ist
|
RaiseExceptionIfGroupDoesNotExist | boolean |
Wenn "true" festgelegt ist und die Gruppe nicht vorhanden ist, wird eine Ausnahme ausgelöst. Wenn "false" festgelegt ist und die Gruppe nicht vorhanden ist, meldet die Aktion den Erfolg, aber die Ausgabe meldet, dass keine Gruppen gelöscht wurden. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der gelöschten Gruppen
|
NumberOfGroupsDeleted | integer |
Diese Ausgabe enthält die Anzahl der gelöschten AD-Gruppen, die 0 oder 1 sein sollen. |
Active Directory-Gruppenmitglied entfernen
Entfernt ein Active Directory-Mitglied (Benutzer, Gruppe oder Computer) aus einer Active Directory-Gruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenidentität
|
GroupIdentity | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
|
Gruppenname
|
GroupName | string |
Stellen Sie als Alternative zur Suche nach Identität den Vor-2K-Namen (SAMAccountName) der Active Directory-Gruppe bereit. Da die Eingabe "Gruppenidentität" auch den Vor-2K-Namen akzeptiert, ist diese Eingabe jetzt redundant, wird jedoch aus Gründen der Abwärtskompatibilität beibehalten. |
|
|
Mitglied der Gruppe
|
UserIdentity | True | string |
Das zu entfernende Gruppenmitglied. Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryRemoveADGroupMemberByGroupIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Aktivieren des Active Directory-Benutzerkontos
Aktiviert ein Active Directory-Benutzerkonto. Wenn das Konto nicht deaktiviert ist, führt dieser Befehl nichts aus.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryEnableADUserByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Aktivieren des Azure AD-Benutzers
Aktiviert einen Azure Active Directory-Benutzer. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2EnableUserResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Ausführen des Active Directory PowerShell-Skripts
Führt ein PowerShell-Skript im Active Directory-Runspace in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect-Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen ihres eigenen benutzerdefinierten Active Directory PowerShell-Codes. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
PowerShell-Skriptinhalte
|
PowerShellScriptContents | string |
Der Inhalt des PowerShell-Skripts, das im Active Directory-Runspace ausgeführt werden soll. IA-Connect führt dieses Skript as-is aus, indem es direkt an das PowerShell-Automatisierungsmodul übergeben wird. Auf dem Datenträger wird kein PowerShell-Skript erstellt. Alternativ können Sie ein vorhandenes PowerShell-Skript auf dem Datenträger ausführen, indem Sie Folgendes eingeben: return & 'scriptpath'. Beispiel: Return & 'c:\scripts\ADTestScript.ps1'. |
|
|
Ist kein Ergebnis ein Fehler
|
IsNoResultAnError | boolean |
Wenn keine Daten vom PowerShell-Befehl zurückgegeben werden, schlägt dies einen Fehler vor? |
|
|
Zurückgeben komplexer Typen
|
ReturnComplexTypes | boolean |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Die Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen", "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" ermöglichen es Ihnen, anzugeben, welche "komplexen" Eigenschaften zurückgegeben werden sollen, und die Methode, die zum Formatieren der Daten verwendet wird (wählen Sie auf Eigenschaftsbasis die am besten geeignete Eigenschaft aus). Mit dieser Eingabe können Sie angeben, was mit allen verbleibenden Eigenschaften geschehen soll (d. h. Eigenschaften, die "komplex" sind und nicht explizit benannt werden). Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, eine Zeichenfolgendarstellung der Daten mithilfe von ToString() zurückzugeben. Bei Festlegung auf "false" (Standardeinstellung) gibt IA-Connect die Eigenschaft nicht zurück. |
|
|
Boolescher Wert als boolescher Wert zurückgeben
|
ReturnBooleanAsBoolean | boolean |
Sollen boolesche Eigenschaften als Boolescher Wert zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Numerische Zahl als Dezimalzahl zurückgeben
|
ReturnNumericAsDecimal | boolean |
Sollen numerische Eigenschaften als Numerische Eigenschaften zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Rückgabedatum als Datum
|
ReturnDateAsDate | boolean |
Sollen Datumseigenschaften als Datumsangaben zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Eigenschaften, die als Sammlung zurückgegeben werden sollen
|
PropertiesToReturnAsCollectionJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Namen) IA-Connect versuchen sollen, als Sammlung zurückzugeben. Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe kann im JSON- oder CSV-Format eingegeben werden. Beispiel: Geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein, um die Eigenschaften "EmailAddresses" und "MemberOf" zurückzugeben. |
|
|
Ausführen eines Skripts als Thread
|
RunScriptAsThread | boolean |
Bei Festlegung auf "false" (Standardeinstellung) führt der IA-Connect Agent das PowerShell-Skript sofort aus und gibt die Ergebnisse nach Abschluss des Skripts an den Director zurück. Wenn ein langes oder komplexes PowerShell-Skript ausgeführt wird, kann diese Aktion ein Timeout sein. Wenn dieser Wert auf "true" festgelegt ist, führt der IA-Connect Agent das PowerShell-Skript als Agent-Thread aus, und der IA-Connect Director (oder Orchestrator, PowerShell-Modul, Blue Prism) kann den Status dieses Agent-Threads überwachen und darauf warten, dass er abgeschlossen ist. Dadurch können lange oder komplexe PowerShell-Skripts ohne Timeouts ausgeführt werden. IA-Connect Agents 9.3 und früheren Versionen können Keine PowerShell-Skripts als Agent-Thread ausführen. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie zuvor ein PowerShell-Skript als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Legen Sie auf 0 (Standardeinstellung) fest, wenn Sie einfach ein PowerShell-Skript ausführen (und daher nicht die Ergebnisse eines vorherigen PowerShell-Skripts abrufen, das als Agent-Thread ausgeführt wird). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Skript als Thread ausführen" auf "true" festgelegt ist, wie viele Sekunden warten müssen, bis der Agent-Thread abgeschlossen ist. Wenn der Agent-Thread, in dem das PowerShell-Skript ausgeführt wird, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent führt weiterhin das PowerShell-Skript aus, steht aber auch für die nächste Aktion zur Verfügung. Sie können dann die Skriptergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis agent-Thread erfolgreich abgeschlossen wurde" verwenden, um auf den Abschluss des Agent-Threads zu warten und dann diese Aktion "PowerShell-Skript ausführen" erneut auszuführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Skript enthält gespeichertes Kennwort
|
ScriptContainsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn das Skript einen IA-Connect gespeicherten Kennwortbezeichner enthält, im Format {IAConnectPassword:StoredPasswordIdentifier} oder in einem IA-Connect Orchestrator generische Anmeldeinformationen im Format {OrchestratorCredential:FriendlyName}. Der Ausdruck {} wird durch das angegebene Kennwort ersetzt, escaped und in einfache Anführungszeichen gesetzt (es sei denn, er befindet sich bereits in Anführungszeichen im Skript). |
|
|
Ausführliche Protokollausgabe
|
LogVerboseOutput | boolean |
Legen Sie "true" fest, um eine ausführliche PowerShell-Ausgabe in den IA-Connect Protokollen zu protokollieren. Dies kann für das Debuggen nützlich sein. Verwenden Sie zum ausführlichen Protokollieren in Ihrem Skript die folgende PowerShell: Write-Verbose "Meine Nachricht" -Verbose. |
|
|
Zu serialisierende Eigenschaftsnamen
|
PropertyNamesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Name) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (den Sie nach dem Empfang deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die Verwendung der alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftstypen zum Serialisieren" in Betracht ziehen (wählen Sie eine aus). Beispiel: Um die Eigenschaften EmailAddresses und MemberOf zu serialisieren, geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein. |
|
|
Zu serialisierende Eigenschaftstypen
|
PropertyTypesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Typ) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (die Sie nach Erhalt deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftsnamen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe ist eine Auflistung mit einem einzelnen 'PropertyType'-Feld. Beispiel: Geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] ein. (JSON-Tabellenformat), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-Arrayformat) oder "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV-Format). |
|
|
Name
|
Name | string |
Der Name des PowerShell-Eingabeparameters. Dies muss powerShell-Variablenbenennungsformate erfüllen (d. h. es wird empfohlen, Leerzeichen oder spezielle Symbole zu vermeiden). Bei PowerShell-Variablennamen wird die Groß-/Kleinschreibung nicht beachtet. Beispiel: MyVariable würde dazu führen, dass eine Variable $MyVariable erstellt wird. |
|
|
Zeichenfolgenwert
|
StringValue | string |
Der Zeichenfolgenwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie einen booleschen oder numerischen Wert eingeben. |
|
|
Ganzzahliger Wert
|
IntValue | integer |
Der ganzzahlige Wert (ganze Zahl), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Boolescher Wert
|
BooleanValue | boolean |
Der boolesche Wert (true oder false), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge oder einen numerischen Wert eingeben. |
|
|
Dezimalzahl
|
DecimalValue | double |
Der Dezimalwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder ganzzahligen Wert eingeben. |
|
|
Objektwert
|
ObjectValue | object |
Der Objektwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Dies wird eine serialisierte JSON-Zeichenfolgenvariable im PowerShell-Skript. Deserialisieren Sie daher ein Objekt mithilfe von ConvertFrom-Json. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
PowerShell-Ausgabe-JSON
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Thread-ID
|
ThreadId | integer |
Wenn das PowerShell-Skript als Agent-Thread ausgeführt wird, enthält diese Ausgabe die Agent-Thread-ID, mit der die Ausführung des PowerShell-Skripts überwacht und die PowerShell-Skriptergebnisse abgerufen werden können, wenn das Skript abgeschlossen ist. |
Ausführen des Azure AD PowerShell-Skripts
Führt ein PowerShell-Skript in Azure Active Directory (auch als Microsoft Entra ID, Azure AD oder AAD bezeichnet) in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen eigener benutzerdefinierter Azure AD PowerShell-Skripts. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden. Diese Aktion verwendet PowerShell-Module für Azure AD v2- oder Microsoft Graph-Benutzer.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
PowerShell-Skriptinhalte
|
PowerShellScriptContents | string |
Der Inhalt des PowerShell-Skripts, das im Azure AD v2-Runspace ausgeführt werden soll. IA-Connect führt dieses Skript as-is aus, indem es direkt an das PowerShell-Automatisierungsmodul übergeben wird. Auf dem Datenträger wird kein PowerShell-Skript erstellt. Alternativ können Sie ein vorhandenes PowerShell-Skript auf dem Datenträger ausführen, indem Sie Folgendes eingeben: return & 'scriptpath'. Beispiel: Return & 'c:\scripts\AzureADTestScript.ps1'. |
|
|
Ist kein Ergebnis ein Fehler
|
IsNoResultAnError | boolean |
Wenn keine Daten vom PowerShell-Befehl zurückgegeben werden, schlägt dies einen Fehler vor? |
|
|
Zurückgeben komplexer Typen
|
ReturnComplexTypes | boolean |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Die Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen", "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" ermöglichen es Ihnen, anzugeben, welche "komplexen" Eigenschaften zurückgegeben werden sollen, und die Methode, die zum Formatieren der Daten verwendet wird (wählen Sie auf Eigenschaftsbasis die am besten geeignete Eigenschaft aus). Mit dieser Eingabe können Sie angeben, was mit allen verbleibenden Eigenschaften geschehen soll (d. h. Eigenschaften, die "komplex" sind und nicht explizit benannt werden). Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, eine Zeichenfolgendarstellung der Daten mithilfe von ToString() zurückzugeben. Bei Festlegung auf "false" (Standardeinstellung) gibt IA-Connect die Eigenschaft nicht zurück. |
|
|
Boolescher Wert als boolescher Wert zurückgeben
|
ReturnBooleanAsBoolean | boolean |
Sollen boolesche Eigenschaften als Boolescher Wert zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Numerische Zahl als Dezimalzahl zurückgeben
|
ReturnNumericAsDecimal | boolean |
Sollen numerische Eigenschaften als Numerische Eigenschaften zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Rückgabedatum als Datum
|
ReturnDateAsDate | boolean |
Sollen Datumseigenschaften als Datumsangaben zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Eigenschaften, die als Sammlung zurückgegeben werden sollen
|
PropertiesToReturnAsCollectionJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Namen) IA-Connect versuchen sollen, als Sammlung zurückzugeben. Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe kann im JSON- oder CSV-Format eingegeben werden. Beispiel: Geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein, um die Eigenschaften "EmailAddresses" und "MemberOf" zurückzugeben. |
|
|
Ausführen eines Skripts als Thread
|
RunScriptAsThread | boolean |
Bei Festlegung auf "false" (Standardeinstellung) führt der IA-Connect Agent das PowerShell-Skript sofort aus und gibt die Ergebnisse nach Abschluss des Skripts an den Director zurück. Wenn ein langes oder komplexes PowerShell-Skript ausgeführt wird, kann diese Aktion ein Timeout sein. Wenn dieser Wert auf "true" festgelegt ist, führt der IA-Connect Agent das PowerShell-Skript als Agent-Thread aus, und der IA-Connect Director (oder Orchestrator, PowerShell-Modul, Blue Prism) kann den Status dieses Agent-Threads überwachen und darauf warten, dass er abgeschlossen ist. Dadurch können lange oder komplexe PowerShell-Skripts ohne Timeouts ausgeführt werden. IA-Connect Agents 9.3 und früheren Versionen können Keine PowerShell-Skripts als Agent-Thread ausführen. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie zuvor ein PowerShell-Skript als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Legen Sie auf 0 (Standardeinstellung) fest, wenn Sie einfach ein PowerShell-Skript ausführen (und daher nicht die Ergebnisse eines vorherigen PowerShell-Skripts abrufen, das als Agent-Thread ausgeführt wird). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Skript als Thread ausführen" auf "true" festgelegt ist, wie viele Sekunden warten müssen, bis der Agent-Thread abgeschlossen ist. Wenn der Agent-Thread, in dem das PowerShell-Skript ausgeführt wird, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent führt weiterhin das PowerShell-Skript aus, steht aber auch für die nächste Aktion zur Verfügung. Sie können dann die Skriptergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis agent-Thread erfolgreich abgeschlossen wurde" verwenden, um auf den Abschluss des Agent-Threads zu warten und dann diese Aktion "PowerShell-Skript ausführen" erneut auszuführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Skript enthält gespeichertes Kennwort
|
ScriptContainsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn das Skript einen IA-Connect gespeicherten Kennwortbezeichner enthält, im Format {IAConnectPassword:StoredPasswordIdentifier} oder in einem IA-Connect Orchestrator generische Anmeldeinformationen im Format {OrchestratorCredential:FriendlyName}. Der Ausdruck {} wird durch das angegebene Kennwort ersetzt, escaped und in einfache Anführungszeichen gesetzt (es sei denn, er befindet sich bereits in Anführungszeichen im Skript). |
|
|
Ausführliche Protokollausgabe
|
LogVerboseOutput | boolean |
Legen Sie "true" fest, um eine ausführliche PowerShell-Ausgabe in den IA-Connect Protokollen zu protokollieren. Dies kann für das Debuggen nützlich sein. Verwenden Sie zum ausführlichen Protokollieren in Ihrem Skript die folgende PowerShell: Write-Verbose "Meine Nachricht" -Verbose. |
|
|
Zu serialisierende Eigenschaftsnamen
|
PropertyNamesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Name) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (den Sie nach dem Empfang deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die Verwendung der alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftstypen zum Serialisieren" in Betracht ziehen (wählen Sie eine aus). Beispiel: Um die Eigenschaften EmailAddresses und MemberOf zu serialisieren, geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein. |
|
|
Zu serialisierende Eigenschaftstypen
|
PropertyTypesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Typ) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (die Sie nach Erhalt deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftsnamen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe ist eine Auflistung mit einem einzelnen 'PropertyType'-Feld. Beispiel: Geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] ein. (JSON-Tabellenformat), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-Arrayformat) oder "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV-Format). |
|
|
Name
|
Name | string |
Der Name des PowerShell-Eingabeparameters. Dies muss powerShell-Variablenbenennungsformate erfüllen (d. h. es wird empfohlen, Leerzeichen oder spezielle Symbole zu vermeiden). Bei PowerShell-Variablennamen wird die Groß-/Kleinschreibung nicht beachtet. Beispiel: MyVariable würde dazu führen, dass eine Variable $MyVariable erstellt wird. |
|
|
Zeichenfolgenwert
|
StringValue | string |
Der Zeichenfolgenwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie einen booleschen oder numerischen Wert eingeben. |
|
|
Ganzzahliger Wert
|
IntValue | integer |
Der ganzzahlige Wert (ganze Zahl), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Boolescher Wert
|
BooleanValue | boolean |
Der boolesche Wert (true oder false), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge oder einen numerischen Wert eingeben. |
|
|
Dezimalzahl
|
DecimalValue | double |
Der Dezimalwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder ganzzahligen Wert eingeben. |
|
|
Objektwert
|
ObjectValue | object |
Der Objektwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Dies wird eine serialisierte JSON-Zeichenfolgenvariable im PowerShell-Skript. Deserialisieren Sie daher ein Objekt mithilfe von ConvertFrom-Json. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
PowerShell-Ausgabe-JSON
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Thread-ID
|
ThreadId | integer |
Wenn das PowerShell-Skript als Agent-Thread ausgeführt wird, enthält diese Ausgabe die Agent-Thread-ID, mit der die Ausführung des PowerShell-Skripts überwacht und die PowerShell-Skriptergebnisse abgerufen werden können, wenn das Skript abgeschlossen ist. |
Ausführen eines Exchange PowerShell-Skripts
Führt ein PowerShell-Skript im Exchange-Runspace in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen Ihres eigenen benutzerdefinierten Exchange PowerShell-Codes. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
PowerShell-Skriptinhalte
|
PowerShellScriptContents | string |
Der Inhalt des PowerShell-Skripts, das im Exchange-Runspace ausgeführt werden soll. IA-Connect führt dieses Skript as-is aus, indem es direkt an das PowerShell-Automatisierungsmodul übergeben wird. Auf dem Datenträger wird kein PowerShell-Skript erstellt. Alternativ können Sie ein vorhandenes PowerShell-Skript auf dem Datenträger ausführen, indem Sie Folgendes eingeben: return & 'scriptpath'. Beispiel: Return & 'c:\scripts\ExchangeTestScript.ps1'. |
|
|
Ist kein Ergebnis ein Fehler
|
IsNoResultAnError | boolean |
Wenn keine Daten vom PowerShell-Befehl zurückgegeben werden, schlägt dies einen Fehler vor? |
|
|
Zurückgeben komplexer Typen
|
ReturnComplexTypes | boolean |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Die Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen", "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" ermöglichen es Ihnen, anzugeben, welche "komplexen" Eigenschaften zurückgegeben werden sollen, und die Methode, die zum Formatieren der Daten verwendet wird (wählen Sie auf Eigenschaftsbasis die am besten geeignete Eigenschaft aus). Mit dieser Eingabe können Sie angeben, was mit allen verbleibenden Eigenschaften geschehen soll (d. h. Eigenschaften, die "komplex" sind und nicht explizit benannt werden). Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, eine Zeichenfolgendarstellung der Daten mithilfe von ToString() zurückzugeben. Bei Festlegung auf "false" (Standardeinstellung) gibt IA-Connect die Eigenschaft nicht zurück. |
|
|
Boolescher Wert als boolescher Wert zurückgeben
|
ReturnBooleanAsBoolean | boolean |
Sollen boolesche Eigenschaften als Boolescher Wert zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Numerische Zahl als Dezimalzahl zurückgeben
|
ReturnNumericAsDecimal | boolean |
Sollen numerische Eigenschaften als Numerische Eigenschaften zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Rückgabedatum als Datum
|
ReturnDateAsDate | boolean |
Sollen Datumseigenschaften als Datumsangaben zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Eigenschaften, die als Sammlung zurückgegeben werden sollen
|
PropertiesToReturnAsCollectionJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Namen) IA-Connect versuchen sollen, als Sammlung zurückzugeben. Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe kann im JSON- oder CSV-Format eingegeben werden. Beispiel: Geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein, um die Eigenschaften "EmailAddresses" und "MemberOf" zurückzugeben. |
|
|
Ausführen eines Skripts als Thread
|
RunScriptAsThread | boolean |
Bei Festlegung auf "false" (Standardeinstellung) führt der IA-Connect Agent das PowerShell-Skript sofort aus und gibt die Ergebnisse nach Abschluss des Skripts an den Director zurück. Wenn ein langes oder komplexes PowerShell-Skript ausgeführt wird, kann diese Aktion ein Timeout sein. Wenn dieser Wert auf "true" festgelegt ist, führt der IA-Connect Agent das PowerShell-Skript als Agent-Thread aus, und der IA-Connect Director (oder Orchestrator, PowerShell-Modul, Blue Prism) kann den Status dieses Agent-Threads überwachen und darauf warten, dass er abgeschlossen ist. Dadurch können lange oder komplexe PowerShell-Skripts ohne Timeouts ausgeführt werden. IA-Connect Agents 9.3 und früheren Versionen können Keine PowerShell-Skripts als Agent-Thread ausführen. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie zuvor ein PowerShell-Skript als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Legen Sie auf 0 (Standardeinstellung) fest, wenn Sie einfach ein PowerShell-Skript ausführen (und daher nicht die Ergebnisse eines vorherigen PowerShell-Skripts abrufen, das als Agent-Thread ausgeführt wird). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Skript als Thread ausführen" auf "true" festgelegt ist, wie viele Sekunden warten müssen, bis der Agent-Thread abgeschlossen ist. Wenn der Agent-Thread, in dem das PowerShell-Skript ausgeführt wird, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent führt weiterhin das PowerShell-Skript aus, steht aber auch für die nächste Aktion zur Verfügung. Sie können dann die Skriptergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis agent-Thread erfolgreich abgeschlossen wurde" verwenden, um auf den Abschluss des Agent-Threads zu warten und dann diese Aktion "PowerShell-Skript ausführen" erneut auszuführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Skript enthält gespeichertes Kennwort
|
ScriptContainsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn das Skript einen IA-Connect gespeicherten Kennwortbezeichner enthält, im Format {IAConnectPassword:StoredPasswordIdentifier} oder in einem IA-Connect Orchestrator generische Anmeldeinformationen im Format {OrchestratorCredential:FriendlyName}. Der Ausdruck {} wird durch das angegebene Kennwort ersetzt, escaped und in einfache Anführungszeichen gesetzt (es sei denn, er befindet sich bereits in Anführungszeichen im Skript). |
|
|
Ausführliche Protokollausgabe
|
LogVerboseOutput | boolean |
Legen Sie "true" fest, um eine ausführliche PowerShell-Ausgabe in den IA-Connect Protokollen zu protokollieren. Dies kann für das Debuggen nützlich sein. Verwenden Sie zum ausführlichen Protokollieren in Ihrem Skript die folgende PowerShell: Write-Verbose "Meine Nachricht" -Verbose. |
|
|
Zu serialisierende Eigenschaftsnamen
|
PropertyNamesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Name) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (den Sie nach dem Empfang deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die Verwendung der alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftstypen zum Serialisieren" in Betracht ziehen (wählen Sie eine aus). Beispiel: Um die Eigenschaften EmailAddresses und MemberOf zu serialisieren, geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein. |
|
|
Zu serialisierende Eigenschaftstypen
|
PropertyTypesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Typ) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (die Sie nach Erhalt deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftsnamen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe ist eine Auflistung mit einem einzelnen 'PropertyType'-Feld. Beispiel: Geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] ein. (JSON-Tabellenformat), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-Arrayformat) oder "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV-Format). |
|
|
Name
|
Name | string |
Der Name des PowerShell-Eingabeparameters. Dies muss powerShell-Variablenbenennungsformate erfüllen (d. h. es wird empfohlen, Leerzeichen oder spezielle Symbole zu vermeiden). Bei PowerShell-Variablennamen wird die Groß-/Kleinschreibung nicht beachtet. Beispiel: MyVariable würde dazu führen, dass eine Variable $MyVariable erstellt wird. |
|
|
Zeichenfolgenwert
|
StringValue | string |
Der Zeichenfolgenwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie einen booleschen oder numerischen Wert eingeben. |
|
|
Ganzzahliger Wert
|
IntValue | integer |
Der ganzzahlige Wert (ganze Zahl), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Boolescher Wert
|
BooleanValue | boolean |
Der boolesche Wert (true oder false), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge oder einen numerischen Wert eingeben. |
|
|
Dezimalzahl
|
DecimalValue | double |
Der Dezimalwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder ganzzahligen Wert eingeben. |
|
|
Objektwert
|
ObjectValue | object |
Der Objektwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Dies wird eine serialisierte JSON-Zeichenfolgenvariable im PowerShell-Skript. Deserialisieren Sie daher ein Objekt mithilfe von ConvertFrom-Json. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
PowerShell-Ausgabe-JSON
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Thread-ID
|
ThreadId | integer |
Wenn das PowerShell-Skript als Agent-Thread ausgeführt wird, enthält diese Ausgabe die Agent-Thread-ID, mit der die Ausführung des PowerShell-Skripts überwacht und die PowerShell-Skriptergebnisse abgerufen werden können, wenn das Skript abgeschlossen ist. |
Ausführen eines Office 365 PowerShell-Skripts
Führt ein PowerShell-Skript im Office 365-Runspace in der Sitzung aus, in der der IA-Connect Agent ausgeführt wird, wobei der Skriptinhalt als Teil des Befehls an den IA-Connect Agent übergeben wird. Dies ist die empfohlene Aktion zum Ausführen Ihres eigenen benutzerdefinierten Office 365 Exchange Online PowerShell-Codes. Diese Aktion kann auch verwendet werden, um die Ergebnisse aus einer vorherigen Ausführung eines PowerShell-Skripts abzurufen, die als Agent-Thread ausgeführt werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
PowerShell-Skriptinhalte
|
PowerShellScriptContents | string |
Der Inhalt des PowerShell-Skripts, das im Office 365-Runspace ausgeführt werden soll. IA-Connect führt dieses Skript as-is aus, indem es direkt an das PowerShell-Automatisierungsmodul übergeben wird. Auf dem Datenträger wird kein PowerShell-Skript erstellt. Alternativ können Sie ein vorhandenes PowerShell-Skript auf dem Datenträger ausführen, indem Sie Folgendes eingeben: return & 'scriptpath'. Beispiel: Return & 'c:\scripts\O365TestScript.ps1'. |
|
|
Ist kein Ergebnis ein Fehler
|
IsNoResultAnError | boolean |
Wenn keine Daten vom PowerShell-Befehl zurückgegeben werden, schlägt dies einen Fehler vor? |
|
|
Zurückgeben komplexer Typen
|
ReturnComplexTypes | boolean |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Die Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen", "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" ermöglichen es Ihnen, anzugeben, welche "komplexen" Eigenschaften zurückgegeben werden sollen, und die Methode, die zum Formatieren der Daten verwendet wird (wählen Sie auf Eigenschaftsbasis die am besten geeignete Eigenschaft aus). Mit dieser Eingabe können Sie angeben, was mit allen verbleibenden Eigenschaften geschehen soll (d. h. Eigenschaften, die "komplex" sind und nicht explizit benannt werden). Wenn dieser Wert auf "true" festgelegt ist, versucht IA-Connect, eine Zeichenfolgendarstellung der Daten mithilfe von ToString() zurückzugeben. Bei Festlegung auf "false" (Standardeinstellung) gibt IA-Connect die Eigenschaft nicht zurück. |
|
|
Boolescher Wert als boolescher Wert zurückgeben
|
ReturnBooleanAsBoolean | boolean |
Sollen boolesche Eigenschaften als Boolescher Wert zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Numerische Zahl als Dezimalzahl zurückgeben
|
ReturnNumericAsDecimal | boolean |
Sollen numerische Eigenschaften als Numerische Eigenschaften zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Rückgabedatum als Datum
|
ReturnDateAsDate | boolean |
Sollen Datumseigenschaften als Datumsangaben zurückgegeben werden? Wenn false, werden diese als Zeichenfolgen zurückgegeben. |
|
|
Eigenschaften, die als Sammlung zurückgegeben werden sollen
|
PropertiesToReturnAsCollectionJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Namen) IA-Connect versuchen sollen, als Sammlung zurückzugeben. Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaftsnamen zum Serialisieren" und "Eigenschaftstypen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe kann im JSON- oder CSV-Format eingegeben werden. Beispiel: Geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein, um die Eigenschaften "EmailAddresses" und "MemberOf" zurückzugeben. |
|
|
Lokaler PowerShell-Bereich
|
LocalScope | boolean |
Sollte der zugrunde liegende Office 365 PowerShell-Befehl im lokalen Bereich ausgeführt werden. Standardmäßig ist dies nicht festgelegt und daher wird PowerShell auf Standardeinstellungen zurückgesetzt. |
|
|
Ausführen eines Skripts als Thread
|
RunScriptAsThread | boolean |
Bei Festlegung auf "false" (Standardeinstellung) führt der IA-Connect Agent das PowerShell-Skript sofort aus und gibt die Ergebnisse nach Abschluss des Skripts an den Director zurück. Wenn ein langes oder komplexes PowerShell-Skript ausgeführt wird, kann diese Aktion ein Timeout sein. Wenn dieser Wert auf "true" festgelegt ist, führt der IA-Connect Agent das PowerShell-Skript als Agent-Thread aus, und der IA-Connect Director (oder Orchestrator, PowerShell-Modul, Blue Prism) kann den Status dieses Agent-Threads überwachen und darauf warten, dass er abgeschlossen ist. Dadurch können lange oder komplexe PowerShell-Skripts ohne Timeouts ausgeführt werden. IA-Connect Agents 9.3 und früheren Versionen können Keine PowerShell-Skripts als Agent-Thread ausführen. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie zuvor ein PowerShell-Skript als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Legen Sie auf 0 (Standardeinstellung) fest, wenn Sie einfach ein PowerShell-Skript ausführen (und daher nicht die Ergebnisse eines vorherigen PowerShell-Skripts abrufen, das als Agent-Thread ausgeführt wird). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Skript als Thread ausführen" auf "true" festgelegt ist, wie viele Sekunden warten müssen, bis der Agent-Thread abgeschlossen ist. Wenn der Agent-Thread, in dem das PowerShell-Skript ausgeführt wird, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent führt weiterhin das PowerShell-Skript aus, steht aber auch für die nächste Aktion zur Verfügung. Sie können dann die Skriptergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis agent-Thread erfolgreich abgeschlossen wurde" verwenden, um auf den Abschluss des Agent-Threads zu warten und dann diese Aktion "PowerShell-Skript ausführen" erneut auszuführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Skript enthält gespeichertes Kennwort
|
ScriptContainsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn das Skript einen IA-Connect gespeicherten Kennwortbezeichner enthält, im Format {IAConnectPassword:StoredPasswordIdentifier} oder in einem IA-Connect Orchestrator generische Anmeldeinformationen im Format {OrchestratorCredential:FriendlyName}. Der Ausdruck {} wird durch das angegebene Kennwort ersetzt, escaped und in einfache Anführungszeichen gesetzt (es sei denn, er befindet sich bereits in Anführungszeichen im Skript). |
|
|
Ausführliche Protokollausgabe
|
LogVerboseOutput | boolean |
Legen Sie "true" fest, um eine ausführliche PowerShell-Ausgabe in den IA-Connect Protokollen zu protokollieren. Dies kann für das Debuggen nützlich sein. Verwenden Sie zum ausführlichen Protokollieren in Ihrem Skript die folgende PowerShell: Write-Verbose "Meine Nachricht" -Verbose. |
|
|
Zu serialisierende Eigenschaftsnamen
|
PropertyNamesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Name) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (den Sie nach dem Empfang deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die Verwendung der alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftstypen zum Serialisieren" in Betracht ziehen (wählen Sie eine aus). Beispiel: Um die Eigenschaften EmailAddresses und MemberOf zu serialisieren, geben Sie [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-Tabellenformat), ["EmailAddresses", "MemberOf"] (JSON-Arrayformat) oder EmailAddresses,MemberOf (CSV-Format) ein. |
|
|
Zu serialisierende Eigenschaftstypen
|
PropertyTypesToSerializeJSON | string |
Wenn die PowerShell-Rückgabedaten "komplexe" Eigenschaften (z. B. Sammlungen von Werten, Arrays, Tabellen oder Klassen) enthalten, werden diese Eigenschaften nicht standardmäßig in der IA-Connect PowerShell-Antwort zurückgegeben. Mit dieser Option können Sie angeben, welche "komplexen" Eigenschaften (nach Typ) IA-Connect als JSON serialisiert werden sollen, sodass sie als Zeichenfolgentyp zurückgegeben werden (die Sie nach Erhalt deserialisieren können). Je nach Eigenschaft, Typ und Werten sollten Sie auch die alternativen Eingaben "Eigenschaften, die als Sammlung zurückgegeben werden sollen" und "Eigenschaftsnamen zum Serialisieren" verwenden (wählen Sie eine aus). Diese Eingabe ist eine Auflistung mit einem einzelnen 'PropertyType'-Feld. Beispiel: Geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[], geben Sie [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] ein. (JSON-Tabellenformat), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-Arrayformat) oder "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV-Format). |
|
|
Name
|
Name | string |
Der Name des PowerShell-Eingabeparameters. Dies muss powerShell-Variablenbenennungsformate erfüllen (d. h. es wird empfohlen, Leerzeichen oder spezielle Symbole zu vermeiden). Bei PowerShell-Variablennamen wird die Groß-/Kleinschreibung nicht beachtet. Beispiel: MyVariable würde dazu führen, dass eine Variable $MyVariable erstellt wird. |
|
|
Zeichenfolgenwert
|
StringValue | string |
Der Zeichenfolgenwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie einen booleschen oder numerischen Wert eingeben. |
|
|
Ganzzahliger Wert
|
IntValue | integer |
Der ganzzahlige Wert (ganze Zahl), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Boolescher Wert
|
BooleanValue | boolean |
Der boolesche Wert (true oder false), der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge oder einen numerischen Wert eingeben. |
|
|
Dezimalzahl
|
DecimalValue | double |
Der Dezimalwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder ganzzahligen Wert eingeben. |
|
|
Objektwert
|
ObjectValue | object |
Der Objektwert, der dem Eingabe-PowerShell-Parameter zugewiesen werden soll. Dies wird eine serialisierte JSON-Zeichenfolgenvariable im PowerShell-Skript. Deserialisieren Sie daher ein Objekt mithilfe von ConvertFrom-Json. Alternativ können Sie die anderen Werteingaben verwenden, wenn Sie eine Zeichenfolge, einen booleschen oder numerischen Wert eingeben. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
PowerShell-Ausgabe-JSON
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Thread-ID
|
ThreadId | integer |
Wenn das PowerShell-Skript als Agent-Thread ausgeführt wird, enthält diese Ausgabe die Agent-Thread-ID, mit der die Ausführung des PowerShell-Skripts überwacht und die PowerShell-Skriptergebnisse abgerufen werden können, wenn das Skript abgeschlossen ist. |
Ausführen von Active Directory DirSync
Führt eine Synchronisation zwischen Active Directory (lokal) und Azure Active Directory (Cloud) durch. Dieser Befehl muss auf dem Server mit der Rolle "DirSync" (d. h. dem Computer, der die Synchronisation ausführt) ausgegeben werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Richtlinientyp
|
PolicyType | string |
Die Art der auszuführenden Synchronisation. Optionen sind 'Delta', um eine Synchronisierung von Änderungen seit der letzten Synchronisierung (standardoption) und 'Initial' durchzuführen, um eine vollständige Synchronisierung durchzuführen (do not do this unless you know genau what you are doing). |
|
|
Name des Computers
|
ComputerName | string |
Der Server mit der Rolle "DirSync" (d. h. der Computer, auf dem die Synchronisation ausgeführt wird). |
|
|
Max. Wiederholungsversuche
|
MaxRetryAttempts | integer |
Wenn die Verzeichnissynchronisierung einen Beschäftigt- oder Timeoutfehler empfängt, kann sie anhalten und wiederholen. Diese Eingabe gibt die maximale Anzahl von Wiederholungen an. Legen Sie auf 0 fest, um Wiederholungsversuche zu deaktivieren. Beachten Sie potenzielle IA-Connect Aktionstimeouts, wenn Sie diesen Wert zu hoch festlegen. |
|
|
Sekunden zwischen Wiederholungen
|
SecondsBetweenRetries | integer |
Wenn der Agent eine Verzeichnissynchronisierung erneut ruft, wie viele Sekunden zwischen Wiederholungen vorhanden sein sollen. Wenn dieser Wert auf einen Wert kleiner als 1 festgelegt ist, ignoriert der Agent diese Eingabe und verwendet einen Wert von 1 Sekunde. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
DirSync-Ergebnis-JSON
|
PowerShellJSONOutput | string |
Das Ergebnis des Active Directory-Synchronisierungsvorgangs im JSON-Format. |
Azure AD-Benutzer aus Gruppe entfernen
Entfernt einen Azure Active Directory-Benutzer aus einer Azure Active Directory-Gruppe. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Gruppenobjekt-ID oder Anzeigename
|
GroupObjectId | True | string |
Die ID oder der Anzeigename einer Azure Active Directory-Gruppe. Sie können eine Gruppe nach Anzeigename (z. B. "Finanzbenutzer") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Überprüfen von Benutzergruppenmitgliedschaften zuerst
|
CheckUserGroupMembershipsFirst | boolean |
Wenn dieser Wert auf "true" festgelegt ist, überprüft IA-Connect die Gruppenmitgliedschaften des Benutzers, bevor versucht wird, sie aus der Gruppe zu entfernen. Wenn der Benutzer kein Mitglied der Gruppe ist, meldet IA-Connect einfach erfolglos, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, entfernt IA-Connect den Benutzer sofort aus der Gruppe, ohne zu überprüfen, was zu einem Fehler führt, wenn sich der Benutzer nicht in der Gruppe befindet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2RemoveUserFromGroupResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Azure AD-Benutzer deaktivieren
Deaktiviert einen Azure Active Directory-Benutzer. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Widerrufen von Benutzeraktualisierungstoken
|
RevokeUserRefreshTokens | boolean |
Legen Sie "true" fest, um alle aktualisierungstoken, die für den Benutzer ausgegeben wurden, zu widerrufen, was dazu führt, dass alle geöffneten Sitzungen nicht mehr funktionieren, in der Regel innerhalb der Stunde (wenn ihre Sitzungen versuchen, ein Aktualisierungstoken zu verwenden, um die Verbindung aktiv zu halten). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2DisableUserResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Azure AD-Benutzergruppenmitgliedschaft abrufen
Gibt eine Liste von Azure Active Directory-Gruppen zurück, bei der der angegebene Benutzer Mitglied ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Zurückzugebende Eigenschaften
|
PropertiesToReturn | string |
Eine durch Trennzeichen getrennte Liste (CSV) aller Gruppeneigenschaften, die zurückgegeben werden sollen (abrufen). Wenn leer (Standardeinstellung), gibt IA-Connect alle Gruppeneigenschaften zurück. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON der Gruppenmitgliedschaft
|
PowerShellJSONOutput | string |
Die Liste der Azure AD-Gruppen, deren Benutzer mitglied ist, im JSON-Format. |
|
Anzahl der gefundenen Gruppen
|
CountOfGroupsFound | integer |
Die Anzahl der Azure AD-Gruppen, bei der der Benutzer Mitglied ist. |
Deaktivieren des Microsoft Exchange Online-Postfachs für einen Benutzer
Deaktivieren Sie ein vorhandenes Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach). Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfachs). Sie können ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) nach Active Directory-Objekt-ID, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, E-Mail-Adresse, GUID oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe der Postfachaktion deaktivieren im JSON-Format. |
Deaktivieren des Microsoft Exchange-Postfachs für einen Benutzer
Deaktivieren Sie ein vorhandenes Microsoft Exchange-Postfach.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe der Postfachaktion deaktivieren im JSON-Format. |
Entfernen aller Azure AD-Benutzerlizenzen
Entfernt alle Azure AD-Benutzerlizenzen (SKU), die einem Benutzer zugewiesen sind. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2RemoveAllAzureADUserLicenseResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Entfernen der Active Directory-OU
Entfernt eine Organisationseinheit (OU) aus Active Directory. Die OU kann nicht gelöscht werden, wenn objekte (z. B. Benutzer, Gruppen oder Computer) in der OU vorhanden sind.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
OU-Identität
|
OUIdentity | True | string |
Die Identität der Active Directory-OE. Sie können eine OU durch Distinguished Name (z. B. OU=Servers,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. London\Servers) angeben. |
|
Löschen, auch wenn geschützt
|
DeleteEvenIfProtected | boolean |
Legen Sie auf "true" fest, um die OE zu löschen, auch wenn sie vor dem Löschen geschützt ist. Legen Sie diesen Wert auf "false" fest, um die OU nur zu löschen, wenn sie nicht vor dem Löschen geschützt ist, und lösen Sie eine Ausnahme aus, wenn die OU geschützt ist. |
|
|
Auslösen einer Ausnahme, wenn ou nicht vorhanden ist
|
RaiseExceptionIfOUDoesNotExist | boolean |
Wenn "true" festgelegt ist und die OU nicht vorhanden ist, wird eine Ausnahme ausgelöst. Wenn dieser Wert auf "false" festgelegt ist und die OU nicht vorhanden ist, meldet die Aktion den Erfolg, aber die Ausgabe meldet, dass keine OUs gelöscht wurden. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Anzahl der gelöschten OUs
|
NumberOfOUsDeleted | integer |
Diese Ausgabe enthält die Anzahl der gelöschten AD-OUs, die 0 oder 1 sein sollen. |
Entfernen der Azure AD-Sicherheit oder microsoft 365-Gruppe
Entfernen Sie eine Azure Active Directory-Sicherheitsgruppe oder Eine Microsoft 365-Gruppe. Diese Aktion kann keine E-Mail-aktivierten Sicherheitsgruppen oder Verteilerlisten entfernen: Verwenden Sie stattdessen die Aktion "Office 365-Verteilergruppe entfernen". Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenobjekt-ID oder Anzeigename
|
GroupObjectId | True | string |
Die ID oder der Anzeigename einer Azure Active Directory-Gruppe. Sie können eine Gruppe nach Anzeigename (z. B. "Finanzbenutzer") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Ausnahme, wenn die Gruppe nicht vorhanden ist
|
ErrorIfGroupDoesNotExist | boolean |
Sollte eine Ausnahme auftreten, wenn die Gruppe nicht vorhanden ist? Legen Sie "false" fest, um einfach nichts zu tun, wenn die Gruppe nicht vorhanden ist (z. B. wurde sie möglicherweise bereits gelöscht). Wird auf "true" festgelegt, wenn die Gruppe nicht vorhanden ist (d. h. es wurde erwartet, dass sie vorhanden ist). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Gruppe vorhanden
|
GroupExisted | boolean |
Wenn die Gruppe vorhanden und gelöscht wurde, wird dies auf "true" festgelegt. Wenn die Gruppe nicht vorhanden war (und "Fehler, wenn die Gruppe nicht vorhanden ist" auf "false" festgelegt wurde, sodass keine Ausnahme ausgelöst wurde), wird dies auf "false" festgelegt, um Sie darüber zu informieren, dass die Gruppe nicht vorhanden war und daher IA-Connect keine Aktion ausführen musste. |
Entfernen der Microsoft Exchange-Postfachberechtigung vom Benutzer
Entfernen von Postfachberechtigungen aus einem bestimmten Postfachbenutzer, Benutzer oder einer Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Benutzer
|
User | True | string |
Der Benutzer, der aus den Postfachberechtigungen entfernt werden soll. Sie können einen Benutzer nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Zugriffsrechte
|
AccessRights | True | string |
Die Zugriffsrechte, die aus den Berechtigungen des Benutzers für das Postfach entfernt werden sollen. Verfügbare Optionen sind 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' und 'ReadPermission'. Wenn Sie mehrere Berechtigungen entfernen möchten, geben Sie sie als durch Trennzeichen getrennte Liste an. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeRemoveMailboxPermissionResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Entfernen der Office 365-Postfachberechtigung vom Benutzer
Entfernen Von Microsoft Exchange Online- oder Office 365-Postfachberechtigungen aus einem bestimmten Postfachbenutzer, -Benutzer oder -Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Benutzer
|
User | True | string |
Der Postfachbenutzer, benutzer- oder E-Mail-aktivierte Sicherheitsgruppe, die aus den Postfachberechtigungen entfernt werden soll. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Zugriffsrechte
|
AccessRights | True | string |
Die Zugriffsrechte, die aus den Berechtigungen des Benutzers für das Postfach entfernt werden sollen. Verfügbare Optionen sind 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' und 'ReadPermission'. Wenn Sie mehrere Berechtigungen entfernen möchten, geben Sie sie als durch Trennzeichen getrennte Liste an. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365RemoveMailboxPermissionResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Entfernen des Active Directory-Objekts aus mehreren Gruppen
Entfernt ein Active Directory-Objekt (in der Regel ein Benutzer, eine Gruppe oder einen Computer) aus mehreren vorhandenen Active Directory-Gruppen. IA-Connect entfernt das Objekt aus so vielen Gruppen wie möglich und berichtet über das Ergebnis. Wenn das Objekt kein Mitglied einer oder mehrerer der angegebenen Gruppen ist, wird dies als Erfolg gezählt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Objektidentität
|
UserIdentity | True | string |
Das Objekt (in der Regel ein Benutzer, eine Gruppe oder einen Computer), das aus einer oder mehreren Gruppen entfernt werden soll. Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
Zu entfernende AD-Gruppen
|
GroupNamesJSON | string |
Eine Liste der AD-Gruppen, aus der das Objekt entfernt werden soll, im JSON- oder CSV-Format. Beispiel: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-Tabellenformat), ["Group 1", "Group 2"] (JSON-Arrayformat) oder Gruppe 1,Gruppe 2 (CSV-Format). Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
|
Ausnahme, wenn gruppen nicht entfernt werden können
|
ExceptionIfAnyGroupsFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Gruppe nicht entfernt werden kann (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Ausnahme, wenn alle Gruppen nicht entfernt werden können
|
ExceptionIfAllGroupsFailToRemove | boolean |
Wenn dieser Wert auf "true" festgelegt ist: Eine Ausnahme (Fehler) wird nur ausgelöst, wenn alle Gruppen nicht entfernt werden (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Max. Gruppen pro Anruf
|
MaxGroupsPerCall | integer |
Wenn eine große Anzahl von AD-Gruppen zum Entfernen angegeben ist, kann dies zu einem Timeout führen. Durch Festlegen des Werts "Max Gruppen pro Anruf" auf 1 oder höher teilt der IA-Connect Orchestrator diese Aktion in mehrere Anrufe an den IA-Connect Director und Agent mit der angegebenen maximalen Anzahl von Gruppen pro Anruf auf. Zuerst verfügbar in IA-Connect 9.3. Beispiel: Wenn Sie einen Wert von 5 und 14 Gruppen zum Entfernen festlegen, teilt der Orchestrator dies in Anforderungen von 5, 5, 4 auf. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD-Gruppen wurden erfolgreich entfernt.
|
ADGroupsRemovedSuccessfully | integer |
Die Anzahl der AD-Gruppen, aus der das Objekt erfolgreich entfernt wurde. |
|
AD-Gruppen konnten nicht entfernt werden.
|
ADGroupsFailedToRemove | integer |
Die Anzahl der AD-Gruppen, aus denen das Objekt nicht entfernt werden konnte. |
|
Fehlermeldung zum Entfernen von AD-Gruppen
|
RemoveADGroupsMasterErrorMessage | string |
Wenn das Objekt aus einigen AD-Gruppen nicht entfernt werden konnte und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Entfernen des Office 365-Postfachs aus allen Verteilergruppen
Entfernen Eines Postfachs aus allen Microsoft Exchange Online- oder Office 365-Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen, bei denen es sich um ein Mitglied handelt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
MailboxIdentity | string |
Die Identität des Postfachs, das aus allen Verteilergruppen oder E-Mail-aktivierten Sicherheitsgruppen entfernt werden soll, bei denen es sich um ein Mitglied handelt. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
|
Sicherheitsgruppen-Manager-Überprüfung umgehen
|
BypassSecurityGroupManagerCheck | boolean |
Wenn das IA-Connect Agent-Automatisierungskonto kein Besitzer einer Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe ist, kann es kein Mitglied aus dieser Gruppe entfernen. Wenn Sie diese Option auf "true" (Standardeinstellung) festlegen, wird die Besitzerüberprüfung umgangen, erfordert jedoch, dass das Automatisierungskonto in der Rollengruppe "Organisationsverwaltung" der Exchange-Rollengruppe enthalten ist oder die Rolle "Rollenverwaltung" zugewiesen ist . Dies ist eine einzelne Rolle, mit der Sie Berechtigungen zum Ändern einer Beliebigen Office 355 Exchange Online-Gruppe erhalten, anstatt Besitzer aller Gruppen zu sein, die Sie ändern müssen. |
|
|
Ausnahme, wenn gruppen nicht entfernt werden können
|
ExceptionIfAnyGroupsFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn das Postfach nicht aus einer einzelnen Gruppe entfernt werden kann (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Ausnahme, wenn alle Gruppen nicht entfernt werden können
|
ExceptionIfAllGroupsFailToRemove | boolean |
Wenn dieser Wert auf "true" festgelegt ist (Standardeinstellung): Eine Ausnahme (Fehler) wird ausgelöst, wenn das Postfach nicht aus allen Gruppen entfernt werden kann (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Auszuschließende Gruppen-DNs
|
GroupDNsToExcludeJSON | string |
Eine Liste der gruppierten Distinguished Names (DN), die aus der Entfernung ausgeschlossen werden sollen, im JSON- oder CSV-Format. Beispiel: [{"GroupDN": "Group DN 1"}, {"GroupName": "Group DN 2"}] (JSON-Tabellenformat), ["Group DN 1", "Group DN 2"] (JSON-Arrayformat) oder "Group DN 1","Group DN 2" (CSV-Format). |
|
|
Als Thread ausführen
|
RunAsThread | boolean |
Wenn dieser Wert auf "false" festgelegt ist, führt der IA-Connect Agent die Aktion sofort aus und gibt die Ergebnisse zurück, wenn die Aktion abgeschlossen ist, schlägt jedoch fehl, wenn das Timeout des Arbeits-/RPA-Befehls länger dauert. Wenn dieser Wert auf "true" festgelegt ist, führt der IA-Connect Agent diese Aktion als Agent-Thread aus und überwacht sie, bis er abgeschlossen ist. Dadurch kann die Aktion länger als das Timeout des Arbeits-/RPA-Befehls ausgeführt werden. |
|
|
Abrufen von Ausgabedaten für thread-ID
|
RetrieveOutputDataFromThreadId | integer |
Wenn Sie diese Aktion zuvor als Agent-Thread ausgeführt und "Sekunden auf Thread warten" auf 0 festgelegt haben, geben Sie die Agentthread-ID an, um die Ergebnisse abzurufen. Diese Agentthread-ID wurde vom vorherigen Aufruf dieser Aktion bereitgestellt. Legen Sie diesen Wert auf 0 (Standardeinstellung) fest, wenn Sie diese Aktion einfach ausführen (und daher nicht die Ergebnisse einer vorherigen Instanz dieser Aktion abrufen, die als Agent-Thread ausgeführt wird). |
|
|
Sekunden, die auf thread warten
|
SecondsToWaitForThread | integer |
Wenn "Als Thread ausführen" auf "true" festgelegt ist, wie viele Sekunden warten, bis der Agentthread abgeschlossen ist. Wenn der Agent-Thread, der diese Aktion ausführt, in diesem Zeitraum nicht abgeschlossen wurde, wird eine Ausnahme ausgelöst. Legen Sie auf 0 fest, um die Wartezeit zu umgehen: Der Agent führt die Aktion weiter aus, steht aber auch für die nächste Aktion zur Verfügung. Sie können die Aktionsergebnisse zu einem späteren Zeitpunkt abrufen, indem Sie die Aktion "Warten, bis agent-Thread erfolgreich abgeschlossen wurde" verwenden, um auf den Abschluss des Agent-Threads zu warten und dann dieses "Office 365-Postfach aus allen Verteilergruppen entfernen" -Aktion erneut auszuführen, wobei die Eingabe "Ausgabedaten für Thread-ID abrufen" auf die Agentthread-ID festgelegt ist. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
O365-Gruppen wurden erfolgreich entfernt
|
O365GroupsRemovedSuccessfully | integer |
Die Anzahl der O365-Gruppen, aus der das Postfach erfolgreich entfernt wurde. |
|
O365-Gruppen konnten nicht entfernt werden.
|
O365GroupsFailedToRemove | integer |
Die Anzahl der O365-Gruppen, aus der das Postfach nicht entfernt werden konnte. |
|
O365-Gruppen, die von der Entfernung ausgeschlossen sind
|
O365GroupsExcludedFromRemoval | integer |
Die Anzahl der vom Entfernen ausgeschlossenen O365-Gruppen (d. h. mit einer der angegebenen Gruppen-DNs übereinstimmen, die ausgeschlossen werden sollen). |
|
Entfernen der Hauptmeldung zu O365-Gruppen
|
RemoveO365GroupsErrorMessage | string |
Wenn das Postfach aus einigen O365-Gruppen nicht entfernt werden konnte und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
|
Thread-ID
|
ThreadId | integer |
Wenn diese Aktion als Agentthread ausgeführt wird, enthält diese Ausgabe die Agentthread-ID, mit der die Ausführung der Aktion überwacht und die Ergebnisse abgerufen werden kann, wenn die Aktion abgeschlossen wurde. |
Entfernen einer Microsoft Exchange-Verteilergruppe
Entfernen Sie eine Microsoft Exchange-Verteilergruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | True | string |
Die Identität der Verteilergruppe. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Sicherheitsgruppen-Manager-Überprüfung umgehen
|
BypassSecurityGroupManagerCheck | boolean |
Wenn das IA-Connect Agent-Automatisierungskonto standardmäßig kein Besitzer der Verteilergruppe ist, kann die Verteilergruppe nicht entfernt werden. Alternativ können Sie diese Option auf "true" festlegen, und dadurch wird diese Überprüfung entfernt, aber es erfordert, dass sich das Automatisierungskonto in der Rollengruppe "Organisationsverwaltung" der Exchange-Rollengruppe befindet oder die Rolle "Rollenverwaltung" zugewiesen ist . Dies ist eine einzelne Rolle, mit der Sie Berechtigungen zum Ändern einer Exchange-Verteilergruppe erhalten, anstatt Besitzer aller Verteilergruppen zu sein, die Sie ändern müssen. |
|
|
Ausnahme, wenn die Gruppe nicht vorhanden ist
|
ErrorIfGroupDoesNotExist | boolean |
Sollte eine Ausnahme auftreten, wenn die Gruppe nicht vorhanden ist? Legen Sie "false" fest, um einfach nichts zu tun, wenn die Gruppe nicht vorhanden ist (z. B. wurde sie möglicherweise bereits gelöscht). Wird auf "true" festgelegt, wenn die Gruppe nicht vorhanden ist (d. h. es wurde erwartet, dass sie vorhanden ist). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeRemoveDistributionGroupResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Entfernen einer Office 365-Verteilergruppe
Entfernen Sie eine Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | True | string |
Die Identität der zu entfernenden Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Sicherheitsgruppen-Manager-Überprüfung umgehen
|
BypassSecurityGroupManagerCheck | boolean |
Wenn das IA-Connect Agent-Automatisierungskonto kein Besitzer der Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe ist, kann die Gruppe nicht entfernt werden. Wenn Sie diese Option auf "true" (Standardeinstellung) festlegen, wird die Besitzerüberprüfung umgangen, erfordert jedoch, dass das Automatisierungskonto in der Rollengruppe "Organisationsverwaltung" der Exchange-Rollengruppe enthalten ist oder die Rolle "Rollenverwaltung" zugewiesen ist . Dies ist eine einzelne Rolle, mit der Sie Berechtigungen zum Ändern einer Beliebigen Office 355 Exchange Online-Gruppe erhalten, anstatt Besitzer aller Gruppen zu sein, die Sie ändern müssen. |
|
|
Ausnahme, wenn die Gruppe nicht vorhanden ist
|
ErrorIfGroupDoesNotExist | boolean |
Sollte eine Ausnahme auftreten, wenn die Gruppe nicht vorhanden ist? Legen Sie "false" fest, um einfach nichts zu tun, wenn die Gruppe nicht vorhanden ist (z. B. wurde sie möglicherweise bereits gelöscht). Wird auf "true" festgelegt, wenn die Gruppe nicht vorhanden ist (d. h. es wurde erwartet, dass sie vorhanden ist). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365RemoveDistributionGroupResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Entfernen eines Azure AD-Benutzers
Entfernen Sie einen Azure Active Directory-Benutzer. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Ausnahme, wenn der Benutzer nicht vorhanden ist
|
ErrorIfUserDoesNotExist | boolean |
Sollte eine Ausnahme auftreten, wenn der Benutzer nicht vorhanden ist? Legen Sie "false" fest, um einfach nichts zu tun, wenn der Benutzer nicht vorhanden ist (z. B. wurde er möglicherweise bereits gelöscht). Wird auf "true" festgelegt, wenn der Benutzer nicht vorhanden ist (d. h. es wurde erwartet, dass er vorhanden ist). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Der Benutzer ist vorhanden.
|
UserExisted | boolean |
Wenn der Benutzer vorhanden und gelöscht wurde, wird dies auf "true" festgelegt. Wenn der Benutzer nicht vorhanden war (und "Fehler, wenn der Benutzer nicht vorhanden ist" auf "false" festgelegt wurde, sodass keine Ausnahme ausgelöst wurde), wird dies auf "false" festgelegt, um Sie darüber zu informieren, dass der Benutzer nicht vorhanden war und daher IA-Connect keine Aktion ausführen musste. |
Entfernen eines Azure AD-Benutzers aus allen Administratorrollenzuweisungen
Entfernt einen Azure Active Directory-Benutzer (oder ein anderes Objekt) aus allen Azure Active Directory-Administratorrollen, denen sie zugewiesen sind. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Ausnahme, wenn rollen nicht entfernt werden können
|
ExceptionIfAnyRolesFailToRemove | boolean |
Wenn dieser Wert auf "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Administratorrolle nicht entfernt werden kann (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Rollen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Ausnahme, wenn alle Rollen nicht entfernt werden können
|
ExceptionIfAllRolesFailToRemove | boolean |
Wenn dieser Wert auf "true" festgelegt ist (Standardeinstellung): Eine Ausnahme (Fehler) wird ausgelöst, wenn alle Administratorrollen nicht entfernt werden konnten (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Rollen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD-Rollen wurden erfolgreich entfernt.
|
AzureADRolesRemovedSuccessfully | integer |
Die Anzahl der Azure AD-Rollen, aus der der Benutzer erfolgreich entfernt wurde. |
|
Azure AD-Rollen konnten nicht entfernt werden.
|
AzureADRolesFailedToRemove | integer |
Die Anzahl der Azure AD-Rollen, aus denen der Benutzer nicht entfernt werden konnte. |
|
Entfernen der Hauptmeldung zu Azure AD-Rollen
|
RemoveAzureADRolesErrorMessage | string |
Wenn der Benutzer einige der Azure AD-Rollen nicht entfernen konnte und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Entfernen eines Azure AD-Benutzers aus allen Gruppen
Entfernt einen Azure Active Directory-Benutzer aus allen Azure Active Directory-Gruppen, in denen er Mitglied ist. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Ausnahme, wenn gruppen nicht entfernt werden können
|
ExceptionIfAnyGroupsFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Gruppe nicht entfernt werden kann (d. h. 100% Erfolg ist eine Anforderung). Einige Gruppen (z. B. Office 365-Gruppen) werden möglicherweise nicht entfernt, sodass eine Ausnahme häufig auftritt. Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich gelöscht wurden und wie viele nicht gelöscht werden konnten. |
|
|
Ausnahme, wenn alle Gruppen nicht entfernt werden können
|
ExceptionIfAllGroupsFailToRemove | boolean |
Wenn dieser Wert auf "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn alle Gruppen nicht entfernt werden können (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich gelöscht wurden und wie viele nicht gelöscht werden konnten. |
|
|
Max. Azure AD-Gruppen pro Anruf
|
MaxAzureADGroupsPerCall | integer |
Wenn der Benutzer Mitglied einer großen Anzahl von Azure AD-Gruppen ist, kann dies zu einem Timeout führen. Durch Festlegen des Werts "Max Azure AD-Gruppen pro Anruf" auf 1 oder höher teilt der IA-Connect Orchestrator diese Aktion in mehrere Anrufe an den IA-Connect Director und Agent mit der angegebenen maximalen Anzahl von Gruppen pro Anruf auf. Beispiel: Wenn Sie einen Wert von 5 und 14 Gruppen festlegen, die entfernt werden müssen, teilt der Orchestrator dies in Anforderungen von 5, 5, 4 auf. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD-Gruppen wurden erfolgreich entfernt.
|
AzureADGroupsRemovedSuccessfully | integer |
Die Anzahl der Azure AD-Gruppen, aus der der Benutzer erfolgreich entfernt wurde. |
|
Azure AD-Gruppen konnten nicht entfernt werden.
|
AzureADGroupsFailedToRemove | integer |
Die Anzahl der Azure AD-Gruppen, aus denen der Benutzer nicht entfernt werden konnte. |
|
Entfernen der Hauptmeldung zu Azure AD-Gruppen
|
RemoveAzureADGroupsErrorMessage | string |
Wenn der Benutzer einige der Azure AD-Gruppen nicht entfernen konnte und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Entfernen eines Azure AD-Benutzers aus der Administratorrollenzuweisung
Entfernen Sie einen Azure Active Directory-Benutzer (oder ein anderes Objekt) aus einer vorhandenen Azure Active Directory-Administratorrollenzuweisung. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Rollenobjekt-ID oder Anzeigename
|
RoleObjectId | True | string |
Die ID oder der Anzeigename einer Azure Active Directory-Administratorrolle. Sie können eine AAD-Administratorrolle nach Anzeigename (z. B. "Anwendungsentwickler") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Verzeichnisbereichs-ID
|
DirectoryScopeId | string |
Eine optionale Verzeichnisbereichs-ID, mit der die für die Entfernung angegebene Rollenzuweisung übereinstimmen muss. Beispiel: /represents the entire tenant (and will result in only named role assignments with a directory scope ID of / to be removed), /GUID represents an app registration, /administrativeUnits/GUID represents an administrative unit. Wenn Sie eine Rollenzuweisung unabhängig vom Verzeichnisbereich entfernen möchten, geben Sie * oder einen leeren Wert an. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzer, der aus der Rolle entfernt wurde
|
UserRemovedFromRole | boolean |
True, wenn der Benutzer aus der Rolle entfernt wurde. False, wenn der Benutzer der Rolle nicht zugewiesen wurde (sodass nichts zu tun war). |
Entfernen eines Azure AD-Benutzers aus mehreren Administratorrollen
Entfernt einen Azure Active Directory-Benutzer (oder ein anderes Objekt) aus einer oder mehreren vorhandenen Azure Active Directory-Administratorrollen. Diese Aktion durchläuft die Liste der Rollenzuweisungen des Benutzers und entfernt übereinstimmende Elemente. Wenn Sie also nicht vorhandene Rollen angeben, löst dies keinen Fehler aus (da der Benutzer nicht in dieser Rolle ist, wird nichts versucht). Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Rollenobjekt-IDs oder Anzeigenamen
|
RolesJSON | string |
Eine Liste der Administratorrollen, die dem Benutzer zugewiesen werden sollen, im JSON- oder CSV-Format. Beispiel: [{"Role": "Application Developer"}, {"Role": "Exchange Administrator"}] (JSON-Tabellenformat), ["Anwendungsentwickler", "Exchange-Administrator"] (JSON-Arrayformat) oder Anwendungsentwickler,Exchange-Administrator (CSV-Format). Sie können eine AAD-Administratorrolle nach Anzeigename (z. B. "Anwendungsentwickler") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
|
Verzeichnisbereichs-ID
|
DirectoryScopeId | string |
Eine optionale Verzeichnisbereichs-ID, mit der die für das Entfernen angegebenen Rollenzuweisungen übereinstimmen müssen. Beispiel: /represents the entire tenant (and will result in only named role assignments with a directory scope ID of / to be removed), /GUID represents an app registration, /administrativeUnits/GUID represents an administrative unit. Wenn Sie eine benannte Rollenzuweisung unabhängig vom Verzeichnisbereich entfernen möchten, geben Sie * oder einen leeren Wert an. |
|
|
Ausnahme, wenn rollen nicht entfernt werden können
|
ExceptionIfAnyRolesFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Azure AD-Administratorrolle nicht entfernt werden kann (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Azure AD-Administratorrollen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Ausnahme, wenn alle Rollen nicht entfernt werden können
|
ExceptionIfAllRolesFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird nur ausgelöst, wenn alle Azure AD-Administratorrollen nicht entfernt werden (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Azure AD-Administratorrollen erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Ausnahme, wenn keine Rolle vorhanden ist
|
ExceptionIfRoleDoesNotExist | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine der für das Entfernen angegebenen Rollen nicht vorhanden ist. Wenn dieser Wert auf "false" festgelegt ist (Standardeinstellung): Wenn eine für das Entfernen angegebene Rolle nicht vorhanden ist, wird sie ignoriert, da der Benutzer ihm möglicherweise nicht zugewiesen werden kann. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD-Rollen wurden erfolgreich entfernt.
|
AzureADRolesRemovedSuccessfully | integer |
Die Anzahl der entfernten Azure AD-Rollen. Dies zählt nur Rollen, die tatsächlich entfernt wurden (Rollen, in denen der Benutzer nicht zählt). |
|
Azure AD-Rollen konnten nicht entfernt werden.
|
AzureADRolesFailedToRemove | integer |
Die Anzahl der Azure AD-Rollen, die nicht entfernt werden konnten. |
|
Fehlermeldung "Azure AD-Rollen entfernen"
|
RemoveAzureADRolesMasterErrorMessage | string |
Wenn einige Rollen nicht entfernt wurden und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Entfernen eines Azure AD-Benutzers aus mehreren Gruppen
Entfernt einen Azure Active Directory-Benutzer aus mehreren vorhandenen Azure Active Directory-Gruppen, in denen die Gruppen durch Objekt-ID oder Anzeigename angegeben werden. IA-Connect entfernt den Benutzer aus so vielen Gruppen wie möglich und berichtet über das Ergebnis. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Zu entfernende Azure AD-Gruppen
|
GroupNamesJSON | string |
Eine Liste der IDs oder Anzeigenamen von Azure AD-Gruppen, aus der der Benutzer im JSON- oder CSV-Format entfernt werden soll. Beispiel: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-Tabellenformat), ["Group 1", "Group 2"] (JSON-Arrayformat) oder Gruppe 1,Gruppe 2 (CSV-Format). |
|
|
Ausnahme, wenn gruppen nicht entfernt werden können
|
ExceptionIfAnyGroupsFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Gruppe nicht entfernt werden kann (d. h. 100% Erfolg ist eine Anforderung). Einige Gruppen (z. B. Office 365-Gruppen) werden möglicherweise nicht entfernt, sodass eine Ausnahme häufig auftritt. Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich gelöscht wurden und wie viele nicht gelöscht werden konnten. |
|
|
Ausnahme, wenn alle Gruppen nicht entfernt werden können
|
ExceptionIfAllGroupsFailToRemove | boolean |
Wenn dieser Wert auf "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn alle Gruppen nicht entfernt werden können (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich gelöscht wurden und wie viele nicht gelöscht werden konnten. |
|
|
Überprüfen von Benutzergruppenmitgliedschaften zuerst
|
CheckUserGroupMembershipsFirst | boolean |
Wenn dieser Wert auf "true" festgelegt ist, überprüft IA-Connect die Gruppenmitgliedschaften des Benutzers, bevor versucht wird, sie aus jeder Gruppe zu entfernen. Wenn der Benutzer kein Mitglied einer bestimmten Gruppe ist, meldet IA-Connect einfach erfolglos für diese Gruppe, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, entfernt IA-Connect den Benutzer sofort aus jeder angegebenen Gruppe, ohne zu überprüfen, was zu einem Fehler führt, wenn sich der Benutzer nicht in der Gruppe befindet. |
|
|
Max. Azure AD-Gruppen pro Anruf
|
MaxAzureADGroupsPerCall | integer |
Wenn der Benutzer Mitglied einer großen Anzahl von Azure AD-Gruppen ist, kann dies zu einem Timeout führen. Durch Festlegen des Werts "Max Azure AD-Gruppen pro Anruf" auf 1 oder höher teilt der IA-Connect Orchestrator diese Aktion in mehrere Anrufe an den IA-Connect Director und Agent mit der angegebenen maximalen Anzahl von Gruppen pro Anruf auf. Beispiel: Wenn Sie einen Wert von 5 und 14 Gruppen festlegen, die entfernt werden müssen, teilt der Orchestrator dies in Anforderungen von 5, 5, 4 auf. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD-Gruppen wurden erfolgreich entfernt.
|
AzureADGroupsRemovedSuccessfully | integer |
Die Anzahl der Azure AD-Gruppen, aus der der Benutzer erfolgreich entfernt wurde. |
|
Azure AD-Gruppen konnten nicht entfernt werden.
|
AzureADGroupsFailedToRemove | integer |
Die Anzahl der Azure AD-Gruppen, aus denen der Benutzer nicht entfernt werden konnte. |
|
Entfernen der Hauptmeldung zu Azure AD-Gruppen
|
RemoveAzureADGroupsErrorMessage | string |
Wenn der Benutzer einige der Azure AD-Gruppen nicht entfernen konnte und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Entfernen eines Microsoft Exchange-Mitglieds aus der Verteilergruppe
Entfernen Eines Mitglieds (z. B. eines Benutzers) aus einer Exchange-Verteilergruppe. Wenn sich das Mitglied nicht in der Gruppe befindet, wird keine Aktion ausgeführt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | True | string |
Die Identität der Verteilergruppe, der hinzugefügt werden soll. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Mitglied, das entfernt werden soll
|
Member | True | string |
Die Identität des Mitglieds, das aus der Verteilergruppe entfernt werden soll. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Sicherheitsgruppen-Manager-Überprüfung umgehen
|
BypassSecurityGroupManagerCheck | boolean |
Wenn das IA-Connect Agent-Automatisierungskonto standardmäßig kein Besitzer der Verteilergruppe ist, kann die Verteilergruppe nicht geändert werden. Alternativ können Sie diese Option auf "true" festlegen, und dadurch wird diese Überprüfung entfernt, aber es erfordert, dass sich das Automatisierungskonto in der Rollengruppe "Organisationsverwaltung" der Exchange-Rollengruppe befindet oder die Rolle "Rollenverwaltung" zugewiesen ist . Dies ist eine einzelne Rolle, mit der Sie Berechtigungen zum Ändern einer Exchange-Verteilergruppe erhalten, anstatt Besitzer aller Verteilergruppen zu sein, die Sie ändern müssen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeRemoveDistributionGroupMemberResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Entfernen eines Office 365-Mitglieds aus der Verteilergruppe
Entfernen Eines Mitglieds aus einer Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
GroupIdentity | True | string |
Die Identität der Verteilergruppe oder der E-Mail-aktivierten Sicherheitsgruppe, aus der entfernt werden soll. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Mitglied, das entfernt werden soll
|
Member | True | string |
Die Identität des Mitglieds, das aus der Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe entfernt werden soll. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Sicherheitsgruppen-Manager-Überprüfung umgehen
|
BypassSecurityGroupManagerCheck | boolean |
Wenn das IA-Connect Agent-Automatisierungskonto kein Besitzer der Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe ist, kann ein Mitglied nicht aus der Gruppe entfernt werden. Wenn Sie diese Option auf "true" (Standardeinstellung) festlegen, wird die Besitzerüberprüfung umgangen, erfordert jedoch, dass das Automatisierungskonto in der Rollengruppe "Organisationsverwaltung" der Exchange-Rollengruppe enthalten ist oder die Rolle "Rollenverwaltung" zugewiesen ist . Dies ist eine einzelne Rolle, mit der Sie Berechtigungen zum Ändern einer Beliebigen Office 355 Exchange Online-Gruppe erhalten, anstatt Besitzer aller Gruppen zu sein, die Sie ändern müssen. |
|
|
Ausnahme, wenn sich das Mitglied nicht in der Gruppe befindet
|
ExceptionIfMemberNotInGroup | boolean |
Sollte eine Ausnahme auftreten, wenn sich das Mitglied nicht in der Gruppe befindet? Legen Sie diesen Wert auf "false" fest (Standardeinstellung), um einfach nichts zu tun, wenn sich das Mitglied nicht in der Gruppe befindet (z. B. es wurde bereits entfernt oder war nie in der Gruppe enthalten). Wird auf "true" festgelegt, wenn das Mitglied, das sich nicht in der Gruppe befindet, ein Fehler ist (d. h. es wurde erwartet, dass es sich in der Gruppe befindet). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365RemoveDistributionGroupMemberResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Entfernen mehrerer Active Directory-Gruppenmitglieder
Entfernen Sie mindestens ein Active Directory-Objekt (in der Regel Benutzer, Gruppen oder Computer) aus einer vorhandenen Active Directory-Gruppe. IA-Connect entfernt so viele Mitglieder aus der Gruppe wie möglich und berichtet über das Ergebnis. Wenn sich Gruppen- und Gruppenmitglied in verschiedenen Domänen befinden, müssen Sie den Distinguished Name (DN) für Gruppen und Mitglieder angeben. Wenn einige der Objekte kein Mitglied der Gruppe sind, wird dies als Erfolg gezählt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenidentität
|
GroupIdentity | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
|
Gruppenmitglieder
|
GroupMembersJSON | string |
Eine Liste der Mitglieder (in der Regel Benutzer, Gruppen oder Computer), die aus der AD-Gruppe entfernt werden sollen, im JSON- oder CSV-Format. Beispiel: [{"MemberName": "User 1"}, {"MemberName": "User 2"}] (JSON-Tabellenformat), ["Benutzer 1", "Benutzer 2"] (JSON-Arrayformat) oder Benutzer 1,Benutzer 2 (CSV-Format). Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
|
Ausnahme, wenn elemente nicht entfernt werden können
|
ExceptionIfAnyMembersFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn einzelne Member nicht entfernt werden können (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Mitglieder erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Ausnahme, wenn alle Member nicht entfernt werden können
|
ExceptionIfAllMembersFailToRemove | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird nur ausgelöst, wenn alle Member nicht entfernt werden (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Mitglieder erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. |
|
|
Entfernen aller Mitglieder in einem einzelnen Anruf
|
RemoveAllMembersInASingleCall | boolean |
Wenn dieser Wert auf "true" festgelegt ist, werden alle Mitglieder in einer einzigen Aktion aus der Gruppe entfernt. Dies ist schneller, aber wenn ein einzelnes Element nicht vorhanden ist oder nicht entfernt werden kann, werden keine Member entfernt, und eine Ausnahme wird ausgelöst, unabhängig von den Eingabeoptionen für "Ausnahme". Wenn dieser Wert auf "false" festgelegt ist (Standardeinstellung), wird jedes Mitglied einzeln entfernt, und der IA-Connect Agent zählt, wie viele elemente erfolgreich entfernt wurden und wie viele nicht entfernt werden konnten. Wenn Mitglieder aus Gruppen über Domänen hinweg entfernt werden, wird empfohlen, diese Eingabe auf "false" festzulegen. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD-Gruppenmitglieder wurden erfolgreich entfernt.
|
ADGroupMembersRemovedSuccessfully | integer |
Die Anzahl der Mitglieder, die erfolgreich aus der AD-Gruppe entfernt wurden. |
|
AD-Gruppenmitglieder konnten nicht entfernt werden.
|
ADGroupMembersFailedToRemove | integer |
Die Anzahl der Mitglieder, die nicht aus der AD-Gruppe entfernt werden konnten. |
|
Fehlermeldung "AD-Gruppenmitglieder entfernen"
|
RemoveADGroupMembersMasterErrorMessage | string |
Wenn einige Mitglieder nicht aus der AD-Gruppe entfernt wurden und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Entsperren des Active Directory-Kontos
Entsperren Sie ein Active Directory-Konto. Wenn das Konto nicht gesperrt ist, führt dieser Befehl nichts aus.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryUnlockADAccountByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Erstellen einer neuen Azure AD Microsoft 365-Gruppe
Erstellt eine neue Azure Active Directory Microsoft 365-Gruppe. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Anzeigename
|
DisplayName | True | string |
Der Anzeigename der Gruppe. |
|
Description
|
Description | string |
Die Gruppenbeschreibung. |
|
|
E-Mail-Spitzname
|
MailNickname | string |
Der E-Mail-Spitzname, der zum Erstellen der Gruppen-E-Mail-Adresse verwendet wird. |
|
|
Gruppensichtbarkeit
|
GroupVisibility | string |
Wenn diese Einstellung auf "öffentlich" festgelegt ist (Standardeinstellung), kann jeder die Inhalte der Gruppe anzeigen, und jeder kann der Gruppe beitreten. Wenn sie auf "Privat" festgelegt ist, können nur Mitglieder den Inhalt der Gruppe anzeigen, und nur Besitzer können der Gruppe neue Mitglieder hinzufügen oder Beitrittsanfragen genehmigen. |
|
|
Die Gruppe "Überprüfen" ist vorhanden.
|
CheckGroupExists | boolean |
Wenn dieser Wert auf "true" festgelegt ist, überprüft IA-Connect, ob die Gruppe vorhanden ist. Wenn dies der Fall ist, meldet IA-Connect einfach erfolglos für diese Gruppe, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, erstellt IA-Connect die Gruppe ohne Überprüfung, was zu einem doppelten Gruppennamen führen kann. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe aus der Aktion "Verteilergruppe erstellen" im JSON-Format. Dies enthält in der Regel die Details der erstellten Gruppe. |
|
Gruppe ist bereits vorhanden
|
GroupAlreadyExists | boolean |
Wenn die Gruppe bereits vorhanden ist, wird dies auf "true" festgelegt, um Sie darüber zu informieren, dass die Gruppe vorhanden ist und daher IA-Connect keine Aktionen ausführen müssen. |
|
Erstellte Gruppenobjekt-ID
|
CreatedGroupObjectId | string |
Die Objekt-ID der erstellten Gruppe (oder die vorhandene Gruppe). |
Erstellen einer neuen Azure AD-Sicherheitsgruppe
Erstellt eine neue Azure Active Directory-Sicherheitsgruppe. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Anzeigename
|
DisplayName | True | string |
Der Anzeigename der Gruppe. |
|
Description
|
Description | string |
Die Gruppenbeschreibung. |
|
|
Die Gruppe "Überprüfen" ist vorhanden.
|
CheckGroupExists | boolean |
Wenn dieser Wert auf "true" festgelegt ist, überprüft IA-Connect, ob die Gruppe vorhanden ist. Wenn dies der Fall ist, meldet IA-Connect einfach erfolglos für diese Gruppe, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, erstellt IA-Connect die Gruppe ohne Überprüfung, was zu einem doppelten Gruppennamen führen kann. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe aus der Aktion "Verteilergruppe erstellen" im JSON-Format. Dies enthält in der Regel die Details der erstellten Gruppe. |
|
Gruppe ist bereits vorhanden
|
GroupAlreadyExists | boolean |
Wenn die Gruppe bereits vorhanden ist, wird dies auf "true" festgelegt, um Sie darüber zu informieren, dass die Gruppe vorhanden ist und daher IA-Connect keine Aktionen ausführen müssen. |
|
Erstellte Gruppenobjekt-ID
|
CreatedGroupObjectId | string |
Die Objekt-ID der erstellten Gruppe (oder die vorhandene Gruppe). |
Erstellen einer neuen Microsoft Exchange-Verteilergruppe
Erstellt eine neue Microsoft Exchange-Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenname
|
Name | True | string |
Der eindeutige Name für die neue Gruppe. |
|
Alias
|
Alias | string |
Der Alias (auch als E-Mail-Spitzname bezeichnet) für die neue Gruppe. Wenn Sie keine SMTP-Adresse angeben, wird der Alias verwendet, um die Namenskomponente der E-Mail-Adresse zu generieren (z. B. alias@mydomain.com). |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename der Gruppe. Dies ist in Adresslisten sichtbar. |
|
|
Hinweise
|
Notes | string |
Optionale Hinweise zum Objekt. |
|
|
Verwaltet von
|
ManagedBy | string |
Der Besitzer der Gruppe. Wenn Sie keinen Besitzer angeben, wird der Benutzer, der die Gruppe erstellt hat, zum Besitzer. Der Besitzer kann ein Postfach, ein E-Mail-Benutzer oder eine E-Mail-aktivierte Sicherheitsgruppe sein. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
|
Elemente
|
Members | string |
Eine durch Trennzeichen getrennte Liste von Mitgliedern, die der neuen Gruppe hinzugefügt werden sollen. Sie können Mitglieder nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
|
Organisationseinheit
|
OrganizationalUnit | string |
Die Organisationseinheit (OU) in Active Directory, in der die Gruppe gespeichert werden soll. Sie können eine OU im Distinguished Name-Format angeben (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyGroups\London). Wenn dies leer bleibt, wird die Gruppe in der OU "Benutzer" erstellt. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für die neue Gruppe verwendet wird. |
|
|
Einschränkung des Mitglieds verlassen
|
MemberDepartRestriction | string |
Ermöglicht es Ihnen, Einschränkungen für ein Mitglied anzugeben, das eine Verteilergruppe verlässt. "Öffnen" ist die Standardeinstellung und ermöglicht Es Mitgliedern, die Gruppe ohne Genehmigung zu verlassen, "Geschlossen" schränkt mitglieder ein, die Gruppe zu verlassen. Diese Option wird für Sicherheitsgruppen ignoriert, da Benutzer sich nicht selbst aus Sicherheitsgruppen entfernen können. |
|
|
Memberbeitrittseinschränkung
|
MemberJoinRestriction | string |
Ermöglicht Es Ihnen, Einschränkungen für ein Mitglied anzugeben, das einer Verteilergruppe beitritt, nachdem es erstellt wurde. Mit "Öffnen" können Mitglieder der Gruppe ohne Genehmigung beitreten, "Geschlossen" (Standardeinstellung) schränkt die Teilnahme an der Gruppe ein, "ApprovalRequired" ermöglicht es einem Mitglied, den Beitritt zur Gruppe anzufordern, und sie werden hinzugefügt, wenn ein Gruppenbesitzer die Anforderung akzeptiert. Diese Option wird für Sicherheitsgruppen ignoriert, da Benutzer sich nicht selbst zu Sicherheitsgruppen hinzufügen können. |
|
|
Absenderauthentifizierung erforderlich
|
RequireSenderAuthenticationEnabled | boolean |
Legen Sie "true" fest, um anzugeben, dass die Gruppe nur Nachrichten von authentifizierten (internen) Absendern akzeptiert. Auf "false" festgelegt, um Nachrichten von allen Absendern zu akzeptieren. |
|
|
Gruppentyp
|
Type | string |
Geben Sie den Typ der zu erstellenden Gruppe an. "Verteilung" ist der Standardwert und erstellt eine Verteilergruppe. "Sicherheit" wird verwendet, um eine E-Mail-aktivierte Sicherheitsgruppe zu erstellen. |
|
|
Ausnahme, wenn die Gruppe bereits vorhanden ist
|
ErrorIfGroupAlreadyExists | boolean |
Sollte eine Ausnahme auftreten, wenn die Gruppe bereits vorhanden ist? Legen Sie "false" fest, um einfach nichts zu tun, wenn die Gruppe bereits vorhanden ist (z. B. wurde sie bereits erstellt). Wird auf "true" festgelegt, wenn die bereits vorhandene Gruppe ein Fehler ist (d. h. es wurde nicht erwartet, dass sie vorhanden ist). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe aus der Aktion "Verteilergruppe erstellen" im JSON-Format. Dies enthält in der Regel die Details der erstellten Gruppe. |
|
Gruppe ist bereits vorhanden
|
GroupAlreadyExists | boolean |
Wenn die Gruppe bereits vorhanden ist (und "Ausnahme, wenn die Gruppe bereits vorhanden ist" auf "false" festgelegt ist), wird dies auf "true" festgelegt, um Sie darüber zu informieren, dass die Gruppe nicht tatsächlich erstellt wurde, weil sie bereits vorhanden ist. |
|
Neue Gruppe DN
|
NewGroupDN | string |
Der Distinguished Name (DN) der neu erstellten Gruppe. Dies ist ein eindeutiger Bezeichner für die Gruppe, die in weiteren Aktionen für diese Gruppe verwendet werden kann. |
|
Neue Gruppen-GUID
|
NewGroupGUID | string |
Die GUID der neu erstellten (aktivierten) Gruppe. Dies ist ein eindeutiger Bezeichner für die Gruppe, die in weiteren Aktionen für diese Gruppe verwendet werden kann. |
Erstellen einer neuen Office 365-Verteilergruppe
Erstellt eine neue Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierte Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenname
|
Name | True | string |
Der eindeutige Name für die neue Gruppe. |
|
Alias
|
Alias | string |
Der Alias (auch als E-Mail-Spitzname bezeichnet) für die neue Gruppe. Wenn Sie keine SMTP-Adresse angeben, wird der Alias verwendet, um die Namenskomponente der E-Mail-Adresse zu generieren (z. B. alias@mydomain.com). |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename der Gruppe. Dies ist in Adresslisten sichtbar. |
|
|
Hinweise
|
Notes | string |
Optionale Hinweise zum Objekt. |
|
|
Verwaltet von
|
ManagedBy | string |
Der Besitzer der Gruppe. Wenn Sie keinen Besitzer angeben, wird der Benutzer, der die Gruppe erstellt hat, zum Besitzer. Der Besitzer kann ein Postfach, ein E-Mail-Benutzer oder eine E-Mail-aktivierte Sicherheitsgruppe sein. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
|
Elemente
|
Members | string |
Eine durch Trennzeichen getrennte Liste von Mitgliedern, die der neuen Gruppe hinzugefügt werden sollen. Sie können Mitglieder nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
|
Organisationseinheit
|
OrganizationalUnit | string |
Die Organisationseinheit (OU) in Azure Active Directory, in der die Gruppe gespeichert werden soll. Sie können eine OU im Distinguished Name-Format (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local) oder GUID-Format angeben. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für die neue Gruppe verwendet wird. |
|
|
Einschränkung des Mitglieds verlassen
|
MemberDepartRestriction | string |
Ermöglicht es Ihnen, Einschränkungen für ein Mitglied anzugeben, das die Gruppe verlässt. "Öffnen" ist die Standardeinstellung und ermöglicht Es Mitgliedern, die Gruppe ohne Genehmigung zu verlassen, "Geschlossen" schränkt mitglieder ein, die Gruppe zu verlassen. |
|
|
Memberbeitrittseinschränkung
|
MemberJoinRestriction | string |
Ermöglicht Es Ihnen, Einschränkungen für ein Mitglied anzugeben, das der Gruppe beitritt, nachdem sie erstellt wurde. Mit "Öffnen" können Mitglieder der Gruppe ohne Genehmigung beitreten, "Geschlossen" (Standardeinstellung) schränkt die Teilnahme an der Gruppe ein, "ApprovalRequired" ermöglicht es einem Mitglied, den Beitritt zur Gruppe anzufordern, und sie werden hinzugefügt, wenn ein Gruppenbesitzer die Anforderung akzeptiert. |
|
|
Absenderauthentifizierung erforderlich
|
RequireSenderAuthenticationEnabled | boolean |
Legen Sie "true" fest, um anzugeben, dass die Gruppe nur Nachrichten von authentifizierten (internen) Absendern akzeptiert. Auf "false" festgelegt, um Nachrichten von allen Absendern zu akzeptieren. |
|
|
Gruppentyp
|
Type | string |
Geben Sie den Typ der zu erstellenden Gruppe an. "Verteilung" ist der Standardwert und erstellt eine Verteilergruppe. "Sicherheit" wird verwendet, um eine E-Mail-aktivierte Sicherheitsgruppe zu erstellen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe aus der Aktion "Verteilergruppe erstellen" im JSON-Format. Dies enthält in der Regel die Details der erstellten Gruppe. |
|
Gruppe ist bereits vorhanden
|
GroupAlreadyExists | boolean |
Wenn die Gruppe bereits vorhanden ist, wird dies auf "true" festgelegt, um Sie darüber zu informieren, dass die Gruppe nicht tatsächlich erstellt wurde. |
|
Gruppe DN erstellt
|
CreatedGroupDN | string |
Der Distinguished Name (DN) der erstellten Gruppe (oder der vorhandenen Gruppe). |
|
Erstellte Gruppen-GUID
|
CreatedGroupGUID | string |
Die GUID der erstellten Gruppe (oder der vorhandenen Gruppe). |
|
Gruppenidentität erstellt
|
CreatedGroupIdentity | string |
Die Identität der erstellten Gruppe (oder der vorhandenen Gruppe). |
Erstellen eines freigegebenen Office 365-Postfachs und eines Benutzerkontos
Erstellen Sie ein freigegebenes Postfach in Microsoft Exchange Online und ein Benutzerkonto in Azure Active Directory /Entra-ID. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht bereits in Azure Active Directory/Entra-ID vorhanden ist. Die SMTP-Adresse des freigegebenen Postfachs basiert auf dem Namen, alias oder der primären SMTP-Adresse (je nachdem, welche Eingaben bereitgestellt werden).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
Name | True | string |
Der eindeutige Name des Postfachs. Dies ist ein interner Wert, der nicht extern angezeigt wird (es sei denn, Sie legen keinen Alias oder eine primäre SMTP-Adresse fest, in diesem Fall wird er als Namenskomponente der SMTP-E-Mail-Adresse des Postfachs verwendet). Es wird empfohlen, ihn auf denselben Wert wie der Alias festzulegen, es sei denn, Sie haben eine alternative Prozedur oder einen guten Grund, einen anderen Wert zu verwenden. |
|
Vorname
|
FirstName | string |
Der Vorname des Postfachbenutzers. |
|
|
Nachname
|
LastName | string |
Der Nachname/Nachname des Postfachbenutzers. |
|
|
Initials
|
Initials | string |
Die mittleren Initialen des Postfachbenutzers. |
|
|
Anzeigename
|
DisplayName | string |
Der optionale Anzeigename des Postfachs. |
|
|
Alias
|
Alias | string |
Der Postfachalias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Dieser Wert wird verwendet, um die Namenskomponente der SMTP-E-Mail-Adresse des Postfachs zu generieren (z. B. ein Alias von "Alias" würde dazu führen alias@mydomain.com). Wenn sich dies von der primären SMTP-Adresse unterscheidet, führt dies dazu, dass das Postfach mehrere SMTP-Adressen enthält. Wenn dieser Wert nicht angegeben wird, werden keine Postfachalias eingerichtet, und das Postfach verfügt nur über eine primäre SMTP-Adresse. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre SMTP-E-Mail-Adresse, die für den Empfänger verwendet wird. Wenn sich dies vom Postfachalias unterscheidet, führt dies dazu, dass das Postfach mehrere SMTP-Adressen enthält. Wenn dieser Wert nicht angegeben wird, wird die primäre SMTP-Adresse automatisch basierend auf dem Alias oder Namen und der Organisationsrichtlinie berechnet (die in der Regel auf der Standarddomäne im Office 365 Admin Center basiert). |
|
|
Archivpostfach erstellen
|
Archive | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie zusätzlich ein Archivpostfach in Microsoft Exchange Online oder Office 365 erstellen möchten. |
|
|
Postfachbereich
|
MailboxRegion | string |
Die optionale geografische Region, in der das Postfach erstellt werden soll, wenn es sich in einer Multi-Geo-Umgebung befindet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe der neuen Postfachaktion im JSON-Format. |
|
Neue Benutzer-Microsoft Online-Dienste-ID
|
NewUserMicrosoftOnlineServicesID | string |
Die Microsoft Online-Dienste-ID des neu erstellten Postfachbenutzerkontos. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen verwendet werden kann. |
|
Neue Postfach-GUID
|
NewMailboxGUID | string |
Die GUID des neu erstellten Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen verwendet werden kann. |
|
Primäre SMTP-Adresse des neuen Postfachs
|
NewMailboxPrimarySmtpAddress | string |
Die primäre SMTP-Adresse des neu erstellten Postfachs. |
Erstellen eines Microsoft Exchange Online-Postfachs für einen Benutzer
Erstellt ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) oder Archivpostfach für einen vorhandenen Benutzer in lokalem Active Directory, das noch nicht über ein Postfach verfügt. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss. Sie können diese Aktion auch verwenden, um ein vorhandenes Remotepostfach zu archivieren.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des vorhandenen Benutzers, für den Sie ein Postfach erstellen möchten. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename des Postfachs. Dies ist in Adresslisten sichtbar. |
|
|
Remoteroutingadresse
|
RemoteRoutingAddress | string |
Die SMTP-Adresse des Postfachs in Microsoft Exchange Online oder Office 365, dem dieser Benutzer zugeordnet ist. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist, daher verwenden Sie stattdessen "Alias" oder deaktivieren Sie die E-Mail-Adressrichtlinie. |
|
|
Archivpostfach erstellen
|
Archive | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie zusätzlich ein Archivpostfach in Microsoft Exchange Online oder Office 365 erstellen möchten. |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe der Remotepostfachaktion im JSON-Format aktivieren. |
|
Neues Postfach DN
|
NewMailboxDN | string |
Der Distinguished Name (DN) des neu erstellten (aktivierten) Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
|
Neue Postfach-GUID
|
NewMailboxGUID | string |
Die GUID des neu erstellten (aktivierten) Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
Erstellen eines Microsoft Exchange Online-Postfachs und eines Benutzerkontos
Erstellen Sie einen E-Mail-aktivierten Benutzer in lokalem Active Directory, und erstellen Sie ein zugeordnetes Remotepostfach in Microsoft Exchange Online oder Office 365. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht in lokalem Active Directory vorhanden ist. Wenn der Benutzer bereits vorhanden ist, verwenden Sie die Aktion "Microsoft Exchange Online-Postfach für einen Benutzer erstellen". Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vorname
|
FirstName | string |
Der Vorname des Benutzers. |
|
|
Nachname
|
LastName | string |
Der Nachname/Nachname des Benutzers. |
|
|
Organisationseinheit
|
OnPremisesOrganizationalUnit | string |
Die Organisationseinheit (OU), in der der Benutzer im Distinguished Name-Format (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyUsers\London) gespeichert werden soll. Wenn dies leer ist, wird der Benutzer in der OU "Benutzer" erstellt. |
|
|
Name
|
Name | True | string |
Der Name des Active Directory-Benutzers. Dies wird in der Spalte "Name" in AD-Benutzern und -Computern und oben auf der Registerkarte "Allgemein" des Benutzers angezeigt. Dies ist nicht der Benutzeranmeldungsname. |
|
Anzeigename
|
DisplayName | string |
Der optionale Anzeigename des Benutzers. |
|
|
Remoteroutingadresse
|
RemoteRoutingAddress | string |
Legen Sie diese Einstellung fest, um die SMTP-Adresse des Postfachs in Microsoft Exchange Online oder Office 365 außer Kraft zu setzen, dem dieser Benutzer zugeordnet ist. Wenn Sie dieses Feld leer lassen (Standardeinstellung), wird die Remoteroutingadresse automatisch basierend auf Ihrer Verzeichnissynchronisierung zwischen lokalem und Microsoft Exchange Online berechnet. |
|
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist. Verwenden Sie stattdessen "Alias" (und die Richtlinie erstellt die primäre SMTP-Adresse aus dem Alias), oder deaktivieren Sie die E-Mail-Adressrichtlinie. |
|
|
Benutzerprinzipalname
|
UserPrincipalName | True | string |
Der Benutzeranmeldungsname in Active Directory. Dies sollte im Allgemeinen im Format "name@domainFQDN" (z. B. "TestUser1@domain.local") vorliegen. Der Benutzer kann sich mit diesem Format anmelden: name@domainFQDN. |
|
SAM-Kontoname
|
SamAccountName | string |
Der Benutzeranmeldungsname (vor Windows 2000) in Active Directory. Dies ist im Format "Name" (z. B. "TestUser1"). Der Benutzer kann sich mit diesem Format anmelden: DOMAIN\name. |
|
|
Kontokennwort
|
Password | password |
Das Benutzerkennwort. Dies muss angegeben werden und die Active Directory-Kennwortkomplexitätsregeln erfüllen. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. |
|
|
Kontokennwort wird gespeichert
|
AccountPasswordIsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss). |
|
|
Benutzer muss Kennwort bei der nächsten Anmeldung ändern
|
ResetPasswordOnNextLogon | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie erzwingen möchten, sein Kennwort bei der Anmeldung zu ändern (d. h. das hier festgelegte neue Kennwort ist ein einmaliges Kennwort, um den Angemeldeten des Benutzers zu erhalten). Auf "false" festgelegt, wenn dies das Kennwort ist, das der Benutzer verwendet, bis er es manuell ändert. |
|
|
Freigegebenes Postfach
|
SharedMailbox | boolean |
Auf "true" festgelegt, wenn das erstellte Postfach ein freigegebenes Postfach sein soll. |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Archivpostfach erstellen
|
Archive | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie zusätzlich ein Archivpostfach in Microsoft Exchange Online oder Office 365 erstellen möchten. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe der neuen Remotepostfachaktion im JSON-Format. |
|
Neues Postfach DN
|
NewMailboxDN | string |
Der Distinguished Name (DN) des neu erstellten Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
|
Neue Postfach-GUID
|
NewMailboxGUID | string |
Die GUID des neu erstellten Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
Erstellen eines Microsoft Exchange-Postfachs für einen Benutzer
Erstellt ein Microsoft Exchange-Postfach für einen vorhandenen Benutzer, der noch nicht über ein Postfach verfügt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des vorhandenen Benutzers, für den Sie ein Postfach erstellen möchten. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename des Postfachs. Dies ist in Adresslisten sichtbar. |
|
|
Verknüpfter Domänencontroller
|
LinkedDomainController | string |
Wenn Sie ein verknüpftes Postfach erstellen, können Sie den Domänencontroller in der Gesamtstruktur angeben, in der sich das Benutzerkonto befindet. Verwenden Sie den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers. |
|
|
Verknüpftes Hauptkonto
|
LinkedMasterAccount | string |
Wenn Sie ein verknüpftes Postfach erstellen, können Sie damit das Konto angeben, mit dem das Postfach verknüpft ist. Sie können das Konto nach Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID oder Name (z. B. 'User1') angeben. |
|
|
Datenbank
|
Database | string |
Die Exchange-Datenbank, die die neue Datenbank enthalten soll. Sie können die Datenbank durch Distinguished Name, GUID oder Name angeben. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist. Verwenden Sie stattdessen "Alias" (und die Richtlinie erstellt die primäre SMTP-Adresse aus dem Alias), oder deaktivieren Sie die E-Mail-Adressrichtlinie. |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe aus der Aktivieren der Postfachaktion im JSON-Format. |
|
Neues Postfach DN
|
NewMailboxDN | string |
Der Distinguished Name (DN) des neu erstellten (aktivierten) Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
|
Neue Postfach-GUID
|
NewMailboxGUID | string |
Die GUID des neu erstellten (aktivierten) Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
Erstellen eines Microsoft Exchange-Postfachs und eines Benutzerkontos
Erstellen Sie einen E-Mail-aktivierten Benutzer in lokalem Active Directory, und erstellen Sie ein zugeordnetes Postfach in Microsoft Exchange. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht in lokalem Active Directory vorhanden ist. Wenn der Benutzer bereits vorhanden ist, verwenden Sie die Aktion "Erstellen eines Microsoft Exchange-Postfachs für einen Benutzer".
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vorname
|
FirstName | string |
Der Vorname des Benutzers. |
|
|
Nachname
|
LastName | string |
Der Nachname/Nachname des Benutzers. |
|
|
Organisationseinheit
|
OrganizationalUnit | string |
Die Organisationseinheit (OU), in der der Benutzer im Distinguished Name-Format (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyUsers\London) gespeichert werden soll. Wenn dies leer ist, wird der Benutzer in der OU "Benutzer" erstellt. |
|
|
Name
|
Name | True | string |
Der Name des Active Directory-Benutzers. Dies wird in der Spalte "Name" in AD-Benutzern und -Computern und oben auf der Registerkarte "Allgemein" des Benutzers angezeigt. Dies ist nicht der Benutzeranmeldungsname. |
|
Anzeigename
|
DisplayName | string |
Der optionale Anzeigename des Benutzers. |
|
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist. Verwenden Sie stattdessen "Alias" (und die Richtlinie erstellt die primäre SMTP-Adresse aus dem Alias), oder deaktivieren Sie die E-Mail-Adressrichtlinie. |
|
|
Benutzerprinzipalname
|
UserPrincipalName | True | string |
Der Benutzeranmeldungsname in Active Directory. Dies sollte im Allgemeinen im Format "name@domainFQDN" (z. B. "TestUser1@domain.local") vorliegen. Der Benutzer kann sich mit diesem Format anmelden: name@domainFQDN. |
|
SAM-Kontoname
|
SamAccountName | string |
Der Benutzeranmeldungsname (vor Windows 2000) in Active Directory. Dies ist im Format "Name" (z. B. "TestUser1"). Der Benutzer kann sich mit diesem Format anmelden: DOMAIN\name. |
|
|
Kontokennwort
|
Password | password |
Das Benutzerkennwort. Dies muss angegeben werden und die Active Directory-Kennwortkomplexitätsregeln erfüllen. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. |
|
|
Kontokennwort wird gespeichert
|
AccountPasswordIsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss). |
|
|
Benutzer muss Kennwort bei der nächsten Anmeldung ändern
|
ResetPasswordOnNextLogon | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie erzwingen möchten, sein Kennwort bei der Anmeldung zu ändern (d. h. das hier festgelegte neue Kennwort ist ein einmaliges Kennwort, um den Angemeldeten des Benutzers zu erhalten). Auf "false" festgelegt, wenn dies das Kennwort ist, das der Benutzer verwendet, bis er es manuell ändert. |
|
|
Datenbank
|
Database | string |
Die Exchange-Datenbank, die die neue Datenbank enthalten soll. Sie können die Datenbank durch Distinguished Name, GUID oder Name angeben. |
|
|
Freigegebenes Postfach
|
SharedMailbox | boolean |
Auf "true" festgelegt, wenn das erstellte Postfach ein freigegebenes Postfach sein soll. |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Archivpostfach erstellen
|
Archive | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie zusätzlich ein Archivpostfach in Microsoft Exchange Online oder Office 365 erstellen möchten. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe der neuen Postfachaktion im JSON-Format. |
|
Neues Postfach DN
|
NewMailboxDN | string |
Der Distinguished Name (DN) des neu erstellten Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
|
Neue Postfach-GUID
|
NewMailboxGUID | string |
Die GUID des neu erstellten Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen für dieses Postfach verwendet werden kann. |
Erstellen eines Office 365-Archivpostfachs für vorhandene Benutzer
Erstellt ein archiviertes Postfach in Microsoft Exchange online für einen vorhandenen Benutzer in Azure Active Directory /Entra ID. Der Benutzer muss bereits über ein Postfach und eine geeignete Lizenz verfügen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Überprüfen, ob archiv vorhanden ist
|
CheckIfArchiveExists | boolean |
Bei Festlegung auf "true" (Standardeinstellung) überprüft der IA-Connect Agent, ob das Postfach bereits über ein Archiv verfügt. Wenn bereits ein Archiv vorhanden ist, gibt es nichts zu tun (da Sie kein Archiv zweimal erstellen können), und der Agent gibt Erfolg zurück. Bei Festlegung auf "false" überprüft der IA-Connect Agent nicht, ob das Postfach bereits über ein Archiv verfügt, was zu einer Ausnahme führt, wenn es bereits vorhanden ist. |
|
|
Archivname
|
ArchiveName | string |
Der optionale Archivname. Wenn nicht angegeben, wird standardmäßig "In-Place Archiv - {Anzeigename}" verwendet. |
|
|
Automatisches Erweitern des Archivs
|
AutoExpandingArchive | boolean |
Wenn dieser Wert auf "true" festgelegt ist, wird dem Archivpostfach automatisch zusätzlicher Speicherplatz hinzugefügt, wenn der Speichergrenzwert erreicht wird. Dieses Feature kann nach der Aktivierung nicht deaktiviert werden. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365EnableArchiveMailboxResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Erstellen eines Office 365-Postfachs und eines Benutzerkontos
Erstellen Sie ein Postfach in Microsoft Exchange Online und ein Benutzerkonto in Azure Active Directory/Entra-ID. Verwenden Sie diese Aktion nur, wenn der Benutzer nicht bereits in Azure Active Directory/Entra-ID vorhanden ist. Wenn der Benutzer bereits vorhanden ist, weisen Sie dem Benutzerkonto stattdessen eine geeignete Lizenz zu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Microsoft Online services Id
|
MicrosoftOnlineServicesID | True | string |
Die eindeutige ID des Benutzers. Dies befindet sich in der Regel im Format 'name@xxx.onmicrosoft.com'. |
|
Name
|
Name | True | string |
Der eindeutige Name des Postfachs. Dies ist ein interner Wert, der extern nicht sichtbar ist. Es wird empfohlen, sie auf denselben Wert wie die Namenskomponente ihrer Microsoft Online Services ID (z. B. "user1") festzulegen, es sei denn, Sie haben eine alternative Prozedur oder einen guten Grund, einen anderen Wert zu verwenden. |
|
Vorname
|
FirstName | string |
Der Vorname des Benutzers. |
|
|
Nachname
|
LastName | string |
Der Nachname/Nachname des Benutzers. |
|
|
Initials
|
Initials | string |
Die mittleren Initialen des Benutzers. |
|
|
Anzeigename
|
DisplayName | string |
Der optionale Anzeigename des Benutzers. |
|
|
Alias
|
Alias | string |
Der Postfachalias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Dieser Wert wird verwendet, um die Namenskomponente der SMTP-E-Mail-Adresse des Benutzers zu generieren (z. B. ein Alias von "Alias" würde dazu führen alias@mydomain.com). Wenn sich dies von der primären SMTP-Adresse unterscheidet, führt dies dazu, dass der Benutzer mehrere SMTP-Adressen hat. Wenn dieser Wert nicht angegeben wird, werden keine Benutzeralias eingerichtet, und der Benutzer verfügt nur über eine primäre SMTP-Adresse. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre SMTP-E-Mail-Adresse, die für den Empfänger verwendet wird. Wenn sich dies vom Benutzeralias unterscheidet, führt dies dazu, dass der Benutzer mehrere SMTP-Adressen hat. Wenn dieser Wert nicht angegeben wird, wird die primäre SMTP-Adresse automatisch basierend auf der Organisationsrichtlinie berechnet (die in der Regel auf der Standarddomäne im Office 365 Admin Center basiert). |
|
|
Kontokennwort
|
Password | password |
Das Benutzerkennwort. Dies muss angegeben werden und die Azure Active Directory-Kennwortkomplexitätsregeln erfüllen. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. |
|
|
Kontokennwort wird gespeichert
|
AccountPasswordIsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss). |
|
|
Benutzer muss Kennwort bei der nächsten Anmeldung ändern
|
ResetPasswordOnNextLogon | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie erzwingen möchten, sein Kennwort bei der Anmeldung zu ändern (d. h. das hier festgelegte neue Kennwort ist ein einmaliges Kennwort, um den Angemeldeten des Benutzers zu erhalten). Auf "false" festgelegt, wenn dies das Kennwort ist, das der Benutzer verwendet, bis er es manuell ändert. |
|
|
Archivpostfach erstellen
|
Archive | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie zusätzlich ein Archivpostfach in Microsoft Exchange Online oder Office 365 erstellen möchten. |
|
|
Postfachplan
|
MailboxPlan | string |
Der optionale Postfachplan, der auf das Postfach angewendet werden soll. Ein Postfachplan gibt die Berechtigungen und Features an, die für ein Postfach verfügbar sind. Sie können die verfügbaren Postfachpläne anzeigen, indem Sie das Skript "Get-MailboxPlan" im PowerShell-Runspace "Office 365" im IA-Connect Inspector ausführen. |
|
|
Postfachbereich
|
MailboxRegion | string |
Die optionale geografische Region, in der das Postfach erstellt werden soll, wenn es sich in einer Multi-Geo-Umgebung befindet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe der neuen Postfachaktion im JSON-Format. |
|
Neue Benutzer-Microsoft Online-Dienste-ID
|
NewUserMicrosoftOnlineServicesID | string |
Die Microsoft Online-Dienste-ID des neu erstellten Benutzerkontos. Dies ist ein eindeutiger Bezeichner für den Benutzer, der in weiteren Aktionen verwendet werden kann. |
|
Neue Postfach-GUID
|
NewMailboxGUID | string |
Die GUID des neu erstellten Postfachs. Dies ist ein eindeutiger Bezeichner für das Postfach, das in weiteren Aktionen verwendet werden kann. |
|
Primäre SMTP-Adresse des neuen Postfachs
|
NewMailboxPrimarySmtpAddress | string |
Die primäre SMTP-Adresse des neu erstellten Postfachs. |
Festlegen der Azure AD-Benutzerlizenz
Fügt eine Azure AD-Benutzerlizenz (SKU) hinzu oder entfernt sie. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Lizenz zum Hinzufügen
|
LicenseToAdd | string |
Eine einzelne Azure AD-Lizenz-SKU, die hinzugefügt werden soll. Dies kann als SKU-ID (eine GUID) oder als SKU-Teilenummer (ein Wort) eingegeben werden. Beispiel: TEAMS_EXPLORATORY. Wenn Sie mehrere Lizenzen aktivieren möchten, rufen Sie diese Aktion einmal pro Lizenz auf. |
|
|
Hinzuzufügende Lizenzpläne
|
LicensePlansChoice | string |
Einige Lizenzen verfügen über Pläne: Wenn Sie alle Pläne aktivieren möchten (oder nicht wissen), wählen Sie "Alle" aus. Wenn Sie nur bestimmte benannte Pläne aktivieren möchten, wählen Sie "Opt-in" aus, und geben Sie die Pläne ein, die im Feld "Lizenzpläne CSV" aktiviert werden sollen. Wenn Sie alle Pläne außer den von Ihnen angegebenen Plänen aktivieren möchten, wählen Sie "Opt-out" aus, und geben Sie die Pläne ein, die im Feld "Lizenzpläne CSV" deaktiviert werden sollen. |
|
|
Lizenzpläne
|
LicensePlansCSV | string |
Eine durch Trennzeichen getrennte Liste (CSV) der Lizenzpläne (eine Komponente der Lizenz), die aktiviert oder deaktiviert werden soll. Wenn Sie dieses Feld leer lassen, werden alle Lizenzpläne aktiviert. Dies kann als SKU-ID (eine GUID) oder als SKU-Teilenummer (ein Wort) eingegeben werden. Beispiel: YAMMER_ENTERPRISE,SHAREPOINTSTANDARD. |
|
|
Lizenzen, die entfernt werden sollen
|
LicensesToRemoveCSV | string |
Eine durch Trennzeichen getrennte Liste der zu entfernenden Azure AD-Lizenz-SKUs. Dies kann als durch Trennzeichen getrennte Liste der SKU-ID (eine GUID) oder SKU-Teilenummer (ein Wort) eingegeben werden. Beispiel: TEAMS_EXPLORATORY,FLOW_FREE. |
|
|
Verwendungsstandort
|
UsageLocation | string |
Ein Ländercode aus zwei Buchstaben (ISO 3166). Erforderlich für Benutzer, denen Lizenzen zugewiesen werden, aufgrund einer gesetzlichen Anforderung. Beispiel: USA (USA), JP (Japan), GB (Vereinigtes Königreich), FR (Frankreich), IN (Indien). Siehe https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes. Wenn Sie diesen Wert nicht festlegen, muss der Benutzer bereits seinen Verwendungsspeicherort festgelegt haben, oder die Lizenz kann nicht angewendet werden. |
|
|
Lokaler PowerShell-Bereich
|
LocalScope | boolean |
Sollte der zugrunde liegende Azure AD v2 PowerShell-Befehl im lokalen Bereich ausgeführt werden. Standardmäßig ist dies nicht festgelegt und daher wird PowerShell auf Standardeinstellungen zurückgesetzt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2SetAzureADUserLicenseResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen der Eigenschaften für ein Microsoft Exchange Online-Postfach
Legen Sie die Eigenschaften eines vorhandenen Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfach) fest. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfachs). Sie können ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) nach Active Directory-Objekt-ID, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, E-Mail-Adresse, GUID oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename des Postfachs. Dies ist in Adresslisten sichtbar. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist. Verwenden Sie stattdessen "Alias" (und die Richtlinie erstellt die primäre SMTP-Adresse aus dem Alias), oder deaktivieren Sie die E-Mail-Adressrichtlinie. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Postfachtyp
|
Type | string |
Der Postfachtyp. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Ausgeblendet in Adresslisten
|
HiddenFromAddressListsEnabled | boolean |
Legen Sie "true" fest, um das Postfach aus Adresslisten auszublenden, "false", um das Postfach in Adresslisten anzuzeigen, oder geben Sie keinen Wert an, um die aktuelle Einstellung unverändert zu lassen. |
|
|
Benutzerdefiniertes Attribut 1
|
CustomAttribute1 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 2
|
CustomAttribute2 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 3
|
CustomAttribute3 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 4
|
CustomAttribute4 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 5
|
CustomAttribute5 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 6
|
CustomAttribute6 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 7
|
CustomAttribute7 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 8
|
CustomAttribute8 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 9
|
CustomAttribute9 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 10
|
CustomAttribute10 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 11
|
CustomAttribute11 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 12
|
CustomAttribute12 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 13
|
CustomAttribute13 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 14
|
CustomAttribute14 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 15
|
CustomAttribute15 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeSetRemoteMailboxResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen der Eigenschaften für ein Microsoft Exchange-Postfach
Legen Sie die Eigenschaften eines vorhandenen Microsoft Exchange-Postfachs fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Konto deaktiviert
|
AccountDisabled | boolean |
Legen Sie "true" fest, wenn Sie das Konto deaktivieren möchten, "false", wenn Sie das Konto aktivieren oder keinen Wert angeben möchten, um die aktuelle Einstellung unverändert zu lassen. |
|
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename des Postfachs. Dies ist in Adresslisten sichtbar. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist. Verwenden Sie stattdessen "Alias" (und die Richtlinie erstellt die primäre SMTP-Adresse aus dem Alias), oder deaktivieren Sie die E-Mail-Adressrichtlinie. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Ausgeblendet in Adresslisten
|
HiddenFromAddressListsEnabled | boolean |
Legen Sie "true" fest, um das Postfach aus Adresslisten auszublenden, "false", um das Postfach in Adresslisten anzuzeigen, oder geben Sie keinen Wert an, um die aktuelle Einstellung unverändert zu lassen. |
|
|
Benutzerdefiniertes Attribut 1
|
CustomAttribute1 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 2
|
CustomAttribute2 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 3
|
CustomAttribute3 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 4
|
CustomAttribute4 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 5
|
CustomAttribute5 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 6
|
CustomAttribute6 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 7
|
CustomAttribute7 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 8
|
CustomAttribute8 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 9
|
CustomAttribute9 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 10
|
CustomAttribute10 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 11
|
CustomAttribute11 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 12
|
CustomAttribute12 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 13
|
CustomAttribute13 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 14
|
CustomAttribute14 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
Benutzerdefiniertes Attribut 15
|
CustomAttribute15 | string |
Ein Wert für das benutzerdefinierte Attributfeld. Lassen Sie keinen Wert leer, wenn Sie keinen Wert angeben möchten. Wenn Sie den Wert auf "Leer" festlegen möchten (d. h. er hat bereits einen Wert, und Sie möchten ihn zurücksetzen), verwenden Sie die Aktion "Zurücksetzen". |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeSetMailboxResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen der Eigenschaften für ein Office 365-Postfach
Legen Sie die Eigenschaften für ein Microsoft Exchange Online- oder Office 365-Postfach fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Konto deaktiviert
|
AccountDisabled | boolean |
Legen Sie "true" fest, wenn Sie das Konto deaktivieren möchten, "false", wenn Sie das Konto aktivieren oder keinen Wert angeben möchten, um die aktuelle Einstellung unverändert zu lassen. |
|
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename des Postfachs. Dies ist in Adresslisten sichtbar. |
|
|
Ausgeblendet in Adresslisten
|
HiddenFromAddressListsEnabled | boolean |
Legen Sie "true" fest, um das Postfach aus Adresslisten auszublenden, "false", um das Postfach in Adresslisten anzuzeigen, oder geben Sie keinen Wert an, um die aktuelle Einstellung unverändert zu lassen. |
|
|
Benutzerdefiniertes Attribut 1
|
CustomAttribute1 | string |
Ein Wert für das benutzerdefinierte Attribut 1-Feld. |
|
|
Benutzerdefiniertes Attribut 2
|
CustomAttribute2 | string |
Ein Wert für das benutzerdefinierte Attribut 2-Feld. |
|
|
Benutzerdefiniertes Attribut 3
|
CustomAttribute3 | string |
Ein Wert für das benutzerdefinierte Attribut 3-Feld. |
|
|
Benutzerdefiniertes Attribut 4
|
CustomAttribute4 | string |
Ein Wert für das benutzerdefinierte Attribut 4-Feld. |
|
|
Postfachtyp
|
Type | string |
Der Postfachtyp. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365SetO365MailboxResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen des Ablaufdatums des Active Directory-Benutzerkontos
Legt das Ablaufdatum des Kontos für ein Active Directory-Benutzerkonto fest. Dies ist der letzte vollständige Tag, an dem das Konto nutzbar ist, also läuft das Konto technisch zu Beginn des nächsten Tages ab. Der IA-Connect Agent weiß dies und fügt automatisch 1 Tag zum bereitgestellten Eingabedatum hinzu, wenn das Datum in Active Directory gespeichert wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Jahr
|
Year | True | integer |
Das Jahr, in dem das Konto abläuft. Beispiel: 2023. |
|
Month
|
Month | True | integer |
Die Anzahl des Monats, den das Konto abläuft. Januar = 1, Dezember = 12. Beispiel: 6. |
|
Day
|
Day | True | integer |
Die Nummer des Tages, an dem das Konto abläuft. Erster Tag des Monats = 1. Beispiel: 19. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectorySetADUserAccountExpirationEndOfDateResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen des Active Directory-Servers
Legt einen bestimmten Active Directory-Server fest, der für alle weiteren Active Directory-Aktionen verwendet werden soll.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Vordefinierte AD-Serverauswahl
|
PredefinedADServerChoice | string |
Benutzer-PDC: Der PDC-Emulator für die Domäne, zu der der aktuell angemeldete Benutzer gehört, wird verwendet. Computer PDC: Der PDC-Emulator für die Domäne, zu der der Computer gehört (auf dem die IA-Connect Sitzung ausgeführt wird) wird verwendet. Manuell: Geben Sie den Active Directory-Domänencontroller (DC) in das Feld "AD-Server" ein. Wenn dieses Feld leer ist und das Feld "AD-Server" einen Wert aufweist, wird dieser Wert verwendet. |
|
|
AD-Server
|
ADServer | string |
Dieses Feld wird nur verwendet, wenn die Option "Vordefinierte AD-Serverauswahl" auf "Manuell" (oder leer) festgelegt ist. Der Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), an den sie sich für alle weiteren Active Directory-Aktionen wenden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectorySetADServerResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen des Sendens von Exchange-Postfächern im Auftrag von
Geben Sie an, wer im Auftrag dieses vorhandenen Postfachs senden kann.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Senden im Auftrag erteilen an
|
GrantSendOnBehalfTo | True | string |
Die Identifizierung eines Benutzers, einer Gruppe oder eines Postfachs, die E-Mails im Auftrag dieses Postfachs senden kann. Sie können einen Benutzer nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeSetMailboxSendOnBehalfOfPermissionResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen des Vorgesetzten des Azure AD-Benutzers
Legen Sie den Vorgesetzten eines Azure Active Directory-Benutzers fest. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Leiter
|
Manager | string |
Um einen Vorgesetzten hinzuzufügen, geben Sie die Manager-Objekt-ID des Benutzers (z. B. UUID/GUID-Wert) oder UPN (z. B. ) an. myboss@mydomain.com Um den Vorgesetzten des Benutzers zu entfernen, legen Sie dieses Feld auf leer fest. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2SetAzureADUserManagerResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen eines Active Directory-Benutzers, der vor versehentlichem Löschen geschützt ist
Legt fest, dass ein Active Directory-Konto vor versehentlichem Löschen geschützt (oder nicht geschützt) wird. Wenn Sie ein Konto vor versehentlichem Löschen schützen, können Sie dieses Konto erst löschen, wenn Sie den Schutz entfernen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Geschützt vor versehentlichem Löschen
|
ProtectedFromAccidentalDeletion | True | boolean |
Auf "true" festlegen, um einen Benutzer vor versehentlichem Löschen zu schützen. Auf "false" festgelegt, um den Schutz vor versehentlichem Löschen zu entfernen. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectorySetADUserProtectedFromAccidentalDeletionByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen von automatischen Antworten (Außer Haus) für ein Microsoft Exchange-Postfach
Legen Sie automatische Antworten (Außer Haus) für ein Microsoft Exchange-Postfach fest. Diese Aktion funktioniert nicht für Remotepostfächer in Microsoft Exchange Online oder Office 365: Verwenden Sie stattdessen die Aktion "Automatische Antworten (Außer Haus) für ein Office 365-Postfach festlegen".
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Status der automatischen Antwort
|
AutoReplyState | True | string |
Ermöglicht es Ihnen, automatische Antworten zu aktivieren oder zu deaktivieren. |
|
Interne Nachricht
|
InternalMessage | string |
Die automatische Antwortnachricht (Abwesenheitsnachricht), die an interne Absender gesendet werden soll. Legen Sie den Wert auf "Leer" fest, um die Nachricht zu entfernen. |
|
|
Externe Zielgruppe
|
ExternalAudience | string |
Ermöglicht Ihnen anzugeben, ob automatische Antworten an externe Zielgruppen gesendet werden. Standardmäßig werden Antworten an alle externen Absender gesendet. |
|
|
Externe Nachricht
|
ExternalMessage | string |
Die automatische Antwortnachricht (Abwesenheitsnachricht), die an externe Absender gesendet werden soll, wenn die externe Zielgruppe auf "Alle" oder "Bekannt" festgelegt wurde. Legen Sie den Wert auf "Leer" fest, um die Nachricht zu entfernen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeSetMailboxAutoReplyConfigurationResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen von automatischen Antworten (Außer Haus) für ein Office 365-Postfach
Legen Sie automatische Antworten (Außer Haus) für ein Microsoft Exchange Online- oder Office 365-Postfach fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Status der automatischen Antwort
|
AutoReplyState | True | string |
Ermöglicht es Ihnen, automatische Antworten zu aktivieren oder zu deaktivieren. |
|
Interne Nachricht
|
InternalMessage | string |
Die automatische Antwortnachricht (Abwesenheitsnachricht), die an interne Absender gesendet werden soll. Legen Sie den Wert auf "Leer" fest, um die Nachricht zu entfernen. |
|
|
Externe Zielgruppe
|
ExternalAudience | string |
Ermöglicht Ihnen anzugeben, ob automatische Antworten an externe Zielgruppen gesendet werden. Standardmäßig werden Antworten an alle externen Absender gesendet. |
|
|
Externe Nachricht
|
ExternalMessage | string |
Die automatische Antwortnachricht (Abwesenheitsnachricht), die an externe Absender gesendet werden soll, wenn die externe Zielgruppe auf "Alle" oder "Bekannt" festgelegt wurde. Legen Sie den Wert auf "Leer" fest, um die Nachricht zu entfernen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365SetO365MailboxAutoReplyConfigurationResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Festlegen von Exchange zum Anzeigen der gesamten Active Directory-Gesamtstruktur
Geben Sie an, ob die gesamte Active Directory-Gesamtstruktur (einschließlich Unterdomänen) beim Ausführen von Exchange-Aktionen durchsucht/angezeigt wird. Möglicherweise müssen Sie diese Aktion verwenden, wenn Sie über mehrere verknüpfte Domänen verfügen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gesamtstruktur anzeigen
|
ViewEntireForest | True | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie die gesamte Active Directory-Gesamtstruktur durchsuchen möchten, "false", wenn Sie nur die aktuelle Active Directory-Domäne durchsuchen möchten. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeSetADServerToViewEntireForestResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Gibt die Active Directory-Gruppe an
Gibt zurück, ob eine angegebene Active Directory-Gruppe vorhanden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenidentität
|
GroupIdentity | True | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD-Gruppe ist vorhanden
|
ADGroupExists | boolean |
Diese Ausgabe gibt "true" zurück, wenn die AD-Gruppe vorhanden ist, "false", wenn die AD-Gruppe nicht vorhanden ist. |
|
AD-Gruppe DN
|
ADGroupDN | string |
Wenn die AD-Gruppe vorhanden ist, enthält diese Ausgabe den gruppierten Distinguished Name (DN). |
Herstellen einer Verbindung mit Active Directory mit Anmeldeinformationen
Ermöglicht es Ihnen, ein alternatives Konto anzugeben, das beim Ausführen von Active Directory-PowerShell-Befehlen verwendet werden soll. Dies wirkt sich auf alle Active Directory-Befehle aus, die nach dieser Aktion ausgegeben wurden. Wenn Sie diese Aktion nicht verwenden, werden alle Active Directory PowerShell-Befehle als Benutzerkonto ausgeführt, wie der IA-Connect Agent ausgeführt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nutzername
|
Username | True | string |
Der Benutzername des Kontos, das beim Ausführen von Active Directory-Befehlen verwendet werden soll. Sie können einen Benutzernamen im Format "DOMAIN\username" (z. B. TESTDOMAIN\admin) oder "username@domainFQDN" (z. B. ) angeben. admin@testdomain.local |
|
Kennwort
|
Password | True | password |
Das Kennwort des Kontos, das beim Ausführen von Active Directory-Befehlen verwendet werden soll. |
|
Remotecomputer
|
RemoteComputer | string |
Der Name oder vollqualifizierter Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC) oder Mitgliedsservers für die Authentifizierung bei und für alle Active Directory-Aktionen, an die übergeben werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. Wenn ein Mitgliedsserver (anstelle eines Domänencontrollers) eingegeben wird, muss dieser Mitgliedsserver die Active Directory PowerShell-Module /RSAT installiert haben. |
|
|
Verwenden von SSL
|
UseSSL | boolean |
Legen Sie "true" fest, um eine Verbindung mit dem WSMan-Remoteendpunkt mithilfe von SSL herzustellen. |
|
|
Alternativer TCP-Port
|
AlternativeTCPPort | integer |
Legen Sie einen alternativen TCP-Port fest, wenn sie nicht den Standard-WSMan TCP/5985 (non-SSL) oder TCP/5986 (SSL) verwenden. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
OpenActiveDirectoryPowerShellRunspaceWithCredentialsResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Herstellen einer Verbindung mit Azure AD mit Anmeldeinformationen
Verbindet IA-Connect mit Azure Active Directory (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Diese Aktion (oder "Mit Azure AD mit Zertifikat verbinden") muss ausgestellt werden, bevor andere Azure AD-Aktionen ausgeführt werden. Diese Aktion erfordert entweder ein Konto, das MFA (2FA) nicht verwendet, oder Sie müssen das Benutzeroberflächenautomatisierungsmodul verwenden, um die 2FA-Komponente (d. h. das Popup für die einmalige Kennwortauthentifizierung) zu automatisieren. Alternativ können Sie die Aktion "Mit Azure AD mit Zertifikat verbinden" verwenden. Diese Aktion verwendet PowerShell-Module für Azure AD v2- oder Microsoft Graph-Benutzer.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nutzername
|
Username | True | string |
Der Benutzername des Kontos, das beim Ausführen von Azure AD v2 PowerShell-Befehlen verwendet werden soll. |
|
Kennwort
|
Password | True | password |
Das Kennwort des Kontos, das beim Ausführen von Azure AD v2 PowerShell-Befehlen verwendet werden soll. |
|
Azure-Mandanten-ID
|
TenantId | string |
Die optionale Azure-Mandanten-ID, mit der eine Verbindung hergestellt werden soll. Wenn dies leer bleibt, wird der dem angegebenen Benutzerkonto zugeordnete Standardmandant verwendet. |
|
|
Zu verwendende API
|
APIToUse | string |
Die API, die für die Verbindung mit Azure AD verwendet werden soll. Nach der Festlegung verwenden alle weiteren azure AD-Befehle, die von IA-Connect ausgegeben werden, diese API. Wenn diese Option auf "Automatisch" festgelegt ist (standard), werden die installierten PowerShell-Module überprüft und in der folgenden Reihenfolge ausgewählt: Microsoft Graph Users PowerShell-Modul, Azure AD v2 PowerShell-Modul. Das Azure AD v2 PowerShell-Modul ist am 30. März 2024 veraltet und daher wird empfohlen, das PowerShell-Modul "Microsoft Graph-Benutzer" zu verwenden. |
|
|
Authentifizierungsbereich
|
AuthenticationScope | string |
Der Umfang der erforderlichen Berechtigungen, um alle Automatisierungsaufgaben in dieser Azure AD-Anmeldesitzung auszuführen. Standardmäßig fordert IA-Connect einen Berechtigungsbereich an, um Änderungen von Benutzern, Gruppen und Lizenzzuweisungen zuzulassen. Diese Einstellung wird nur beim Herstellen einer Verbindung mit dem PowerShell-Modul von Microsoft Graph-Benutzern verwendet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
OpenAzureADv2PowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Herstellen einer Verbindung mit Azure AD mit Zertifikat
Verbindet IA-Connect mit Azure Active Directory (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Diese Aktion (oder "Mit Anmeldeinformationen verbinden") muss ausgegeben werden, bevor andere Azure AD-Aktionen ausgeführt werden. Für diese Aktion ist eine Azure Service Principal- und Azure AD-App-Registrierung mit zertifikatsbasiertem Setup in Azure AD erforderlich, bevor sie funktioniert, hat jedoch den Vorteil, dass MFA (2FA) nicht erforderlich ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph PowerShell-Module.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Azure AD-App-Registrierungs-ID
|
ApplicationId | True | string |
Die Anwendungs-ID der Azure AD-App-Registrierung, die das Zertifikat enthält und über die erforderlichen Rollen in Azure AD verfügt, um die Automatisierungsaktionen auszuführen. Diese Azure AD-App-Registrierung muss zuvor von einem Administrator eingerichtet worden sein. |
|
Zertifikatfingerabdruck
|
CertificateThumbprint | True | string |
Der Fingerabdruck des Zertifikats, das für die Authentifizierung verwendet wird. Dieses Zertifikat muss zuvor erstellt und sowohl auf dem Computer vorhanden sein, auf dem IA-Connect die Automatisierungsaktionen und die Azure AD-App-Registrierung ausführt. |
|
Azure-Mandanten-ID
|
TenantId | True | string |
Azure-Mandanten-ID, mit der eine Verbindung hergestellt werden soll. Dies muss beim Verwenden von Zertifikaten zur Authentifizierung angegeben werden. |
|
Zu verwendende API
|
APIToUse | string |
Die API, die für die Verbindung mit Azure AD verwendet werden soll. Nach der Festlegung verwenden alle weiteren azure AD-Befehle, die von IA-Connect ausgegeben werden, diese API. Wenn diese Option auf "Automatisch" festgelegt ist (standard), werden die installierten PowerShell-Module überprüft und in der folgenden Reihenfolge ausgewählt: Microsoft Graph Users PowerShell-Modul, Azure AD v2 PowerShell-Modul. Das Azure AD v2 PowerShell-Modul ist am 30. März 2024 veraltet und daher wird empfohlen, das PowerShell-Modul "Microsoft Graph-Benutzer" zu verwenden. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
OpenAzureADv2PowerShellRunspaceWithCertificateResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Herstellen einer Verbindung mit der Standardmäßigen Active Directory-Domäne
Verbindet den IA-Connect Agent mit der Domäne, auf der der Computer, auf dem der IA-Connect Agent ausgeführt wird, mitglied ist, wobei das Konto verwendet wird, in dem der IA-Connect Agent ausgeführt wird (d. h. das Standardverhalten).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
OpenLocalPassthroughActiveDirectoryPowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Herstellen einer Verbindung mit JML-Umgebung
Stellen Sie eine Verbindung mit einer JML-Umgebung her, in der die Details dieser Umgebung im IA-Connect Orchestrator enthalten sind. Diese Details können Anmeldeinformationen, Adressen und andere Verbindungseinstellungen enthalten. Sie können diese Aktion beispielsweise verwenden, um eine Verbindung mit Active Directory, Microsoft Exchange, Azure AD oder Office 365 Exchange Online herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Freundlicher Name
|
FriendlyName | string |
Anzeigename der JML-Umgebung im IA-Connect Orchestrator. |
|
|
Nur verbinden, wenn noch keine Verbindung hergestellt wurde
|
OnlyConnectIfNotAlreadyConnected | boolean |
Gilt nur für Exchange und Office 365 Exchange Online. Bei Festlegung auf "false": Diese Aktion stellt immer eine Verbindung mit Exchange oder Office 365 Exchange Online her, auch wenn IA-Connect bereits verbunden ist. Wenn dieser Wert auf "true" festgelegt ist (Standardeinstellung): Wenn IA-Connect bereits mit Exchange oder Office 365 Exchange Online mit identischen Einstellungen verbunden ist und die Exchange-Verbindung reagiert, führt IA-Connect nichts aus, da die Verbindung bereits hergestellt wurde. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
JMLConnectToJMLEnvironmentResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Herstellen einer Verbindung mit Microsoft Exchange
Verbindet IA-Connect mit einem Microsoft Exchange-Server. Diese Aktion muss ausgegeben werden, bevor andere Exchange-Aktionen ausgeführt werden. Wenn Sie einen Benutzernamen und ein Kennwort angeben, werden alle nachfolgenden Exchange-Aktionen als dieses Konto ausgeführt. Wenn Sie keinen Benutzernamen und ein Kennwort angeben, werden alle nachfolgenden Exchange-Aktionen als Benutzerkonto ausgeführt, wie der IA-Connect Agent ausgeführt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nutzername
|
Username | string |
Der Benutzername des Kontos, das beim Ausführen von Exchange PowerShell-Befehlen verwendet werden soll. Sie können einen Benutzernamen im Format "DOMAIN\username" (z. B. TESTDOMAIN\admin) oder "username@domainFQDN" (z. B. ) angeben. admin@testdomain.local Wenn Sie keinen Benutzernamen und ein Kennwort angeben, werden alle nachfolgenden Exchange-Aktionen als Benutzerkonto ausgeführt, wie der IA-Connect Agent ausgeführt wird. |
|
|
Kennwort
|
Password | password |
Das Kennwort des Kontos, das beim Ausführen von Exchange PowerShell-Befehlen verwendet werden soll. |
|
|
Exchange-Server-FQDN
|
ExchangeServerFQDN | True | string |
Der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) oder der Hostname des Microsoft Exchange-Servers. |
|
Verwenden von SSL
|
UseSSL | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie eine Verbindung mit dem Microsoft Exchange-Server mithilfe von HTTPS/SSL herstellen möchten. Dadurch wird der gesamte Datenverkehr verschlüsselt, funktioniert aber nur, wenn der Exchange-Server so eingerichtet ist, dass PowerShell-Befehle über SSL akzeptiert werden. |
|
|
Verbindungsmethode
|
ConnectionMethod | string |
Welche Methode sollte zum Herstellen einer Verbindung mit Microsoft Exchange verwendet werden. "Lokal" importiert den Remote-Exchange-Runspace lokal und führt Befehle lokal aus. "Remote" wird direkt im Remote-Exchange-Runspace ausgeführt und kann aufgrund von Sicherheitseinschränkungen möglicherweise keine generischen PowerShell-Skripts ausführen. |
|
|
Authentifizierungsmechanismus
|
AuthenticationMechanism | string |
Der zu verwendende Authentifizierungsmechanismus, wenn eine Verbindung mit einem Remotecomputer hergestellt wird oder das Skript als alternativer Benutzer ausgeführt wird. Unterstützte Werte sind "Basic", "Credssp", "Default", "Digest", "Kerberos" und "Negotiate". |
|
|
Nur verbinden, wenn noch keine Verbindung hergestellt wurde
|
OnlyConnectIfNotAlreadyConnected | boolean |
Wenn dieser Wert auf "false" festgelegt ist: Diese Aktion stellt immer eine Verbindung mit Exchange her, auch wenn IA-Connect bereits verbunden ist. Wenn dieser Wert auf "true" festgelegt ist (Standardeinstellung): Wenn IA-Connect bereits mit Exchange mit identischen Einstellungen verbunden ist und die Exchange-Verbindung reagiert, führt IA-Connect nichts aus, da die Verbindung bereits hergestellt wurde. |
|
|
Befehlstypen, die lokal importiert werden sollen
|
CommandTypesToImportLocally | string |
Die Verbindungsmethode "Local" importiert Exchange PowerShell-Befehle lokal. Mit dieser Option können Sie auswählen, welche PowerShell-Befehle importiert werden sollen. Wenn Sie diese Liste auf ein Minimum beschränken, wird sowohl die Arbeitsspeicherauslastung als auch die Zeit für die Verbindung reduziert. "Alle" (standard, aus Gründen der Abwärtskompatibilität) importiert alle PS-Befehle. 'IA-Connect nur' (die empfohlene Option) importiert nur PS-Befehle, die von IA-Connect verwendet werden (Sie können zusätzliche PS-Befehle angeben). "Angegeben" importiert nur PS-Befehle, die Sie angeben, und kann einige IA-Connect Aktionen unterbrechen, wenn sie von PS-Befehlen abhängen, die Sie nicht angegeben haben. |
|
|
Zusätzliche Befehle, die lokal importiert werden sollen
|
AdditionalCommandsToImportLocallyCSV | string |
Wenn Sie die Verbindungsmethode "Local" verwenden und entweder "IA-Connect only" oder "Specified" PS-Befehle importieren möchten, können Sie eine durch Trennzeichen getrennte Liste mit zusätzlichen PS-Befehlen angeben, die importiert werden sollen. Beispiel: "Get-Mailbox,New-Mailbox,New-DistributionGroup". |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
OpenExchangePowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Herstellen einer Verbindung mit Office 365 mit Anmeldeinformationen
Verbindet IA-Connect mit Office 365 mithilfe der Office 365 PowerShell-Module. Diese Aktion (oder "Mit Office 365 mit Zertifikat verbinden") muss ausgestellt werden, bevor andere Office 365-Aktionen ausgeführt werden. Diese Aktion erfordert entweder ein Konto, für das keine MFA (2FA) erforderlich ist, oder Sie müssen das Benutzeroberflächenautomatisierungsmodul verwenden, um die 2FA-Komponente (d. h. das Einmalige Kennwortauthentifizierungspopup) zu automatisieren. Verwenden Sie alternativ die Aktion "Mit Office 365 mit Zertifikat verbinden".
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nutzername
|
Office365Username | True | string |
Der Benutzername des Kontos, das beim Ausführen von Office 365 PowerShell-Befehlen verwendet werden soll. |
|
Kennwort
|
Office365Password | True | password |
Das Kennwort des Kontos, das beim Ausführen von Office 365 PowerShell-Befehlen verwendet werden soll. |
|
Exchange-URL
|
ExchangeURL | string |
Die optionale URL des Microsoft Exchange-Onlineservers, mit dem eine Verbindung hergestellt werden soll. Verwenden Sie dies nur, wenn Sie über eine benutzerdefinierte URL verfügen. |
|
|
Verbindungsmethode
|
ConnectionMethod | string |
Welche Methode sollte zum Herstellen einer Verbindung mit Microsoft Exchange verwendet werden. Sowohl "EXO V1 local" als auch "EXO V1 remote" verwenden die ursprüngliche Microsoft Exchange Online PowerShell, die auf dem Computer ausgeführt wird, auf dem der IA-Connect Agent ausgeführt wird und keine zusätzlichen PowerShell-Module erfordert, aber schließlich veraltet ist. "EXO V1 local" importiert den Remote-Exchange-Runspace lokal und führt Befehle lokal aus. "EXO V1 Remote" wird direkt im Exchange-Remote-Runspace ausgeführt und kann aufgrund von Sicherheitseinschränkungen keine generischen PowerShell-Skripts ausführen. "EXO V2" verwendet das neuere Microsoft Exchange Online PowerShell v2-Modul, das auf dem Computer ausgeführt wird, auf dem der IA-Connect Agent ausgeführt wird und das v2 PowerShell-Modul "ExchangeOnlineManagement" installiert ist. |
|
|
Nur verbinden, wenn noch keine Verbindung hergestellt wurde
|
OnlyConnectIfNotAlreadyConnected | boolean |
Wenn dieser Wert auf "false" festgelegt ist: Diese Aktion stellt immer eine Verbindung mit Office 365 Exchange Online her, auch wenn IA-Connect bereits verbunden ist. Wenn dieser Wert auf "true" festgelegt ist (Standardeinstellung): Wenn IA-Connect bereits mit Office 365 Exchange Online mit identischen Einstellungen verbunden ist und die Office 365 Exchange Online-Verbindung reagiert, führt IA-Connect nichts aus, da die Verbindung bereits hergestellt wurde. |
|
|
Befehlstypen, die lokal importiert werden sollen
|
CommandTypesToImportLocally | string |
Die Verbindungsmethoden "EXO v1 local" und "EXO V2" importieren Office 365- oder Exchange Online PowerShell-Befehle lokal. Mit dieser Option können Sie auswählen, welche PowerShell-Befehle importiert werden sollen. Wenn Sie diese Liste auf ein Minimum beschränken, wird sowohl die Arbeitsspeicherauslastung als auch die Zeit für die Verbindung reduziert. "Alle" (standard, aus Gründen der Abwärtskompatibilität) importiert alle PS-Befehle. 'IA-Connect nur' (die empfohlene Option) importiert nur PS-Befehle, die von IA-Connect verwendet werden (Sie können zusätzliche PS-Befehle angeben). "Angegeben" importiert nur PS-Befehle, die Sie angeben, und kann einige IA-Connect Aktionen unterbrechen, wenn sie von PS-Befehlen abhängen, die Sie nicht angegeben haben. |
|
|
Zusätzliche Befehle, die lokal importiert werden sollen
|
AdditionalCommandsToImportLocallyCSV | string |
Wenn Sie die Verbindungsmethoden "EXO v1 local" oder "EXO V2" verwenden und entweder "IA-Connect nur" oder "Angegebene" PS-Befehle importieren möchten, können Sie eine durch Trennzeichen getrennte Liste mit zusätzlichen PS-Befehlen angeben, die importiert werden sollen. Beispiel: "Get-Mailbox,New-Mailbox,New-DistributionGroup". |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
OpenO365PowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Herstellen einer Verbindung mit Office 365 mit Zertifikat
Verbindet IA-Connect mit Office 365 mithilfe der Office 365 PowerShell-Module. Diese Aktion (oder "Mit Anmeldeinformationen verbinden") muss ausgegeben werden, bevor andere Office 365-Aktionen ausgeführt werden. Für diese Aktion ist eine Azure AD-App-Registrierung mit Zertifikaten und die richtigen Rollen erforderlich, die in Azure AD eingerichtet werden müssen, bevor sie funktioniert, hat jedoch den Vorteil, dass MFA (2FA) nicht erforderlich ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Anwendungs-ID der Azure AD-App-Registrierung
|
ApplicationId | True | string |
Die Anwendungs-ID der Azure AD-App-Registrierung, die das Zertifikat enthält und über die erforderlichen Rollen in Azure AD verfügt, um die Automatisierungsaktionen auszuführen. Diese Azure AD-App-Registrierung muss zuvor von einem Administrator eingerichtet worden sein. |
|
Zertifikatfingerabdruck
|
CertificateThumbprint | True | string |
Der Fingerabdruck des Zertifikats, das für die Authentifizierung verwendet wird. Dieses Zertifikat muss zuvor erstellt und sowohl auf dem Computer vorhanden sein, auf dem IA-Connect die Automatisierungsaktionen und die Azure AD-App-Registrierung ausführt. |
|
Organization
|
Organization | True | string |
Die Organisation, die für die Authentifizierung verwendet werden soll. Beispiel: mytestenvironment.onmicrosoft.com. |
|
Exchange-URL
|
ExchangeURL | string |
Die optionale URL des Microsoft Exchange-Onlineservers, mit dem eine Verbindung hergestellt werden soll. Verwenden Sie dies nur, wenn Sie über eine benutzerdefinierte URL verfügen. |
|
|
Verbindungsmethode
|
ConnectionMethod | string |
Welche Methode sollte zum Herstellen einer Verbindung mit Microsoft Exchange verwendet werden. "EXO V1" ist die ursprüngliche Microsoft Exchange Online PowerShell und unterstützt keine Zertifikate (und ist daher nicht als Option verfügbar). "EXO V2" verwendet das neuere Microsoft Exchange Online PowerShell v2-Modul, das auf dem Computer ausgeführt wird, auf dem der IA-Connect Agent ausgeführt wird und das v2 PowerShell-Modul "ExchangeOnlineManagement" installiert ist. |
|
|
Nur verbinden, wenn noch keine Verbindung hergestellt wurde
|
OnlyConnectIfNotAlreadyConnected | boolean |
Wenn dieser Wert auf "false" festgelegt ist: Diese Aktion stellt immer eine Verbindung mit Office 365 Exchange Online her, auch wenn IA-Connect bereits verbunden ist. Wenn dieser Wert auf "true" festgelegt ist (Standardeinstellung): Wenn IA-Connect bereits mit Office 365 Exchange Online mit identischen Einstellungen verbunden ist und die Office 365 Exchange Online-Verbindung reagiert, führt IA-Connect nichts aus, da die Verbindung bereits hergestellt wurde. |
|
|
Befehlstypen, die lokal importiert werden sollen
|
CommandTypesToImportLocally | string |
Die "EXO V2"-Verbindungsmethode (erforderlich für die Zertifikatauthentifizierung) importiert Office 365- oder Exchange Online PowerShell-Befehle lokal. Mit dieser Option können Sie auswählen, welche PowerShell-Befehle importiert werden sollen. Wenn Sie diese Liste auf ein Minimum beschränken, wird sowohl die Arbeitsspeicherauslastung als auch die Zeit für die Verbindung reduziert. "Alle" (standard, aus Gründen der Abwärtskompatibilität) importiert alle PS-Befehle. 'IA-Connect nur' (die empfohlene Option) importiert nur PS-Befehle, die von IA-Connect verwendet werden (Sie können zusätzliche PS-Befehle angeben). "Angegeben" importiert nur PS-Befehle, die Sie angeben, und kann einige IA-Connect Aktionen unterbrechen, wenn sie von PS-Befehlen abhängen, die Sie nicht angegeben haben. |
|
|
Zusätzliche Befehle, die lokal importiert werden sollen
|
AdditionalCommandsToImportLocallyCSV | string |
Wenn Sie entweder "nurIA-Connect" oder "Angegebene" PS-Befehle importieren möchten, können Sie eine durch Trennzeichen getrennte Liste mit zusätzlichen PS-Befehlen angeben, die importiert werden sollen. Beispiel: "Get-Mailbox,New-Mailbox,New-DistributionGroup". |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
OpenO365PowerShellRunspaceWithCertificateResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen der Microsoft Exchange-Postfachberechtigung
Zuweisen von Postfachberechtigungen zu einem Active Directory-Objekt (z. B. Benutzer oder Gruppe).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Active Directory-Objekt
|
User | True | string |
Das Active Directory-Objekt (z. B. Benutzer oder Gruppe), dem die Berechtigungen zugewiesen werden sollen. Sie können einen Benutzer nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Zugriffsrechte
|
AccessRights | string |
Die Zugriffsrechte, die den Berechtigungen des Benutzers für das Postfach zugewiesen werden sollen. Verfügbare Optionen sind 'AccessSystemSecurity', 'CreateChild', 'DeleteChild', 'ListChildren', 'Self', 'ReadProperty', 'WriteProperty', 'DeleteTree', 'ListObject', 'ExtendedRight', 'Delete', 'ReadControl', 'GenericExecute', 'GenericWrite', 'GenericRead', 'WriteDacl', 'WriteOwner', 'GenericAll' und 'Synchronize'. |
|
|
Erweiterte Rechte
|
ExtendedRights | string |
Ein optionales erweitertes Recht, den Berechtigungen des Benutzers für das Postfach zuzuweisen. Zu den erweiterten Rechten gehören "Senden als". |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeAddADPermissionResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen der Microsoft Exchange-Postfachberechtigung zum Benutzer
Zuweisen von Postfachberechtigungen zu einem bestimmten Postfachbenutzer, Benutzer oder einer Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Benutzer
|
User | True | string |
Der Benutzer, der den Postfachberechtigungen hinzugefügt werden soll. Sie können einen Benutzer nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Zugriffsrechte
|
AccessRights | True | string |
Die Zugriffsrechte, die den Berechtigungen des Benutzers für das Postfach zugewiesen werden sollen. Verfügbare Optionen sind 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' und 'ReadPermission'. Wenn Sie mehrere Berechtigungen zuweisen möchten, geben Sie sie als durch Trennzeichen getrennte Liste an. |
|
Automatische Zuordnung
|
AutoMapping | boolean |
Wenn dieser Wert auf "true" festgelegt ist, enthält das Postfach und das Benutzerkonto einige zusätzliche Eigenschaften, die dazu führen, dass Outlook das Postfach automatisch öffnet, wenn er als dieser Benutzer angemeldet ist. Dies kann einige Minuten in Kraft treten. Bei Festlegung auf "false" werden die zusätzlichen Eigenschaften nicht festgelegt, und Outlook öffnet das Postfach nicht automatisch. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeAddMailboxPermissionResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen der Office 365-Postfachberechtigung zum Benutzer
Weisen Sie einem bestimmten Postfachbenutzer, einem bestimmten Benutzer oder einer Sicherheitsgruppe Microsoft Exchange Online oder Office 365-Postfachberechtigungen zu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Benutzer
|
User | True | string |
Der Postfachbenutzer, benutzer- oder E-Mail-aktivierte Sicherheitsgruppe, um die Postfachberechtigungen zu erhalten. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Zugriffsrechte
|
AccessRights | True | string |
Die Zugriffsrechte, die den Berechtigungen des Benutzers für das Postfach zugewiesen werden sollen. Verfügbare Optionen sind 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' und 'ReadPermission'. Wenn Sie mehrere Berechtigungen zuweisen möchten, geben Sie sie als durch Trennzeichen getrennte Liste an. |
|
Automatische Zuordnung
|
AutoMapping | boolean |
Wenn dieser Wert auf "true" festgelegt ist, enthält das Postfach und das Benutzerkonto einige zusätzliche Eigenschaften, die dazu führen, dass Outlook das Postfach automatisch öffnet, wenn er als dieser Benutzer angemeldet ist. Dies kann einige Minuten in Kraft treten. Bei Festlegung auf "false" werden die zusätzlichen Eigenschaften nicht festgelegt, und Outlook öffnet das Postfach nicht automatisch. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365AddMailboxPermissionResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen einer Active Directory-Gruppe
Erstellt eine neue Active Directory-Gruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
Name | True | string |
Der Name der Active Directory-Gruppe. Dies wird in AD-Benutzern und -Computern in der Spalte "Name" und oben auf der Registerkarte "Allgemein" (im Titel) der Gruppe angezeigt. |
|
SAM-Kontoname
|
SamAccountName | string |
Der Gruppenname (vor Windows 2000) in Active Directory. Dies ist im Format "Name" (z. B. "TestGroup1"). |
|
|
Pfad
|
Path | string |
Die Organisationseinheit (OU), in der die Gruppe im Distinguished Name-Format (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyGroups\London) gespeichert werden soll. Wenn dies leer bleibt, wird die Gruppe in der OU "Benutzer" erstellt. |
|
|
Description
|
Description | string |
Die optionale Gruppenbeschreibung. |
|
|
Hinweise
|
Notes | string |
Die optionalen Gruppennotizen. |
|
|
Anzeigename
|
DisplayName | string |
Der optionale Anzeigename der Gruppe. Im Gegensatz zu Benutzerkonten wird ein Gruppenanzeigename nicht in AD-Benutzern und -Computern angezeigt. |
|
|
Gruppenkategorie
|
GroupCategory | True | string |
Der Typ der zu erstellenden Gruppe. Eine Sicherheitsgruppe wird in der Regel verwendet, um den Benutzer- und Computerzugriff auf IT-Ressourcen zu verwalten. Eine Verteilergruppe wird in der Regel verwendet, um eine Gruppen-E-Mail zu erstellen, sodass Sie eine Gruppe von Benutzern per E-Mail senden können. |
|
Gruppenbereich
|
GroupScope | True | string |
Der Bereich der zu erstellenden Gruppe. Es gibt einen komplexen Satz von Regeln, die beschreiben, wo auf eine Gruppe verwiesen werden kann und was je nach Bereich dieser Gruppe in einer Gruppe platziert werden kann. Sie können später nicht immer in einen anderen Gruppenbereich konvertieren, daher sollten Sie den richtigen Bereich bei der Erstellung auswählen. |
|
Homepage
|
HomePage | string |
Die optionale Gruppenstartseite. |
|
|
Verwaltet von
|
ManagedBy | string |
Gibt den Benutzer oder die Gruppe an, der diese Gruppe verwaltet. Sie können diese Eingabe im Distinguished Name-Format (z. B. CN=MrBig,OU=London,DC=mydomain,DC=local), GUID-Format, SID oder SAMAccountName (z. B. 'MrBig') angeben. |
|
|
Geschützt vor versehentlichem Löschen
|
ProtectedFromAccidentalDeletion | boolean |
Legen Sie "true" fest, um diese Gruppe vor versehentlichem Löschen zu schützen. Auf "false" festlegen, damit die Gruppe standardmäßig nicht vor versehentlichem Löschen geschützt wird. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
PowerShell-Ausgabe-JSON
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Gruppe "Distinguished Name" erstellt
|
CreatedGroupDistinguishedName | string |
Der Active Directory Distinguished Name (DN) der erstellten Gruppe. |
|
Gruppen-SAM-Kontoname erstellt
|
CreatedGroupSAMAccountName | string |
Der Name des Active Directory-SAM-Kontos der erstellten Gruppe. |
Hinzufügen einer Active Directory-OU
Erstellt eine neue Active Directory-Organisationseinheit (OU).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
Name | True | string |
Der Name der Active Directory-OE. Dies wird in der OU-Struktur in AD-Benutzern und -Computern und oben auf der Registerkarte "Allgemein" (im Titel) angezeigt. |
|
Pfad
|
Path | string |
Die Organisationseinheit (Organizational Unit, OU), in der die neue OU im Distinguished Name-Format (z. B. OU=Parent OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. London\Parent OU) gespeichert werden soll. Wenn dies leer ist, wird die OU im Stammverzeichnis der Struktur erstellt. |
|
|
Description
|
Description | string |
Die optionale OU-Beschreibung. |
|
|
Anzeigename
|
DisplayName | string |
Der optionale Anzeigename der OE. Im Gegensatz zu Benutzerkonten wird in AD-Benutzern und -Computern kein Anzeigename der OE angezeigt. |
|
|
Verwaltet von
|
ManagedBy | string |
Gibt den Benutzer oder die Gruppe an, der diese OU verwaltet. Sie können diese Eingabe im Distinguished Name-Format (z. B. CN=MrBig,OU=London,DC=mydomain,DC=local), GUID-Format, SID oder SAMAccountName (z. B. 'MrBig') angeben. |
|
|
Geschützt vor versehentlichem Löschen
|
ProtectedFromAccidentalDeletion | boolean |
Auf "true" (Standardeinstellung) festgelegt, um diese OE vor versehentlichem Löschen zu schützen. Legen Sie diesen Wert auf "false" fest, damit die OU nicht vor versehentlichem Löschen geschützt ist. |
|
|
Anschrift
|
StreetAddress | string |
Die Eigenschaft "Street" der OU (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Stadt
|
City | string |
Die Eigenschaft "City" der OU (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Staat
|
State | string |
Die Eigenschaft "Bundesland/Provinz" der OU (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Postleitzahl
|
PostalCode | string |
Die EIGENSCHAFT "PLZ" der OU (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
PowerShell-Ausgabe-JSON
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Erstellter OU Distinguished Name
|
CreatedOUDistinguishedName | string |
Der Active Directory Distinguished Name (DN) der erstellten OU. |
Hinzufügen eines Active Directory-Benutzers
Erstellt ein neues Active Directory-Benutzerkonto.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Name
|
Name | True | string |
Der Name des Active Directory-Benutzers. Dies wird in der Spalte "Name" in AD-Benutzern und -Computern und oben auf der Registerkarte "Allgemein" (im Titel) angezeigt. Dies ist nicht der Benutzeranmeldungsname. |
|
Benutzerprinzipalname
|
UserPrincipalName | string |
Der Benutzeranmeldungsname in Active Directory. Dies sollte im Allgemeinen im Format "name@domainFQDN" (z. B. "TestUser1@domain.local") vorliegen. Der Benutzer kann sich mit diesem Format anmelden: name@domainFQDN. |
|
|
SAM-Kontoname
|
SamAccountName | string |
Der Benutzeranmeldungsname (vor Windows 2000) in Active Directory. Dies ist im Format "Name" (z. B. "TestUser1"). Der Benutzer kann sich mit diesem Format anmelden: DOMAIN\name. |
|
|
Vorname
|
GivenName | string |
Der optionale Vorname des Benutzers. |
|
|
Nachname
|
SurName | string |
Der optionale Nachname des Benutzers. |
|
|
Pfad
|
Path | string |
Die Organisationseinheit (OU), in der der Benutzer im Distinguished Name-Format (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyUsers\London) gespeichert werden soll. Wenn dies leer ist, wird der Benutzer in der OU "Benutzer" erstellt. |
|
|
Description
|
Description | string |
Die optionale Benutzerbeschreibung. |
|
|
Anzeigename
|
DisplayName | string |
Der optionale Anzeigename des Benutzers. |
|
|
Kontokennwort
|
AccountPassword | password |
Das Benutzerkennwort. Dies muss angegeben werden und die Active Directory-Kennwortkomplexitätsregeln erfüllen. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. |
|
|
Kontokennwort wird gespeichert
|
AccountPasswordIsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss). |
|
|
Enabled
|
Enabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn das Konto unmittelbar nach der Erstellung aktiviert werden soll. Legen Sie den Wert auf "false" fest, damit das Konto deaktiviert wird. Diese Option ist standardmäßig auf "true" festgelegt. |
|
|
Benutzer muss Kennwort bei der nächsten Anmeldung ändern
|
ChangePasswordAtLogon | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie erzwingen möchten, sein Kennwort bei der Anmeldung zu ändern (d. h. das hier festgelegte neue Kennwort ist ein einmaliges Kennwort, um den Angemeldeten des Benutzers zu erhalten). Auf "false" festgelegt, wenn dies das Kennwort ist, das der Benutzer verwendet, bis er es manuell ändert. Sie können diese Option nicht gleichzeitig auf "True" festlegen, indem Sie entweder "Benutzer kann kein Kennwort ändern" oder "Kennwort läuft nie ab" auf "true" festlegen. |
|
|
Benutzer kann Kennwort nicht ändern
|
CannotChangePassword | boolean |
Legen Sie "true" fest, um zu verhindern, dass der Benutzer sein Kennwort ändern kann. Legen Sie diesen Wert auf "false" fest, wenn der Benutzer das Kennwort ändern kann. Sie können diese Option nicht gleichzeitig auf "True" festlegen, da die Einstellung "Benutzer muss das Kennwort bei der nächsten Anmeldung ändern" auf "true" festlegen. |
|
|
Kennwort läuft nie ab
|
PasswordNeverExpires | boolean |
Wird auf "true" festgelegt, wenn das Kennwort nie abläuft (d. h. der Benutzer wird nie aufgefordert, das Kennwort zu ändern). Legen Sie diesen Wert auf "false" fest, wenn das Kennwort gemäß der Active Directory-Domänenrichtlinie ablaufen kann. Sie können diese Option nicht gleichzeitig auf "True" festlegen, da die Einstellung "Benutzer muss das Kennwort bei der nächsten Anmeldung ändern" auf "true" festlegen. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
PowerShell-Ausgabe-JSON
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Erstellter Benutzer distinguished Name
|
CreatedUserDistinguishedName | string |
Der Active Directory Distinguished Name (DN) des erstellten Benutzerkontos. |
|
Erstellter Benutzer-SAM-Kontoname
|
CreatedUserSAMAccountName | string |
Der Active Directory-SAM-Kontoname des erstellten Benutzerkontos. |
|
Erstellter Benutzerprinzipalname
|
CreatedUserPrincipalName | string |
Der Active Directory-Benutzerprinzipalname (USER Principal Name, UPN) des erstellten Benutzerkontos. |
Hinzufügen eines Active Directory-Gruppenmitglieds
Hinzufügen eines Active Directory-Objekts (in der Regel ein Benutzer, eine Gruppe oder einen Computer) zu einer vorhandenen Active Directory-Gruppe. Wenn sich Gruppen- und Gruppenmitglied in verschiedenen Domänen befinden, müssen Sie den Distinguished Name (DN) für Gruppen und Mitglieder angeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenidentität
|
GroupIdentity | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
|
Gruppenname
|
GroupName | string |
Stellen Sie als Alternative zur Suche nach Identität den Vor-2K-Namen (SAMAccountName) der Active Directory-Gruppe bereit. Da die Eingabe "Gruppenidentität" auch den Vor-2K-Namen akzeptiert, ist diese Eingabe jetzt redundant, wird jedoch aus Gründen der Abwärtskompatibilität beibehalten. |
|
|
Mitglied der Gruppe
|
UserIdentity | True | string |
Das hinzuzufügende Gruppenmitglied (in der Regel ein Benutzer, eine Gruppe oder einen Computer). Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryAddADGroupMemberByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen eines Active Directory-Objekts zu mehreren Gruppen
Fügen Sie ein Active Directory-Objekt (in der Regel ein Benutzer, eine Gruppe oder einen Computer) zu mehreren vorhandenen Active Directory-Gruppen hinzu. IA-Connect fügt das Objekt so viele Gruppen wie möglich hinzu und berichtet über das Ergebnis. Wenn das Objekt bereits Mitglied einer oder mehrerer der angegebenen Gruppen ist, wird dies als Erfolg gezählt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Objektidentität
|
UserIdentity | True | string |
Das Objekt (in der Regel ein Benutzer, eine Gruppe oder einen Computer), das der gruppe oder mehreren Gruppen hinzugefügt werden soll. Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
Hinzuzufügende AD-Gruppen
|
GroupNamesJSON | string |
Eine Liste der AD-Gruppen, der das Objekt im JSON- oder CSV-Format hinzugefügt werden soll. Beispiel: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-Tabellenformat), ["Group 1", "Group 2"] (JSON-Arrayformat) oder Gruppe 1,Gruppe 2 (CSV-Format). Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
|
Ausnahme, wenn gruppen nicht hinzugefügt werden können
|
ExceptionIfAnyGroupsFailToAdd | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Gruppe nicht hinzugefügt werden kann (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich hinzugefügt wurden und wie viele nicht hinzugefügt werden konnten. |
|
|
Ausnahme, wenn alle Gruppen nicht hinzugefügt werden können
|
ExceptionIfAllGroupsFailToAdd | boolean |
Wenn dieser Wert auf "true" festgelegt ist: Eine Ausnahme (Fehler) wird nur ausgelöst, wenn alle Gruppen nicht hinzugefügt werden (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich hinzugefügt wurden und wie viele nicht hinzugefügt werden konnten. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Max. Gruppen pro Anruf
|
MaxGroupsPerCall | integer |
Wenn eine große Anzahl von AD-Gruppen zum Hinzufügen angegeben wird, kann dies zu einem Timeout führen. Durch Festlegen des Werts "Max Gruppen pro Anruf" auf 1 oder höher teilt der IA-Connect Orchestrator diese Aktion in mehrere Anrufe an den IA-Connect Director und Agent mit der angegebenen maximalen Anzahl von Gruppen pro Anruf auf. Zuerst verfügbar in IA-Connect 9.3. Beispiel: Wenn Sie einen Wert von 5 und 14 Gruppen festlegen, werden sie zum Hinzufügen angefordert, teilt der Orchestrator dies in Anforderungen von 5, 5, 4 auf. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD-Gruppen wurden erfolgreich hinzugefügt.
|
ADGroupsAddedSuccessfully | integer |
Die Anzahl der AD-Gruppen, zu der das Objekt erfolgreich hinzugefügt wurde. |
|
AD-Gruppen konnten nicht hinzugefügt werden
|
ADGroupsFailedToAdd | integer |
Die Anzahl der AD-Gruppen, zu denen das Objekt nicht hinzugefügt werden konnte. |
|
Fehlermeldung zum Hinzufügen von AD-Gruppen
|
AddADGroupsMasterErrorMessage | string |
Wenn das Objekt zu einigen AD-Gruppen nicht hinzugefügt werden konnte und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Hinzufügen eines Azure AD-Benutzers
Erstellt ein neues Azure Active Directory-Benutzerkonto. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerprinzipalname
|
UserPrincipalName | True | string |
Der Benutzeranmeldungsname in Azure Active Directory. Dies sollte im Allgemeinen im Format "name@domainFQDN" (z. B. "TestUser1@mydomain.onmicrosoft.com") vorliegen. |
|
Konto aktiviert
|
AccountEnabled | True | boolean |
Legen Sie diesen Wert auf "true" fest, wenn das Konto unmittelbar nach der Erstellung aktiviert werden soll. Legen Sie den Wert auf "false" fest, damit das Konto deaktiviert wird. Diese Option ist standardmäßig auf "true" festgelegt. |
|
Kontokennwort
|
AccountPassword | True | password |
Das Benutzerkennwort. Dies muss angegeben werden und die Azure Active Directory-Kennwortkomplexitätsregeln erfüllen. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. |
|
Kontokennwort wird gespeichert
|
AccountPasswordIsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss). |
|
|
Vorname
|
FirstName | string |
Der Vorname des Benutzers. |
|
|
Nachname
|
LastName | string |
Der Familienname/Nachname/Nachname des Benutzers. |
|
|
Anzeigename
|
DisplayName | True | string |
Der vollständige Anzeigename für diesen Benutzer. |
|
Stadt
|
City | string |
Der Name der Stadt, in der sich der Benutzer befindet oder wo sich sein Büro befindet. |
|
|
Unternehmensname
|
CompanyName | string |
Der Name des Unternehmens, für das der Benutzer arbeitet. |
|
|
Land oder Region
|
Country | string |
Das Land oder die Region, in dem sich der Benutzer befindet oder in dem sich sein Büro befindet. |
|
|
Abteilung
|
Department | string |
Der Name der Abteilung, für die der Benutzer innerhalb des Unternehmens arbeitet. |
|
|
Faxnummer
|
FaxNumber | string |
Faxnummer des Benutzers (Faksimile). |
|
|
Berufsbezeichnung
|
JobTitle | string |
Die Position des Benutzers. |
|
|
E-Mail-Spitzname
|
MailNickName | True | string |
Der E-Mail-Spitzname des Benutzers. |
|
Mobiltelefonnummer
|
MobilePhone | string |
Die Mobiltelefonnummer des Benutzers. |
|
|
Büro
|
Office | string |
Der Standort des Büros, in dem der Benutzer arbeitet. |
|
|
Telefonnummer
|
PhoneNumber | string |
Die Telefonnummer des Benutzers. |
|
|
Postleitzahl
|
PostalCode | string |
Die Postleitzahl, in der sich der Benutzer befindet, oder das Büro, in dem er arbeitet. |
|
|
Bevorzugte Sprache
|
PreferredLanguage | string |
Die bevorzugte Sprache des Benutzers. Dies wird in der Regel als zwei Buchstaben-Sprachcode (ISO 639-1) eingegeben, gefolgt von einem Gedankenstrich, gefolgt von einem zwei buchstabenigen Ländercode (ISO 3166). Beispiel: en-US, en-GB, fr-FR, ja-JP. |
|
|
Bundesland oder Kanton
|
State | string |
Der Staat, die Provinz oder das Land, in dem sich der Benutzer befindet oder wo sich sein Büro befindet. |
|
|
Anschrift
|
StreetAddress | string |
Die Adresse, an der sich der Benutzer befindet, oder seine Büroadresse. |
|
|
Verwendungsstandort
|
UsageLocation | string |
Ein Ländercode aus zwei Buchstaben (ISO 3166). Erforderlich für Benutzer, denen Lizenzen zugewiesen werden, aufgrund einer gesetzlichen Anforderung. Beispiel: USA (USA), JP (Japan), GB (Vereinigtes Königreich), FR (Frankreich), IN (Indien). Siehe https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes. |
|
|
Altersgruppe
|
AgeGroup | string |
Die Altersgruppe des Benutzers zu Jugendschutzzwecken. Der Standardwert ist "none/not specified", der (aus Sicht von Steuerelementen) mit "Adult" identisch ist. |
|
|
Zustimmung für Minderjährige vorgesehen
|
ConsentProvidedForMinor | string |
Wenn die "Altersgruppe" "Minderjährige" ist, können Sie in diesem Feld angeben, ob die Zustimmung für den Minderjährigen für Jugendschutzzwecke vorgesehen wurde. |
|
|
Mitarbeiter-ID
|
EmployeeId | string |
Eine optionale Mitarbeiter-ID. Sie können dies verwenden, um zwischen jedem Benutzer in Ihrer Organisation eindeutig zu unterscheiden. |
|
|
Ändern des Kennworts bei der nächsten Anmeldung erzwingen
|
ForceChangePasswordNextLogin | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie erzwingen möchten, sein Kennwort beim nächsten Anmelden zu ändern (d. h. das hier festgelegte neue Kennwort ist ein einmaliges Kennwort, mit dem der Benutzer sich anmelden kann). Auf "false" festgelegt, wenn dies das Kennwort ist, das der Benutzer verwendet, bis er es manuell ändert. |
|
|
Erzwingen der Kennwortrichtlinie
|
EnforceChangePasswordPolicy | boolean |
Legen Sie "true" fest, um die Azure Active Directory-Änderungskennwortrichtlinie zu erzwingen, die (abhängig von Ihrer Umgebung) definieren kann, wie oft der Benutzer sein Kennwort, Kennwortwiederherstellungsoptionen und zusätzliche Sicherheitsüberprüfung ändern soll. Dies kann dazu führen, dass der Benutzer zur Eingabe zusätzlicher Informationen aufgefordert wird. |
|
|
Kennwort läuft nie ab
|
PasswordNeverExpires | boolean |
Wird auf "true" festgelegt, wenn das Kennwort nie abläuft (d. h. der Benutzer wird nie aufgefordert, das Kennwort zu ändern). Legen Sie diesen Wert auf "false" fest, wenn das Kennwort gemäß der Azure Active Directory-Kennwortrichtlinie ablaufen kann. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON des Aktionsergebnisses
|
PowerShellJSONOutput | string |
Die Ausgabe des PowerShell-Skripts, formatiert als JSON. |
|
Erstellter Benutzerprinzipalname
|
CreatedUserPrincipalName | string |
Der Azure Active Directory-Benutzerprinzipalname (USER Principal Name, UPN) des erstellten Benutzerkontos. |
|
Benutzerobjekt-ID erstellt
|
CreatedUserObjectId | string |
Die Azure Active Directory-Benutzerobjekt-ID des erstellten Benutzerkontos. |
Hinzufügen eines Azure AD-Benutzers zu mehreren Gruppen
Fügt einen Azure Active Directory-Benutzer mehreren vorhandenen Azure Active Directory-Gruppen hinzu, in denen die Gruppen durch Objekt-ID oder Anzeigename angegeben werden. IA-Connect fügt den Benutzer so viele Gruppen wie möglich hinzu und berichtet über das Ergebnis. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Hinzufügen von Azure AD-Gruppen
|
GroupNamesJSON | string |
Eine Liste der IDs oder Anzeigenamen von Azure AD-Gruppen, zu der der Benutzer im JSON- oder CSV-Format hinzugefügt werden soll. Beispiel: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-Tabellenformat), ["Group 1", "Group 2"] (JSON-Arrayformat) oder Gruppe 1,Gruppe 2 (CSV-Format). |
|
|
Ausnahme, wenn gruppen nicht hinzugefügt werden können
|
ExceptionIfAnyGroupsFailToAdd | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Gruppe nicht hinzugefügt werden kann (d. h. 100% Erfolg ist eine Anforderung). Einige Gruppen (z. B. Office 365-Gruppen) können nicht hinzugefügt werden, sodass eine Ausnahme häufig vorkommen könnte. Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich hinzugefügt wurden und wie viele nicht hinzugefügt werden konnten. |
|
|
Ausnahme, wenn alle Gruppen nicht hinzugefügt werden können
|
ExceptionIfAllGroupsFailToAdd | boolean |
Wenn dieser Wert auf "true" festgelegt ist: Eine Ausnahme (Fehler) wird nur ausgelöst, wenn alle Gruppen nicht hinzugefügt werden (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Gruppen erfolgreich hinzugefügt wurden und wie viele nicht hinzugefügt werden konnten. |
|
|
Überprüfen von Benutzergruppenmitgliedschaften zuerst
|
CheckUserGroupMembershipsFirst | boolean |
Wenn dieser Wert auf "true" festgelegt ist, überprüft IA-Connect die Gruppenmitgliedschaften des Benutzers, bevor sie der Gruppe hinzugefügt werden. Wenn der Benutzer bereits Mitglied der Gruppe ist, meldet IA-Connect einfach erfolglos, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, fügt IA-Connect den Benutzer sofort ohne Überprüfung zur Gruppe hinzu, was zu einem Fehler führt, wenn sich der Benutzer bereits in der Gruppe befindet. |
|
|
Max. Azure AD-Gruppen pro Anruf
|
MaxAzureADGroupsPerCall | integer |
Wenn eine große Anzahl von Azure AD-Gruppen zum Hinzufügen angegeben ist, kann dies zu einem Timeout führen. Durch Festlegen des Werts "Max Azure AD-Gruppen pro Anruf" auf 1 oder höher teilt der IA-Connect Orchestrator diese Aktion in mehrere Anrufe an den IA-Connect Director und Agent mit der angegebenen maximalen Anzahl von Gruppen pro Anruf auf. Beispiel: Wenn Sie einen Wert von 5 und 14 Gruppen festlegen, die entfernt werden müssen, teilt der Orchestrator dies in Anforderungen von 5, 5, 4 auf. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD-Gruppen wurden erfolgreich hinzugefügt.
|
AzureADGroupsAddedSuccessfully | integer |
Die Anzahl der Azure AD-Gruppen, zu der der Benutzer erfolgreich hinzugefügt wurde. |
|
Azure AD-Gruppen konnten nicht hinzugefügt werden
|
AzureADGroupsFailedToAdd | integer |
Die Anzahl der Azure AD-Gruppen, zu denen der Benutzer nicht hinzugefügt werden konnte. |
|
Azure AD-Gruppenmasterfehlermeldung hinzufügen
|
AddAzureADGroupsMasterErrorMessage | string |
Wenn der Benutzer einige der Azure AD-Gruppen nicht hinzufügen konnte und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Hinzufügen eines Azure AD-Benutzers zur Gruppe
Fügen Sie einen Azure Active Directory-Benutzer zu einer vorhandenen Azure Active Directory-Sicherheits- oder M365-Gruppe hinzu. Diese Aktion kann keine Verteilerlisten oder E-Mail-aktivierten Sicherheitsgruppen ändern . Verwenden Sie stattdessen die Office 365 Exchange Online-Aktionen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Gruppenobjekt-ID oder Anzeigename
|
GroupObjectId | True | string |
Die ID oder der Anzeigename einer Azure Active Directory-Gruppe. Sie können eine Gruppe nach Anzeigename (z. B. "Finanzbenutzer") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Überprüfen von Benutzergruppenmitgliedschaften zuerst
|
CheckUserGroupMembershipsFirst | boolean |
Wenn dieser Wert auf "true" festgelegt ist, überprüft IA-Connect die Gruppenmitgliedschaften des Benutzers, bevor sie der Gruppe hinzugefügt werden. Wenn der Benutzer bereits Mitglied der Gruppe ist, meldet IA-Connect einfach erfolglos, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, fügt IA-Connect den Benutzer sofort ohne Überprüfung zur Gruppe hinzu, was zu einem Fehler führt, wenn sich der Benutzer bereits in der Gruppe befindet. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2AddUserToGroupResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen eines Microsoft Exchange-Mitglieds zur Verteilergruppe
Hinzufügen eines Mitglieds (z. B. eines Benutzers) zu einer Exchange-Verteilergruppe. Wenn sich das Mitglied bereits in der Gruppe befindet, wird keine Aktion ausgeführt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | True | string |
Die Identität der Verteilergruppe, der hinzugefügt werden soll. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Hinzuzufügende Member
|
Member | True | string |
Die Identität des Mitglieds, das der Verteilergruppe hinzugefügt werden soll. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeAddDistributionGroupMemberResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen eines Office 365-Mitglieds zur Verteilergruppe
Hinzufügen eines Mitglieds zu einer Microsoft Exchange Online- oder Office 365-Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Verteilergruppenidentität
|
Identity | True | string |
Die Identität der Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe, der hinzugefügt werden soll. Sie können eine Verteilergruppe nach Name, Alias, Distinguished Name (z. B. CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), E-Mail-Adresse oder GUID angeben. |
|
Hinzuzufügende Member
|
Member | True | string |
Die Identität des Mitglieds, das der Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe hinzugefügt werden soll. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Sicherheitsgruppen-Manager-Überprüfung umgehen
|
BypassSecurityGroupManagerCheck | boolean |
Wenn das IA-Connect Agent-Automatisierungskonto kein Besitzer der Verteilergruppe oder E-Mail-aktivierten Sicherheitsgruppe ist, kann die Gruppe nicht entfernt werden. Wenn Sie diese Option auf "true" festlegen, wird die Besitzerüberprüfung umgangen, erfordert jedoch, dass das Automatisierungskonto in der Rollengruppe "Organisationsverwaltung" der Exchange-Rollengruppe enthalten ist oder die Rolle "Rollenverwaltung" zugewiesen ist . Dies ist eine einzelne Rolle, mit der Sie Berechtigungen zum Ändern einer Beliebigen Office 355 Exchange Online-Gruppe erhalten, anstatt Besitzer aller Gruppen zu sein, die Sie ändern müssen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
O365AddDistributionGroupMemberResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Hinzufügen mehrerer Active Directory-Gruppenmitglieder
Fügen Sie einer vorhandenen Active Directory-Gruppe ein oder mehrere Active Directory-Objekte (in der Regel Benutzer, Gruppen oder Computer) hinzu. IA-Connect fügt der Gruppe so viele Mitglieder wie möglich hinzu und berichtet über das Ergebnis. Wenn sich Gruppen- und Gruppenmitglied in verschiedenen Domänen befinden, müssen Sie den Distinguished Name (DN) für Gruppen und Mitglieder angeben. Wenn einige der Objekte bereits Mitglied der Gruppe sind, wird dies als Erfolg gezählt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Gruppenidentität
|
GroupIdentity | string |
Die Identität der Active Directory-Gruppe. Sie können eine Gruppe nach Distinguished Name (z. B. CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName /pre-2K name (z. B. 'Group1') angeben. Sie können keinen Anzeigenamen oder Gruppennamen verwenden (gruppenname ist zwar häufig identisch mit dem Vor-2K-Namen, der verwendet werden kann). |
|
|
Gruppenmitglieder
|
GroupMembersJSON | string |
Eine Liste der Mitglieder (in der Regel Benutzer, Gruppen oder Computer), die der AD-Gruppe im JSON- oder CSV-Format hinzugefügt werden sollen. Beispiel: [{"MemberName": "User 1"}, {"MemberName": "User 2"}] (JSON-Tabellenformat), ["Benutzer 1", "Benutzer 2"] (JSON-Arrayformat) oder Benutzer 1,Benutzer 2 (CSV-Format). Sie können einen Benutzer oder eine Gruppe nach Distinguished Name (z. B. CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID oder SAMAccountName / pre-2K name (z. B. 'User1') angeben. Sie können einen Computer durch Distinguished Name oder Computername (pre-2K) gefolgt von einem $ (z. B. VM01$) angeben. |
|
|
Ausnahme, wenn elemente nicht hinzugefügt werden können
|
ExceptionIfAnyMembersFailToAdd | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn einzelne Member nicht hinzugefügt werden können (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Mitglieder erfolgreich hinzugefügt wurden und wie viele elemente nicht hinzugefügt wurden. |
|
|
Ausnahme, wenn alle Elemente nicht hinzugefügt werden können
|
ExceptionIfAllMembersFailToAdd | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird nur ausgelöst, wenn alle Member nicht hinzugefügt werden (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Mitglieder erfolgreich hinzugefügt wurden und wie viele elemente nicht hinzugefügt wurden. |
|
|
Hinzufügen aller Mitglieder in einem einzelnen Anruf
|
AddAllMembersInASingleCall | boolean |
Wenn dieser Wert auf "true" festgelegt ist, werden alle Mitglieder der Gruppe in einer einzigen Aktion hinzugefügt. Dies ist schneller, aber wenn ein einzelnes Element nicht vorhanden ist oder nicht hinzugefügt werden kann, werden keine Member hinzugefügt, und es wird eine Ausnahme ausgelöst, unabhängig von den Eingabeoptionen für "Ausnahme". Bei Festlegung auf "false" (Standardeinstellung) wird jedes Element einzeln hinzugefügt, und der IA-Connect Agent zählt, wie viele elemente erfolgreich hinzugefügt wurden und wie viele nicht hinzugefügt werden konnten. Wenn Sie Mitglieder zu Gruppen über Domänen hinweg hinzufügen, wird empfohlen, diese Eingabe auf "false" festzulegen. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD-Gruppenmitglieder wurden erfolgreich hinzugefügt
|
ADGroupMembersAddedSuccessfully | integer |
Die Anzahl der Mitglieder, die der AD-Gruppe erfolgreich hinzugefügt wurden. |
|
Ad-Gruppenmitglieder konnten nicht hinzugefügt werden
|
ADGroupMembersFailedToAdd | integer |
Die Anzahl der Mitglieder, die der AD-Gruppe nicht hinzugefügt werden konnten. |
|
Fehlermeldung zum Hinzufügen von AD-Gruppenmitgliedern
|
AddADGroupMembersMasterErrorMessage | string |
Wenn einige Mitglieder der AD-Gruppe nicht hinzugefügt werden konnten und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Ist Azure AD-Benutzer Administratorrolle zugewiesen
Gibt zurück, ob einem Azure Active Directory-Benutzer eine Azure Active Directory-Administratorrolle zugewiesen ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Rollenobjekt-ID oder Anzeigename
|
RoleObjectId | True | string |
Die ID oder der Anzeigename einer Azure Active Directory-Administratorrolle. Sie können eine AAD-Administratorrolle nach Anzeigename (z. B. "Anwendungsentwickler") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Der Benutzer wird der Rolle zugewiesen.
|
UserIsAssignedToRole | boolean |
Gibt an, ob der Benutzer der Azure Active Directory-Administratorrolle zugewiesen ist. |
Ist Benutzer in Azure AD-Benutzergruppe
Gibt zurück, ob ein Benutzer Mitglied einer Azure Active Directory-Gruppe ist. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Gruppenobjekt-ID oder Anzeigename
|
GroupObjectId | True | string |
Die ID oder der Anzeigename einer Azure Active Directory-Gruppe. Sie können eine Gruppe nach Anzeigename (z. B. "Finanzbenutzer") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Der Benutzer befindet sich in gruppe
|
UserIsInGroup | boolean |
Gibt an, ob der Benutzer Mitglied der Azure AD-Gruppe ist. |
Ist das Azure AD PowerShell-Modul installiert
Meldet, ob die für Azure Active Directory erforderlichen PowerShell-Module (auch als Microsoft Entra ID, Azure AD oder AAD bezeichnet) auf dem Computer installiert werden, auf dem der IA-Connect Agent ausgeführt wird. Diese Aktion überprüft die PowerShell-Module Azure AD v2 und Microsoft Graph-Benutzer.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD v2 PowerShell-Modul ist installiert
|
AzureADv2PowerShellModuleInstalled | boolean |
Auf "true" festgelegt, wenn das Azure AD v2 PowerShell-Modul (AzureAD) installiert ist. |
|
Das PowerShell-Modul "Microsoft Graph-Benutzer" ist installiert.
|
MSGraphUsersPowerShellModuleInstalled | boolean |
Wird auf "true" festgelegt, wenn die PowerShell-Module von Microsoft Graph-Benutzern (Microsoft.Graph.Users und Microsoft.Graph.Authentication) installiert sind. |
Ist das Microsoft Exchange Online-Postfach vorhanden
Gibt zurück, ob das angegebene Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) vorhanden ist. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | string |
Die Identität des Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfachs). Sie können ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) nach Active Directory-Objekt-ID, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, E-Mail-Adresse, GUID oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Postfächer gefiltert werden sollen. Allgemeine Eigenschaftennamen sind: Name, Alias, PrimarySMTPAddress, DisplayName. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich gleich oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Wert der Filtereigenschaft "JohnDoe" lauten). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Postfach ist vorhanden
|
MailboxExists | boolean |
True, wenn das Microsoft Exchange Online-Postfach vorhanden ist. False, wenn das Microsoft Exchange Online-Postfach nicht vorhanden ist. |
Ist das Microsoft Exchange-Postfach vorhanden
Gibt zurück, ob das angegebene Exchange-Postfach vorhanden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
|
Name der Filtereigenschaft
|
FilterPropertyName | string |
Geben Sie als Alternative zur Suche nach Identität den Namen der Eigenschaft an, nach der die Postfächer gefiltert werden sollen. Allgemeine Eigenschaftennamen sind: Name, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Wenn Sie einen Filter verwenden, müssen Sie auch die Felder "Filtereigenschaftenvergleich" und "Filtereigenschaftswert" auffüllen. |
|
|
Filtereigenschaftenvergleich
|
FilterPropertyComparison | string |
Wenn Sie den Namen der Filtereigenschaft als Alternative zur Suche nach Identität suchen, geben Sie hier den Vergleichstyp ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Vergleich "gleich" oder "like" lauten). Wenn Sie einen unformatierten Filter (im OPATH-Format) eingeben möchten, wählen Sie einen Vergleichstyp von "Raw: Manuellen Filter eingeben" aus, und geben Sie den vollständigen Filter in das Feld "Filtereigenschaftswert" ein. |
|
|
Filter-Eigenschaftswert
|
FilterPropertyValue | string |
Wenn Sie nach Filter als Alternative zur Suche nach Identität suchen, geben Sie hier den Wert der Filtereigenschaft ein (z. B.: Wenn der Name der Filtereigenschaft "Alias" lautet, kann der Wert der Filtereigenschaft "JohnDoe" lauten). |
|
|
Empfängertypdetails
|
RecipientTypeDetails | string |
Der Typ des postfachs, nach dem gesucht werden soll. Wenn dieses Feld leer bleibt, werden alle Postfachtypen in die Suche einbezogen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Postfach ist vorhanden
|
MailboxExists | boolean |
True, wenn das Exchange-Postfach vorhanden ist. False, wenn das Exchange-Postfach nicht vorhanden ist. |
Ist mit Active Directory verbunden
Meldet, ob IA-Connect mit Active Directory verbunden ist. Standardmäßig ist IA-Connect automatisch mit der Domäne verbunden, in der der Computer, auf dem der IA-Connect Agent ausgeführt wird, mitglied ist, wobei das Konto verwendet wird, in dem der IA-Connect Agent ausgeführt wird. Verwenden Sie die Aktion "Mit Active Directory mit Anmeldeinformationen verbinden", um eine Verbindung mit alternativen Anmeldeinformationen oder mit einer alternativen Domäne herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Verbunden mit Active Directory
|
ActiveDirectoryRunspaceOpen | boolean |
Auf "true" festgelegt, wenn IA-Connect mit Active Directory verbunden ist. Dies sollte immer "true" zurückgeben, da IA-Connect automatisch mit der Domäne verbunden ist, von der der Computer, auf dem der Agent ausgeführt wird, Mitglied ist. |
|
Lokale Passthroughverbindung
|
ActiveDirectoryLocalPassthroughRunspace | boolean |
Wird auf "true" festgelegt, wenn IA-Connect mit der Domäne verbunden ist, in der der Computer, auf dem der IA-Connect Agent ausgeführt wird, Mitglied ist, unter Verwendung des Kontos, in dem der IA-Connect Agent ausgeführt wird. |
|
Active Directory-Server
|
ActiveDirectoryServer | string |
Der Active Directory-Server, der mit dem Server verbunden ist. Wenn leer, verwendet IA-Connect den standardmäßigen Active Directory-Domänencontroller für den Computer, auf dem der Agent ausgeführt wird, basierend auf den AD-Standorteinstellungen. |
|
Active Directory-DNS-Domäne
|
ActiveDirectoryDNSDomain | string |
Die Active Directory-DNS-Domäne für die Domäne IA-Connect ist verbunden. Wenn leer, verwendet IA-Connect die Standard-Active Directory-Domäne für den Computer, auf dem der Agent ausgeführt wird. Beispiel: mydomain.local. |
|
Active Directory-Domänen-DN
|
ActiveDirectoryDomainDN | string |
Die Active Directory-Domänen-DN für die Domäne IA-Connect ist verbunden. Wenn leer, verwendet IA-Connect die Standard-Active Directory-Domäne für den Computer, auf dem der Agent ausgeführt wird. Beispiel: DC=mydomain,DC=local. |
|
Authentifizierter Benutzername
|
AuthenticatedUsername | string |
Der authentifizierte Benutzername IA-Connect wird für die Verbindung mit Active Directory verwendet. Wenn leer, verwendet IA-Connect das Konto, auf dem der IA-Connect Agent ausgeführt wird. |
Ist mit Azure AD verbunden
Meldet, ob IA-Connect mit Azure Active Directory verbunden ist (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Verwenden Sie eine der Aktionen "Mit Azure AD verbinden", um eine Verbindung herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Abrufen der PowerShell-Runspace-Prozess-ID
|
RetrievePowerShellRunSpacePID | boolean |
Wenn "true" festgelegt ist: Der IA-Connect Agent ruft Informationen zur Prozess-ID des Prozesses ab, der den PowerShell-Runspace hostet. Diese Informationen werden in den Ausgaben "PowerShell runspace process ID" und "Is Agent hosting PowerShell runspace" bereitgestellt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD PowerShell-Runspace ist geöffnet
|
AzureADv2RunspaceOpen | boolean |
Auf "true" festgelegt, wenn IA-Connect mit Azure AD verbunden ist. Dies kann die PowerShell-Module Azure AD v2 oder Microsoft Graph-Benutzer verwenden. |
|
Azure AD-API
|
AzureADAPI | string |
Der Name der verwendeten Azure AD-API. Dies ist auf "AzureADv2" festgelegt, wenn Sie das Azure AD v2 PowerShell-Modul oder "MSGraphUsersPS" verwenden, wenn Sie das PowerShell-Modul "Microsoft Graph-Benutzer" verwenden. |
|
PowerShell-Runspace-Prozess-ID
|
PowerShellRunspacePID | integer |
Die PowerShell-Runspace-Prozess-ID (PID). Wenn der IA-Connect Agent den PowerShell-Runspace hosten soll, ist dieser Wert die PID des IA-Connect-Agents. Wenn der PowerShell-Runspace isoliert ist, ist dieser Wert die PID des Isolationsprozesses. |
|
Ist Agent hosten PowerShell-Runspace
|
IsAgentHostingPowerShellRunSpace | boolean |
Gibt true zurück, wenn der IA-Connect Agent den PowerShell-Runspace hostet (d. h. wenn die "PowerShell-Runspace-Prozess-ID" der Agent-PID ist). |
Ist mit Microsoft Exchange verbunden
Meldet, ob IA-Connect mit einem Microsoft Exchange-Server verbunden ist. Verwenden Sie die Aktion "Mit Microsoft Exchange verbinden", um eine Verbindung herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Testen der Kommunikation
|
TestCommunications | boolean |
Wenn dieser Wert auf "false" festgelegt ist: IA-Connect stellt keinen Testbefehl aus, um zu bestätigen, dass die Exchange-Serververbindung funktionsfähig ist und auf den zuletzt bekannten Zustand angewiesen ist. Bei Festlegung auf "true" (Standard): IA-Connect gibt einen Testbefehl aus, um zu bestätigen, dass die Exchange-Serververbindung funktionsfähig ist. |
|
|
Abrufen der PowerShell-Runspace-Prozess-ID
|
RetrievePowerShellRunSpacePID | boolean |
Wenn "true" festgelegt ist: Der IA-Connect Agent ruft Informationen zur Prozess-ID des Prozesses ab, der den PowerShell-Runspace hostet. Diese Informationen werden in den Ausgaben "PowerShell runspace process ID" und "Is Agent hosting PowerShell runspace" bereitgestellt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Verbunden mit Microsoft Exchange
|
ExchangeRunspaceOpen | boolean |
Auf "true" festgelegt, wenn IA-Connect mit Microsoft Exchange verbunden ist. |
|
Exchange-Verbindungsmethode
|
ExchangeConnectionMethod | string |
Enthält die aktuelle Exchange-Verbindungsmethode: Lokal oder Remote. |
|
PowerShell-Runspace-Prozess-ID
|
PowerShellRunspacePID | integer |
Die PowerShell-Runspace-Prozess-ID (PID). Wenn der IA-Connect Agent den PowerShell-Runspace hosten soll, ist dieser Wert die PID des IA-Connect-Agents. Wenn der PowerShell-Runspace isoliert ist, ist dieser Wert die PID des Isolationsprozesses. |
|
Ist Agent hosten PowerShell-Runspace
|
IsAgentHostingPowerShellRunSpace | boolean |
Gibt true zurück, wenn der IA-Connect Agent den PowerShell-Runspace hostet (d. h. wenn die "PowerShell-Runspace-Prozess-ID" der Agent-PID ist). |
Ist mit Office 365 verbunden
Meldet, ob IA-Connect mithilfe der Office 365 PowerShell-Module mit Office 365 verbunden ist. Verwenden Sie die Aktion "Mit Office 365 verbinden", um eine Verbindung herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Testen der Kommunikation
|
TestCommunications | boolean |
Wenn dieser Wert auf "false" festgelegt ist: IA-Connect stellt keinen Testbefehl aus, um zu bestätigen, dass die Office 365 Exchange Online-Verbindung funktionsfähig ist und sich auf den letzten bekannten Zustand stützt. Bei Festlegung auf "true" (Standard): IA-Connect gibt einen Testbefehl aus, um zu bestätigen, dass die Office 365 Exchange Online-Verbindung funktionsfähig ist. |
|
|
Abrufen der PowerShell-Runspace-Prozess-ID
|
RetrievePowerShellRunSpacePID | boolean |
Wenn "true" festgelegt ist: Der IA-Connect Agent ruft Informationen zur Prozess-ID des Prozesses ab, der den PowerShell-Runspace hostet. Diese Informationen werden in den Ausgaben "PowerShell runspace process ID" und "Is Agent hosting PowerShell runspace" bereitgestellt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Verbunden mit Office 365
|
O365RunspaceOpen | boolean |
"true", wenn IA-Connect mit Office 365 mithilfe der Office 365 PowerShell-Module verbunden ist. |
|
Office 365-Verbindungsmethode
|
Office365ConnectionMethod | string |
Enthält die aktuelle Office 365-Verbindungsmethode: EXOV1 oder EXOV2. |
|
PowerShell-Runspace-Prozess-ID
|
PowerShellRunspacePID | integer |
Die PowerShell-Runspace-Prozess-ID (PID). Wenn der IA-Connect Agent den PowerShell-Runspace hosten soll, ist dieser Wert die PID des IA-Connect-Agents. Wenn der PowerShell-Runspace isoliert ist, ist dieser Wert die PID des Isolationsprozesses. |
|
Ist Agent hosten PowerShell-Runspace
|
IsAgentHostingPowerShellRunSpace | boolean |
Gibt true zurück, wenn der IA-Connect Agent den PowerShell-Runspace hostet (d. h. wenn die "PowerShell-Runspace-Prozess-ID" der Agent-PID ist). |
Klonen der Active Directory-Benutzergruppenmitgliedschaft
Fügt den Active Directory-Zielbenutzer zu den gleichen Active Directory-Gruppen hinzu, bei denen der erste Benutzer Mitglied ist, abzüglich der primären Gruppe (in der Regel 'Domänenbenutzer'), da es technisch keine Mitgliedschaft ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Quellbenutzeridentität
|
SourceUserIdentity | True | string |
Die Identität des Active Directory-Quellbenutzers (der Benutzer, aus dem Gruppen kopiert werden sollen). Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Zielbenutzeridentität
|
DestinationUserIdentity | True | string |
Die Identität des Active Directory-Zielbenutzers (dem Benutzer, dem die Gruppen hinzugefügt werden sollen). Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
AD-Gruppen wurden erfolgreich hinzugefügt.
|
ADGroupsAddedSuccessfully | integer |
Die Anzahl der AD-Gruppen, zu der der Zielbenutzer erfolgreich hinzugefügt wurde. |
|
AD-Gruppen konnten nicht hinzugefügt werden
|
ADGroupsFailedToAdd | integer |
Die Anzahl der AD-Gruppen, denen der Zielbenutzer nicht hinzugefügt werden konnte. |
|
Fehlermeldung zum Hinzufügen von AD-Gruppen
|
AddADGroupsMasterErrorMessage | string |
Wenn der Zielbenutzer einige der AD-Gruppen nicht hinzufügen konnte, enthält diese Fehlermeldung Details zum Problem. |
Klonen von Active Directory-Benutzereigenschaften
Konfiguriert die angegebenen Eigenschaften/Attribute des Active Directory-Quellbenutzers für den Active Directory-Zielbenutzer.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Quellbenutzeridentität
|
SourceUserIdentity | True | string |
Die Identität des Active Directory-Quellbenutzers (der Benutzer, aus dem Attribute kopiert werden sollen). Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Zielbenutzeridentität
|
DestinationUserIdentity | True | string |
Die Identität des Active Directory-Zielbenutzers (der Benutzer, in den Attribute kopiert werden sollen). Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Zu klonende Eigenschaften
|
PropertiesToClone | True | string |
Eine durch Trennzeichen getrennte Liste von Benutzereigenschaften, die vom Quellbenutzer in den Zielbenutzer kopiert werden sollen. Allgemeine Eigenschaften zum Klonen sind: Stadt, Unternehmen, Land, Abteilung, Beschreibung, Division, aktiviert, Homedirectory, Homedrive, Homephone, Manager, Office, Organisation, Postleitzahl, Profilpath, Skriptpath, Bundesland, Straße. |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryCloneADUserPropertiesResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Verbindung mit Active Directory trennen
Wenn Sie die Aktion "Active Directory PowerShell-Runspace mit Anmeldeinformationen öffnen" zum Ausführen von Active Directory PowerShell-Befehlen als alternatives Benutzerkonto oder zu einer alternativen Domäne verwendet haben, gibt diese Aktion den IA-Connect Agent an das Standardverhalten der Ausführung von Active Directory-Aktionen als Benutzerkonto zurück, als der IA-Connect Agent ausgeführt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
CloseActiveDirectoryPowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Verbindung mit Azure AD trennen
Trennt IA-Connect von Azure Active Directory (auch bekannt als Microsoft Entra ID, Azure AD oder AAD). Sie können Azure AD-Aktionen erst dann erneut ausstellen, wenn Sie die Verbindung erneut herstellen. Diese Aktion verwendet PowerShell-Module für Azure AD v2- oder Microsoft Graph-Benutzer, je nachdem, welches zum ursprünglichen Herstellen einer Verbindung verwendet wurde.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
CloseAzureADv2PowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Verbindung mit Microsoft Exchange trennen
Trennt IA-Connect von einem Microsoft Exchange-Server (verbunden mit der Aktion "Mit Microsoft Exchange verbinden"). Sie können Microsoft Exchange PowerShell-Aktionen erst dann erneut ausstellen, wenn Sie die Verbindung erneut herstellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
CloseExchangePowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Verbindung mit Office 365 trennen
Trennt IA-Connect von Office 365 mithilfe der Office 365 PowerShell-Module (verbunden mit der Aktion "Mit Office 365 verbinden"). Sie können Office 365 PowerShell-Aktionen erst erneut ausstellen, wenn Sie die Verbindung erneut herstellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
CloseO365PowerShellRunspaceResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Verfügt das Office 365-Postfach über ein Archiv
Meldet, ob ein vorhandenes Postfach in Microsoft Exchange Online über ein Archivpostfach verfügt. Wenn das Postfach nicht vorhanden ist, wird eine Ausnahme ausgelöst.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Postfach verfügt über ein Archiv
|
MailboxHasAnArchive | boolean |
Auf "true" festgelegt, wenn das Postfach über ein Archiv verfügt. |
Verschieben des Active Directory-Benutzers in die OU
Verschiebt einen Active Directory-Benutzer zu einer vorhandenen Active Directory-Organisationseinheit (OU).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Zielpfad
|
TargetPath | True | string |
Der Pfad zur Zielorganisationseinheit (OU) im Distinguished Name-Format (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. MyUsers\London). |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryMoveADUserToOUByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Warten auf ein Office 365-Postfach
Warten Sie, bis ein angegebenes Microsoft Exchange Online- oder Office 365-Postfach vorhanden ist. Dies ist häufig der Fall, wenn Sie auf eine AD-Synchronisierungs- oder Lizenzeinstellung warten, die wirksam wird. Wenn das Postfach bereits vorhanden ist, wird die Aktion sofort erfolgreich zurückgegeben.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die ID eines Microsoft Exchange Online- oder Office 365-Postfachs. Sie können ein Postfach nach Name, Alias, Objekt-ID (z. B. UUID/GUID-Wert), E-Mail-Adresse, GUID, SAMAccountName (sogar Benutzer in nicht active Directory verbundenen Umgebungen) oder Benutzerprinzipalname (User Principal Name, UPN) angeben. |
|
Empfängertypdetails
|
RecipientTypeDetails | string |
Der Typ des postfachs, nach dem gesucht werden soll. Wenn dieses Feld leer bleibt, werden alle Postfachtypen in die Suche einbezogen. |
|
|
Anzahl der zu überprüfenden Male
|
NumberOfTimesToCheck | True | integer |
Die Anzahl der zu überprüfenden Male, bis das Postfach vorhanden ist. Jede Prüfung wird durch eine konfigurierbare Zeitspanne getrennt. |
|
Sekunden zwischen Versuchen
|
SecondsBetweenTries | True | integer |
Anzahl der Sekunden, die zwischen den einzelnen Überprüfungen gewartet werden sollen. |
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
JSON für Suchergebnisse
|
PowerShellJSONOutput | string |
Die Eigenschaften des gefundenen Postfachs, wenn es bereits vorhanden oder nach dem Warten vorhanden ist, im JSON-Format. |
|
Anzahl der gefundenen Postfächer
|
CountOfMailboxesFound | integer |
Die Anzahl der Gefundenen, die der Suchidentität entsprechen. 1 stellt eine erfolgreiche Wartezeit dar (oder das Postfach ist bereits vorhanden). 0 würde das Postfach darstellen, das nicht vorhanden ist, auch nach dem Warten. |
Zurücksetzen der Eigenschaften in einem Microsoft Exchange Online-Postfach
Legen Sie die angegebenen Eigenschaften eines vorhandenen Microsoft Exchange Online- oder Office 365(Remote)-Postfachs auf leer fest. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfachs). Sie können ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) nach Active Directory-Objekt-ID, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, E-Mail-Adresse, GUID oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
Benutzerdefiniertes Attribut 1 zurücksetzen
|
ResetCustomAttribute1 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 2 zurücksetzen
|
ResetCustomAttribute2 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 3 zurücksetzen
|
ResetCustomAttribute3 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 4 zurücksetzen
|
ResetCustomAttribute4 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 5 zurücksetzen
|
ResetCustomAttribute5 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 6 zurücksetzen
|
ResetCustomAttribute6 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 7 zurücksetzen
|
ResetCustomAttribute7 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 8 zurücksetzen
|
ResetCustomAttribute8 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 9 zurücksetzen
|
ResetCustomAttribute9 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 10 zurücksetzen
|
ResetCustomAttribute10 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 11 zurücksetzen
|
ResetCustomAttribute11 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 12 zurücksetzen
|
ResetCustomAttribute12 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 13 zurücksetzen
|
ResetCustomAttribute13 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 14 zurücksetzen
|
ResetCustomAttribute14 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 15 zurücksetzen
|
ResetCustomAttribute15 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeResetRemoteMailboxAttributesResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Zurücksetzen der Eigenschaften in einem Microsoft Exchange-Postfach
Legen Sie die angegebenen Eigenschaften eines vorhandenen Microsoft Exchange-Postfachs auf leer fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Benutzerdefiniertes Attribut 1 zurücksetzen
|
ResetCustomAttribute1 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 2 zurücksetzen
|
ResetCustomAttribute2 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 3 zurücksetzen
|
ResetCustomAttribute3 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 4 zurücksetzen
|
ResetCustomAttribute4 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 5 zurücksetzen
|
ResetCustomAttribute5 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 6 zurücksetzen
|
ResetCustomAttribute6 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 7 zurücksetzen
|
ResetCustomAttribute7 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 8 zurücksetzen
|
ResetCustomAttribute8 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 9 zurücksetzen
|
ResetCustomAttribute9 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 10 zurücksetzen
|
ResetCustomAttribute10 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 11 zurücksetzen
|
ResetCustomAttribute11 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 12 zurücksetzen
|
ResetCustomAttribute12 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 13 zurücksetzen
|
ResetCustomAttribute13 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 14 zurücksetzen
|
ResetCustomAttribute14 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Benutzerdefiniertes Attribut 15 zurücksetzen
|
ResetCustomAttribute15 | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie das benutzerdefinierte Attributfeld zurücksetzen möchten (auf einen leeren Wert festgelegt). |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ExchangeResetMailboxAttributesResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Zurücksetzen des Active Directory-Benutzerkennworts
Setzt das Kennwort eines Active Directory-Benutzers mit einem neuen Kennwort zurück und legt optional Kennworteigenschaften fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Neues Kennwort
|
NewPassword | True | password |
Das neue Kennwort. Dies muss angegeben werden und die Active Directory-Kennwortkomplexitätsregeln erfüllen. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. |
|
Kontokennwort wird gespeichert
|
AccountPasswordIsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss). |
|
|
Festlegen von Benutzerkennworteigenschaften
|
SetUserPasswordProperties | boolean |
Legen Sie "Ja" (Standardeinstellung) fest, wenn Sie zusätzlich zum Ändern des Kennworts angegebene Benutzerkennworteigenschaften festlegen möchten. Benutzerkennworteigenschaften sind "Kennwort bei Anmeldung ändern", "Benutzer kann kennwort nicht ändern" und "Kennwort läuft nie ab". Legen Sie "Nein" fest, um nur das Kennwort des Benutzers zu ändern, wobei die anderen Eingaben für diese Aktion ignoriert werden. |
|
|
Benutzer muss Kennwort bei der nächsten Anmeldung ändern
|
ChangePasswordAtLogon | boolean |
Legen Sie "Ja" (Standardeinstellung) fest, wenn Sie erzwingen möchten, dass das Kennwort geändert wird, wenn er sich anmeldet (d. h. das hier festgelegte neue Kennwort ist ein einmaliges Kennwort, um den Angemeldeten des Benutzers zu erhalten). Legen Sie "Nein" fest, wenn dies das Kennwort ist, das der Benutzer verwendet, bis er es manuell ändert. Wird auf leer/leer festgelegt, um diese Kennwortoption unverändert zu lassen (neu in IA-Connect 9.4). Sie können diese Option nicht gleichzeitig auf "Ja" festlegen, indem Sie entweder "Benutzer kann das Kennwort nicht ändern" oder "Kennwort läuft nie ab" auf "Ja" festlegen. |
|
|
Benutzer kann Kennwort nicht ändern
|
CannotChangePassword | boolean |
Legen Sie "Ja" fest, um zu verhindern, dass der Benutzer sein Kennwort ändern kann. Legen Sie "Nein" (Standardeinstellung) fest, wenn der Benutzer das Kennwort ändern kann. Wird auf leer/leer festgelegt, um diese Kennwortoption unverändert zu lassen (neu in IA-Connect 9.4). Sie können diese Option nicht auf "Ja" gleichzeitig festlegen, wie die Einstellung "Benutzer muss das Kennwort bei der nächsten Anmeldung ändern" in "Ja" festlegen. |
|
|
Kennwort läuft nie ab
|
PasswordNeverExpires | boolean |
Auf "Ja" festlegen, wenn das Kennwort nie abläuft (d. h. der Benutzer wird nie aufgefordert, das Kennwort zu ändern). Legen Sie "Nein" (Standardeinstellung) fest, wenn das Kennwort wie in der Active Directory-Domänenrichtlinie festgelegt ablaufen kann. Wird auf leer/leer festgelegt, um diese Kennwortoption unverändert zu lassen (neu in IA-Connect 9.4). Sie können diese Option nicht auf "Ja" gleichzeitig festlegen, wie die Einstellung "Benutzer muss das Kennwort bei der nächsten Anmeldung ändern" in "Ja" festlegen. |
|
|
Kennwort zweimal zurücksetzen
|
ResetPasswordTwice | boolean |
Legen Sie auf "Ja" fest, um das Kennwort zweimal zurückzusetzen, wobei die erste Zurücksetzung eine Randomisierung des angeforderten neuen Kennworts ist (dieselbe Anzahl von Großbuchstaben, Kleinbuchstaben, Zahlen und dieselben Symbole, aber in einer zufälligen Reihenfolge). Dadurch wird das Risiko einer Pass-the-Hash-Sicherheitsanfälligkeit verringert, wenn Sie diesen Benutzer mit Azure Active Directory synchronisieren. Legen Sie auf "Nein" (Standardeinstellung) fest, um das angeforderte Kennwort festzulegen, ohne zuerst ein zufälliges Kennwort festzulegen. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryResetADUserPasswordByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Zurücksetzen des Azure AD-Benutzerkennworts
Setzt das Kennwort eines Azure Active Directory-Benutzers mit einem neuen Kennwort zurück. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerprinzipalname
|
UserPrincipalName | True | string |
Der Benutzeranmeldungsname in Azure Active Directory. Dies sollte im Allgemeinen im Format "name@domainFQDN" (z. B. "TestUser1@mydomain.onmicrosoft.com") vorliegen. |
|
Neues Kennwort
|
NewPassword | True | password |
Das neue Kennwort. Dies muss angegeben werden und die Azure Active Directory-Kennwortkomplexitätsregeln erfüllen. Wenn es sich um ein "Gespeichertes" Kennwort handelt, geben Sie das Format {IAConnectPassword:StoredPasswordIdentifier} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. Wenn es sich um generische Orchestrator-Anmeldeinformationen handelt, geben Sie das Format {OrchestratorCredential:FriendlyName} ein, und legen Sie die Eingabe des gespeicherten Kennworts auf "true" fest. |
|
Kontokennwort wird gespeichert
|
AccountPasswordIsStoredPassword | boolean |
Wird auf "true" festgelegt, wenn es sich bei dem Kennwort um einen IA-Connect gespeicherten Kennwortbezeichner handelt (z. B. durch die Aktion "Kennwort generieren") oder um eine generische IA-Connect Orchestrator-Anmeldeinformationen (z. B.: Bei Verwendung von IA-Connect mit einem PA-Fluss). |
|
|
Ändern des Kennworts bei der nächsten Anmeldung erzwingen
|
ForceChangePasswordNextLogin | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie erzwingen möchten, sein Kennwort beim nächsten Anmelden zu ändern (d. h. das hier festgelegte neue Kennwort ist ein einmaliges Kennwort, mit dem der Benutzer sich anmelden kann). Auf "false" festgelegt, wenn dies das Kennwort ist, das der Benutzer verwendet, bis er es manuell ändert. |
|
|
Erzwingen der Kennwortrichtlinie
|
EnforceChangePasswordPolicy | boolean |
Legen Sie "true" fest, um die Azure Active Directory-Änderungskennwortrichtlinie zu erzwingen, die (abhängig von Ihrer Umgebung) definieren kann, wie oft der Benutzer sein Kennwort, Kennwortwiederherstellungsoptionen und zusätzliche Sicherheitsüberprüfung ändern soll. Dies kann dazu führen, dass der Benutzer zur Eingabe zusätzlicher Informationen aufgefordert wird. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2ResetAzureADUserPasswordResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Zurücksetzen von Azure AD-Benutzereigenschaften
Setzen Sie allgemeine Eigenschaften eines Azure Active Directory-Benutzers auf einen leeren Wert zurück. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Vorname zurücksetzen
|
ResetFirstName | boolean |
Legen Sie "true" fest, um den Vornamen des Benutzers auf "leer" zurückzusetzen. |
|
|
Nachname zurücksetzen
|
ResetLastName | boolean |
Legen Sie "true" fest, um den Familiennamen /Nachnamen /Nachnamen des Benutzers auf "leer" zurückzusetzen. |
|
|
Ort zurücksetzen
|
ResetCity | boolean |
Legen Sie "true" fest, um den Namen der Stadt zurückzusetzen, in der sich der Benutzer befindet oder in dem sich sein Büro leer befindet. |
|
|
Firmenname zurücksetzen
|
ResetCompanyName | boolean |
Legen Sie "true" fest, um den Namen des Unternehmens zurückzusetzen, für das der Benutzer leer ist. |
|
|
Land oder Region zurücksetzen
|
ResetCountry | boolean |
Legen Sie "true" fest, um das Land oder die Region zurückzusetzen, in dem sich der Benutzer befindet oder in dem sich sein Büro leer befindet. |
|
|
Abteilung zurücksetzen
|
ResetDepartment | boolean |
Legen Sie "true" fest, um den Namen der Abteilung zurückzusetzen, für die der Benutzer innerhalb des Unternehmens arbeitet, auf "leer". |
|
|
Faxnummer zurücksetzen
|
ResetFaxNumber | boolean |
Legen Sie "true" fest, um die Faxtelefonnummer (Faksimile) auf "leer" zurückzusetzen. |
|
|
Position zurücksetzen
|
ResetJobTitle | boolean |
Legen Sie "true" fest, um die Position des Benutzers auf "leer" zurückzusetzen. |
|
|
Zurücksetzen der Mobiltelefonnummer
|
ResetMobilePhone | boolean |
Legen Sie "true" fest, um die Mobiltelefonnummer des Benutzers auf "leer" zurückzusetzen. |
|
|
Office zurücksetzen
|
ResetOffice | boolean |
Legen Sie "true" fest, um den Namen des Büros zurückzusetzen, in dem der Benutzer leer ist. |
|
|
Zurücksetzen der Telefonnummer
|
ResetPhoneNumber | boolean |
Legen Sie "true" fest, um die Telefonnummer des Benutzers auf "leer" zurückzusetzen. |
|
|
Postleitzahl zurücksetzen
|
ResetPostalCode | boolean |
Legen Sie den Wert auf "true" fest, um die Postleitzahl zurückzusetzen, in der sich der Benutzer befindet, oder das Büro, in dem er arbeitet, leer. |
|
|
Bevorzugte Sprache zurücksetzen
|
ResetPreferredLanguage | boolean |
Legen Sie "true" fest, um die bevorzugte Sprache des Benutzers auf "leer" zurückzusetzen. |
|
|
Bundesland oder Provinz zurücksetzen
|
ResetState | boolean |
Legen Sie "true" fest, um den Staat, die Provinz oder das Land zurückzusetzen, in dem sich der Benutzer befindet oder in dem sich sein Büro leer befindet. |
|
|
Straße zurücksetzen
|
ResetStreetAddress | boolean |
Legen Sie den Wert auf "true" fest, um die Straße zurückzusetzen, an der sich der Benutzer befindet, oder seine Büroadresse auf "leer". |
|
|
Verwendungsspeicherort zurücksetzen
|
ResetUsageLocation | boolean |
Legen Sie "true" fest, um den Verwendungsspeicherort auf "leer" zurückzusetzen. Dies ist für Benutzer erforderlich, denen Lizenzen aufgrund einer gesetzlichen Anforderung zugewiesen werden, sodass das Zurücksetzen auf "Leer" wahrscheinlich die Dinge unterbricht. |
|
|
Altersgruppe zurücksetzen
|
ResetAgeGroup | boolean |
Legen Sie "true" fest, um die Altersgruppe des Benutzers für Jugendschutzzwecke auf "leer" zurückzusetzen. |
|
|
Zustimmung zurücksetzen, die für Minderjährige bereitgestellt wird
|
ResetConsentProvidedForMinor | boolean |
Legen Sie auf "true" fest, um zurückzusetzen, ob die Zustimmung für die Minderjährigen, für Jugendschutzzwecke, leer ist. |
|
|
Mitarbeiter-ID zurücksetzen
|
ResetEmployeeId | boolean |
Legen Sie "true" fest, um die Mitarbeiter-ID auf "leer" zurückzusetzen. Sie können dies verwenden, um zwischen jedem Benutzer in Ihrer Organisation eindeutig zu unterscheiden. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2ResetAzureADUserPropertiesResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Zuweisen eines Azure AD-Benutzers zu mehreren Administratorrollen
Weisen Sie einem oder mehreren vorhandenen Azure Active Directory-Administratorrollen einen Azure Active Directory-Benutzer (oder ein anderes Objekt) zu. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Rollenobjekt-IDs oder Anzeigenamen
|
RolesJSON | string |
Eine Liste der Administratorrollen, die dem Benutzer zugewiesen werden sollen, im JSON- oder CSV-Format. Beispiel: [{"Role": "Application Developer"}, {"Role": "Exchange Administrator"}] (JSON-Tabellenformat), ["Anwendungsentwickler", "Exchange-Administrator"] (JSON-Arrayformat) oder Anwendungsentwickler,Exchange-Administrator (CSV-Format). Sie können eine AAD-Administratorrolle nach Anzeigename (z. B. "Anwendungsentwickler") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
|
Ausnahme, wenn rollen nicht zugewiesen werden können
|
ExceptionIfAnyRolesFailToAssign | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird ausgelöst, wenn eine einzelne Azure AD-Administratorrolle nicht zugewiesen werden kann (d. h. 100% Erfolg ist eine Anforderung). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Azure AD-Administratorrollen erfolgreich zugewiesen wurden und wie viele nicht zugewiesen werden konnten. |
|
|
Ausnahme, wenn alle Rollen nicht zugewiesen werden können
|
ExceptionIfAllRolesFailToAssign | boolean |
Wenn "true" festgelegt ist: Eine Ausnahme (Fehler) wird nur ausgelöst, wenn alle Azure AD-Administratorrollen nicht zugewiesen werden (d. h. keine Erfolge und einige Fehler). Wenn keine Ausnahme ausgelöst wird, meldet diese Aktion, wie viele Azure AD-Administratorrollen erfolgreich zugewiesen wurden und wie viele nicht zugewiesen werden konnten. |
|
|
Verzeichnisbereichs-ID
|
DirectoryScopeId | string |
Die Verzeichnisbereichs-ID für alle Rollen, denen zugewiesen wird. Beispiel: /represents the entire tenant, /GUID represents an app registration, /administrativeUnits/GUID represents an administrative unit. |
|
|
Überprüfen von Benutzerrollenmitgliedschaften zuerst
|
CheckUserRoleMembershipsFirst | boolean |
Wenn "true" (Standardeinstellung) festgelegt ist, überprüft IA-Connect die Rollenzuweisungen des Benutzers, bevor er versucht, sie der Rolle zuzuweisen. Wenn der Benutzer der Rolle bereits zugewiesen ist, meldet IA-Connect einfach erfolglos, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, weist IA-Connect den Benutzer sofort der Rolle zu, ohne zu überprüfen, was zu einem Fehler führt, wenn der Benutzer der Rolle bereits zugewiesen ist. |
|
|
Rollen-IDs überprüfen
|
CheckRoleIdsExist | boolean |
Wenn "true" (Standard) und mindestens eine der Rollen im Objekt-ID-Format bereitgestellt wird, überprüft IA-Connect diese Rollen-IDs gültig. Dies wird empfohlen, da die von Azure AD empfangene Fehlermeldung, wenn Sie eine ungültige Objekt-ID angeben, nicht hilfreich ist. Wenn dieser Wert auf "false" festgelegt ist, überprüft IA-Connect nicht die Gültigkeit der bereitgestellten Rollen-IDs, was schneller ist. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Azure AD-Rollen wurden erfolgreich zugewiesen
|
AzureADRolesAssignedSuccessfully | integer |
Die Anzahl der erfolgreich zugewiesenen Azure AD-Rollen. |
|
Azure AD-Rollen konnten nicht zugewiesen werden
|
AzureADRolesFailedToAssign | integer |
Die Anzahl der Azure AD-Rollen, die nicht zugewiesen werden konnten. |
|
Fehlermeldung "Azure AD-Rollen zuweisen"
|
AssignAzureADRolesMasterErrorMessage | string |
Wenn einige Rollen nicht zugewiesen wurden und keine Ausnahme ausgelöst wurde, enthält diese Fehlermeldung Details zum Problem. |
Zuweisen eines Azure AD-Benutzers zur Administratorrolle
Weisen Sie einer vorhandenen Azure Active Directory-Administratorrolle einen Azure Active Directory-Benutzer (oder ein anderes Objekt) zu. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
UserObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Rollenobjekt-ID oder Anzeigename
|
RoleObjectId | True | string |
Die ID oder der Anzeigename einer Azure Active Directory-Administratorrolle. Sie können eine AAD-Administratorrolle nach Anzeigename (z. B. "Anwendungsentwickler") oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Verzeichnisbereichs-ID
|
DirectoryScopeId | string |
Die Verzeichnisbereichs-ID für die Rollenzuweisung. Beispiel: /represents the entire tenant, /GUID represents an app registration, /administrativeUnits/GUID represents an administrative unit. |
|
|
Überprüfen von Benutzerrollenmitgliedschaften zuerst
|
CheckUserRoleMembershipsFirst | boolean |
Wenn "true" (Standardeinstellung) festgelegt ist, überprüft IA-Connect die Rollenzuweisungen des Benutzers, bevor er versucht, sie der Rolle zuzuweisen. Wenn der Benutzer der Rolle bereits zugewiesen ist, meldet IA-Connect einfach erfolglos, ohne etwas tun zu müssen. Wenn dieser Wert auf "false" festgelegt ist, weist IA-Connect den Benutzer sofort der Rolle zu, ohne zu überprüfen, was zu einem Fehler führt, wenn der Benutzer der Rolle bereits zugewiesen ist. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2AssignUserToRoleResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Ändern allgemeiner Active Directory-Benutzereigenschaften
Ändern allgemeiner Eigenschaften eines Active Directory-Benutzers. Sie können eigenschaften nur Werte zuweisen und nicht auf "leer" festlegen. Verwenden Sie die Aktion "Active Directory-Benutzerzeichenfolgeneigenschaften ändern", um Eigenschaften auf "Leer" festzulegen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Stadt
|
City | string |
Die Eigenschaft "Ort" des Benutzers (auf der Registerkarte "Adresse" in AD-Benutzern und -Computern). |
|
|
Firma
|
Company | string |
Die Eigenschaft "Unternehmen" des Benutzers (auf der Registerkarte "Organisation" in AD-Benutzern und -Computern). |
|
|
Landescode
|
Country | string |
Die Eigenschaft "Land" des Benutzers (auf der Registerkarte "Adresse" in AD-Benutzern und -Computern). Dies muss ein zweistellige Ländercode sein (z. B. GB für Vereinigtes Königreich, USA für Vereinigte Staaten, FR für Frankreich, ES für Spanien, JP für Japan). Dies ist der Eigenschaft "c" im Active Directory-Schema zugeordnet. IA-Connect ordnet "Ländercode" nicht automatisch "Länderzeichenfolge" und "Wert für Land ISO 3166" zu, sodass Sie eine Nachschlagetabelle verwenden müssen. |
|
|
Zeichenfolge "Land"
|
CountryString | string |
Der vollständige Name der Eigenschaft "Land" des Benutzers (auf der Registerkarte "Adresse" in AD-Benutzern und -Computern). Dies ist die vollständige lokalisierte Anzeigezeichenfolge (z. B. "Vereinigtes Königreich", "Vereinigte Staaten", "Frankreich", "Spanien" oder "Japan"). Dies ist der Eigenschaft "co" im Active Directory-Schema zugeordnet. IA-Connect wird "Länderzeichenfolge" nicht automatisch "Ländercode" und "Wert für Land ISO 3166" zugeordnet, sodass Sie eine Nachschlagetabelle verwenden müssen. |
|
|
Iso 3166-Wert des Landes
|
CountryISO3166 | string |
Der ISO3166 Code für die Eigenschaft "Land" des Benutzers (auf der Registerkarte "Adresse" in AD-Benutzern und -Computern). Dies ist ein 3-stelliger ganzzahliger Wert (z. B. 826 für Großbritannien, 840 für Vereinigte Staaten, 250 für Frankreich, 724 für Spanien, 392 für Japan). Dies ist der Eigenschaft "countryCode" im Active Directory-Schema zugeordnet. IA-Connect wird "Land ISO 3166-Wert" nicht automatisch "Ländercode" und "Länderzeichenfolge" zugeordnet, sodass Sie eine Nachschlagetabelle verwenden müssen. |
|
|
Abteilung
|
Department | string |
Die Eigenschaft "Abteilung" des Benutzers (auf der Registerkarte "Organisation" in AD-Benutzern und -Computern). |
|
|
Description
|
Description | string |
Die Eigenschaft "Beschreibung" des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Anzeigename
|
DisplayName | string |
Der Anzeigename des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
E-Mail-Adresse
|
EmailAddress | string |
Die Eigenschaft "E-Mail" des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Vorname
|
GivenName | string |
Der Vorname des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Private Telefonnummer
|
HomePhone | string |
Die "Private" Telefonnummerneigenschaft des Benutzers (auf der Registerkarte "Telefone" in AD-Benutzern und -Computern). |
|
|
Initials
|
Initials | string |
Die Initialen des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
IP-Telefonnummer
|
IPPhone | string |
Die Eigenschaft "IP-Telefon" des Benutzers (auf der Registerkarte "Telefone" in AD-Benutzern und -Computern). |
|
|
Leiter
|
Manager | string |
Die Manager-Eigenschaft des Benutzers (auf der Registerkarte "Organisation" in AD-Benutzern und -Computern). Sie können einen Manager im Distinguished Name-Format (z. B. CN=MrBig,OU=London,DC=mydomain,DC=local), GUID-Format, SID oder SAMAccountName (z. B. 'MrBig') angeben. |
|
|
Mobiltelefonnummer
|
MobilePhone | string |
Die Eigenschaft "Mobiltelefonnummer" des Benutzers (auf der Registerkarte "Telefone" in AD-Benutzern und -Computern). |
|
|
Hinweise
|
Notes | string |
Die Eigenschaft "Notizen" des Benutzers (auf der Registerkarte "Telefone" in AD-Benutzern und -Computern). Dies ist der Eigenschaft "info" im Active Directory-Schema zugeordnet. |
|
|
Büro
|
Office | string |
Die Office-Eigenschaft des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Telefonnummer (Office)
|
OfficePhone | string |
Die Eigenschaft "Telefonnummer" des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Postleitzahl / Postleitzahl
|
PostalCode | string |
Die Eigenschaft "Postleitzahl" des Benutzers (auf der Registerkarte "Adresse" in AD-Benutzern und -Computern). |
|
|
Profilpfad
|
ProfilePath | string |
Die Eigenschaft "Profilpfad" des Benutzers (auf der Registerkarte "Profil" in AD-Benutzern und -Computern). |
|
|
Anmeldeskript
|
ScriptPath | string |
Die Eigenschaft "Anmeldeskript" des Benutzers (auf der Registerkarte "Profil" in AD-Benutzern und -Computern). |
|
|
Bundesland /Provinz
|
State | string |
Die Eigenschaft "Bundesland/Provinz" des Benutzers (auf der Registerkarte "Adresse" in AD-Benutzern und -Computern). |
|
|
Anschrift
|
StreetAddress | string |
Die Eigenschaft "Straße der Adresse" des Benutzers (auf der Registerkarte "Adresse" in AD-Benutzern und -Computern). |
|
|
Nachname
|
Surname | string |
Die Eigenschaft "Nachname" des Benutzers (auf der Registerkarte "Allgemein" in AD-Benutzern und -Computern). |
|
|
Berufsbezeichnung
|
Title | string |
Die Eigenschaft "Position" des Benutzers (auf der Registerkarte "Organisation" in AD-Benutzern und -Computern). |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryModifyADUserPropertiesResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Ändern der booleschen Active Directory-Benutzereigenschaft
Ändern Einer einzelnen booleschen Eigenschaft (true /false) eines Active Directory-Benutzers. Auf diese Weise können Sie eine sehr bestimmte Benutzereinstellung ändern, einschließlich benutzerdefinierter Eigenschaften.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Eigenschaftsname
|
PropertyName | True | string |
Der Name der zu ändernden einzelnen Benutzereigenschaft. Allgemeine boolesche Eigenschaften sind: enabled, mTSAllowLogon, msExchHideFromAddressLists. |
|
Eigenschaftswert
|
PropertyValue | boolean |
Der true/false-Wert, der der angegebenen Eigenschaft zugewiesen werden soll. Wenn Sie den Wert auf NULL festlegen müssen, verwenden Sie stattdessen die Aktion "Active Directory-Benutzerzeichenfolgeneigenschaften ändern", und legen Sie "Wert ersetzen" auf "Ja" fest. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryModifyADUserBooleanPropertyByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Ändern des Active Directory-Benutzerstartordners
Legt den Startordner /Verzeichnis/Laufwerk für einen Active Directory-Benutzer fest.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Startlaufwerk
|
HomeDrive | string |
Wenn sich das Startverzeichnis/der Ordner in einer Netzwerkfreigabe befindet, geben Sie einen Laufwerkbuchstaben an, der diesem Speicherort zugeordnet wird. Der Laufwerkbuchstaben ist in der Regel ein einzelnes Zeichen zwischen "F" und "Z". Wenn das Startverzeichnis/ordner lokal ist, lassen Sie diesen Wert leer. Wenn Sie das Startverzeichnis/den Ordner leer festlegen, lassen Sie diesen Wert auch leer. |
|
|
Startverzeichnis
|
HomeDirectory | string |
Geben Sie den Pfad für den Startordner/das Verzeichnis an. Wenn Sie auch einen Startlaufwerkbuchstaben angeben, wird das Startlaufwerk diesem Ordner /Verzeichnis zugeordnet. Wenn Sie das Startverzeichnis/den Ordner auf "Leer" festlegen, legen Sie diesen Wert auf "leer" fest. |
|
|
Erstellen des Ordners
|
CreateFolder | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie den Startordner /das Verzeichnis erstellen möchten, wenn er nicht vorhanden ist. |
|
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectorySetADUserHomeFolderByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Ändern einer Microsoft Exchange Online-Postfach-E-Mail-Adressen
Ändern Sie die E-Mail-Adressen in einem vorhandenen Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach). Sie können primäre und Alias-E-Mail-Adressen hinzufügen, entfernen und ersetzen. Die Anforderung wird über Ihren lokalen Microsoft Exchange-Server gesendet, der für eine Hybridbereitstellung eingerichtet werden muss.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange Online- oder Office 365-Postfachs (Remotepostfachs). Sie können ein Microsoft Exchange Online- oder Office 365-Postfach (Remotepostfach) nach Active Directory-Objekt-ID, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, E-Mail-Adresse, GUID oder Benutzerprinzipalname (USER Principal Name, UPN) angeben. |
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist. Verwenden Sie stattdessen "Alias" (und die Richtlinie erstellt die primäre SMTP-Adresse aus dem Alias), oder deaktivieren Sie die E-Mail-Adressrichtlinie. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Hinzuzufügende E-Mail-Adressen
|
EmailAddressesToAddList | array of string |
Eine Liste zusätzlicher (nicht primärer) E-Mail-Adressen, die dem Postfach zugewiesen werden sollen. |
|
|
Ersetzen von E-Mail-Adressen
|
ReplaceEmailAddresses | boolean |
Legen Sie diesen Wert auf "true" fest, wenn die angegebene Liste der E-Mail-Adressen alle vorhandenen E-Mail-Adressen ersetzen soll (nicht einschließlich der primären SMTP-Adresse). Legen Sie diesen Wert auf "false" fest, wenn die angegebene Liste der E-Mail-Adressen allen vorhandenen Adressen hinzugefügt werden soll. |
|
|
Zu entfernende E-Mail-Adressen
|
EmailAddressesToRemoveList | array of string |
Eine Liste zusätzlicher (nicht primärer) E-Mail-Adressen, die aus dem Postfach entfernt werden sollen (sofern sie vorhanden sind). Dies hat nur einen Zweck, wenn "E-Mail-Adressen ersetzen" auf "false" festgelegt ist oder wenn Sie keine E-Mail-Adressen hinzufügen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Postfach-E-Mail-Adressen
|
MailboxEmailAddresses | array of string |
Die E-Mail-Adressen des Postfachs, nachdem die Änderungsaktion ausgeführt wurde. Die primäre SMTP-E-Mail-Adresse wird als SMTP:emailaddress, sekundäre (Proxy)-SMTP-E-Mail-Adressen als smtp:emailaddress angezeigt, X.400-E-Mail-Adressen werden als x400:address und Exchange Unified Messaging (EUM)-Adressen als "eum:address" angezeigt. |
Ändern einer Microsoft Exchange-Postfach-E-Mail-Adressen
Ändern Sie die E-Mail-Adressen in einem Microsoft Exchange-Postfach. Sie können primäre und Alias-E-Mail-Adressen hinzufügen, entfernen und ersetzen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Postfachidentität
|
Identity | True | string |
Die Identität des Microsoft Exchange-Postfachs. Sie können ein Postfach nach Name, Alias, Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName oder User Principal Name (UPN) angeben. |
|
Alias
|
Alias | string |
Der Exchange-Alias (auch als E-Mail-Spitzname bezeichnet) für den Benutzer. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wird dies verwendet, um die Namenskomponente der primären SMTP-E-Mail-Adresse (z. B. ) zu generieren. alias@mydomain.com Wenn die E-Mail-Adressrichtlinie nicht aktiviert ist, sollten Sie stattdessen die primäre SMTP-Adresse festlegen. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
Primäre SMTP-Adresse
|
PrimarySmtpAddress | string |
Die primäre Absender-E-Mail-Adresse, die für den Empfänger verwendet wird. Sie können dies wahrscheinlich nicht festlegen, wenn die "E-Mail-Adressrichtlinie" aktiviert ist. Verwenden Sie stattdessen "Alias" (und die Richtlinie erstellt die primäre SMTP-Adresse aus dem Alias), oder deaktivieren Sie die E-Mail-Adressrichtlinie. Lassen Sie keinen Wert leer, wenn Sie den aktuellen Wert nicht ändern möchten. |
|
|
E-Mail-Adressrichtlinie aktiviert
|
EmailAddressPolicyEnabled | boolean |
Legen Sie diesen Wert auf "true" fest, wenn Sie E-Mail-Adressen basierend auf der auf diesen Empfänger angewendeten E-Mail-Adressrichtlinie automatisch aktualisieren möchten. Wenn die E-Mail-Adressrichtlinie aktiviert ist, wirkt sich dies in der Regel auf die Möglichkeit aus, die primäre SMTP-Adresse festzulegen. Legen Sie auf "false" fest, um das Feature zu deaktivieren, sodass Sie vollzugriff haben, um E-Mail-Adressen manuell festzulegen. Lassen Sie den Wert leer, wenn Sie diese Option nicht festlegen möchten (d. h. beim vorhandenen oder Standardwert bleiben). |
|
|
Hinzuzufügende E-Mail-Adressen
|
EmailAddressesToAddList | array of string |
Eine Liste zusätzlicher (nicht primärer) E-Mail-Adressen, die dem Postfach zugewiesen werden sollen. |
|
|
Ersetzen von E-Mail-Adressen
|
ReplaceEmailAddresses | boolean |
Legen Sie diesen Wert auf "true" fest, wenn die angegebene Liste der E-Mail-Adressen alle vorhandenen E-Mail-Adressen ersetzen soll (nicht einschließlich der primären SMTP-Adresse). Legen Sie diesen Wert auf "false" fest, wenn die angegebene Liste der E-Mail-Adressen allen vorhandenen Adressen hinzugefügt werden soll. |
|
|
Zu entfernende E-Mail-Adressen
|
EmailAddressesToRemoveList | array of string |
Eine Liste zusätzlicher (nicht primärer) E-Mail-Adressen, die aus dem Postfach entfernt werden sollen (sofern sie vorhanden sind). Dies hat nur einen Zweck, wenn "E-Mail-Adressen ersetzen" auf "false" festgelegt ist oder wenn Sie keine E-Mail-Adressen hinzufügen. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Postfach-E-Mail-Adressen
|
MailboxEmailAddresses | array of string |
Die E-Mail-Adressen des Postfachs, nachdem die Änderungsaktion ausgeführt wurde. Die primäre SMTP-E-Mail-Adresse wird als SMTP:emailaddress, sekundäre (Proxy)-SMTP-E-Mail-Adressen als smtp:emailaddress angezeigt, X.400-E-Mail-Adressen werden als x400:address und Exchange Unified Messaging (EUM)-Adressen als "eum:address" angezeigt. |
Ändern von Active Directory-Benutzerzeichenfolgeneigenschaften
Ändern einzelner Zeichenfolgeneigenschaften eines Active Directory-Benutzers. Auf diese Weise können Sie sehr spezifische Benutzereinstellungen ändern, einschließlich benutzerdefinierter Eigenschaften. Sie können auch einzelne Benutzereigenschaften auf leer festlegen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzeridentität
|
UserIdentity | True | string |
Die Identität des Active Directory-Benutzers. Sie können einen Benutzer durch Distinguished Name (z. B. CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName / pre-2K name (z. B. 'User1') oder Name (z. B. 'User1') oder Name (z. B. 'User1') angeben. |
|
Eigentum
|
Property | string | ||
|
Wert
|
Value | string | ||
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Wert ersetzen
|
ReplaceValue | boolean |
Legen Sie den Wert auf "true" fest, um die Werte zu ersetzen. Legen Sie den Wert auf "false" fest, um den Wert hinzuzufügen. Das Hinzufügen funktioniert nicht, wenn der Wert bereits vorhanden ist (dies wirkt sich nur auf benutzerdefinierte Eigenschaften aus), während er zum Erstellen eines neuen Werts oder zum Ersetzen eines vorhandenen Werts verwendet werden kann. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
ActiveDirectoryModifyADUserStringPropertyByIdentityResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Ändern von Azure AD-Benutzereigenschaften
Ändern sie allgemeine Eigenschaften eines Azure Active Directory-Benutzers. Sie können Eigenschaften nur Werte zuweisen, sie nicht auf "leer" festlegen, da ein leerer Wert als Absicht interpretiert wird, den Wert unverändert zu lassen. Diese Aktion verwendet Azure AD v2- oder Microsoft Graph-Benutzer-PowerShell-Module, je nachdem, welches verwendet wurde, um eine Verbindung mit Azure herzustellen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzerobjekt-ID oder UPN
|
ObjectId | True | string |
Die ID eines Azure Active Directory-Benutzers. Sie können einen Benutzer über UPN (z. B. user@mydomain.onmicrosoft.com) oder ObjectId (z. B. UUID/GUID-Wert) angeben. |
|
Vorname
|
FirstName | string |
Der Vorname des Benutzers. |
|
|
Nachname
|
LastName | string |
Der Familienname/Nachname/Nachname des Benutzers. |
|
|
Anzeigename
|
DisplayName | string |
Der vollständige Anzeigename für diesen Benutzer. |
|
|
Stadt
|
City | string |
Der Name der Stadt, in der sich der Benutzer befindet oder wo sich sein Büro befindet. |
|
|
Unternehmensname
|
CompanyName | string |
Der Name des Unternehmens, für das der Benutzer arbeitet. |
|
|
Land oder Region
|
Country | string |
Das Land oder die Region, in dem sich der Benutzer befindet oder in dem sich sein Büro befindet. |
|
|
Abteilung
|
Department | string |
Der Name der Abteilung, für die der Benutzer innerhalb des Unternehmens arbeitet. |
|
|
Faxnummer
|
FaxNumber | string |
Faxnummer des Benutzers (Faksimile). |
|
|
Berufsbezeichnung
|
JobTitle | string |
Die Position des Benutzers. |
|
|
Mobiltelefonnummer
|
MobilePhone | string |
Die Mobiltelefonnummer des Benutzers. |
|
|
Büro
|
Office | string |
Der Standort des Büros, in dem der Benutzer arbeitet. |
|
|
Telefonnummer
|
PhoneNumber | string |
Die Telefonnummer des Benutzers. |
|
|
Postleitzahl
|
PostalCode | string |
Die Postleitzahl, in der sich der Benutzer befindet, oder das Büro, in dem er arbeitet. |
|
|
Bevorzugte Sprache
|
PreferredLanguage | string |
Die bevorzugte Sprache des Benutzers. Dies wird in der Regel als zwei Buchstaben-Sprachcode (ISO 639-1) eingegeben, gefolgt von einem Gedankenstrich, gefolgt von einem zwei buchstabenigen Ländercode (ISO 3166). Beispiel: en-US, en-GB, fr-FR, ja-JP. |
|
|
Bundesland oder Kanton
|
State | string |
Der Staat, die Provinz oder das Land, in dem sich der Benutzer befindet oder wo sich sein Büro befindet. |
|
|
Anschrift
|
StreetAddress | string |
Die Adresse, an der sich der Benutzer befindet, oder seine Büroadresse. |
|
|
Verwendungsstandort
|
UsageLocation | string |
Ein Ländercode aus zwei Buchstaben (ISO 3166). Erforderlich für Benutzer, denen Lizenzen zugewiesen werden, aufgrund einer gesetzlichen Anforderung. Beispiel: USA (USA), JP (Japan), GB (Vereinigtes Königreich), FR (Frankreich), IN (Indien). Siehe https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes. |
|
|
Altersgruppe
|
AgeGroup | string |
Die Altersgruppe des Benutzers zu Jugendschutzzwecken. |
|
|
Zustimmung für Minderjährige vorgesehen
|
ConsentProvidedForMinor | string |
Wenn die "Altersgruppe" "Minderjährige" ist, können Sie in diesem Feld angeben, ob die Zustimmung für den Minderjährigen für Jugendschutzzwecke vorgesehen wurde. |
|
|
E-Mail-Spitzname
|
MailNickName | string |
Der E-Mail-Spitzname des Benutzers. |
|
|
Mitarbeiter-ID
|
EmployeeId | string |
Die Mitarbeiter-ID. Sie können dies verwenden, um zwischen jedem Benutzer in Ihrer Organisation eindeutig zu unterscheiden. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Befehlsergebnis
|
AzureADv2SetAzureADUserResult | boolean |
Das Ergebnis des Befehls (Erfolg oder Fehler). |
|
Fehlermeldung
|
ErrorMessage | string |
Wenn der Befehl nicht erfolgreich war, enthält dies die Fehlermeldung, die zurückgegeben wurde. |
Überprüfen, ob die Active Directory-OU vorhanden ist
Meldet, ob eine Active Directory-Organisationseinheit (OU) vorhanden ist.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
OU-Identität
|
OUIdentity | True | string |
Der Pfad zur Zielorganisationseinheit (OU) im Distinguished Name-Format (z. B. OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-Format oder als Pfad (z. B. London\Target OU). |
|
AD-Server
|
ADServer | string |
Der optionale Name oder der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) eines Active Directory-Domänencontrollers (DC), mit dem die angeforderte Aktion ausgeführt werden soll. Wenn sie leer gelassen wird, wird der Active Directory-Domänencontroller (DC) automatisch mithilfe von Standorteinstellungen bestimmt. |
|
|
Arbeitsablauf
|
Workflow | True | string |
Fügen Sie hier den folgenden Ausdruck hinzu: workflow() |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
OU-Eigenschaften als JSON
|
PowerShellJSONOutput | string |
Die Details der gefundenen Organisationseinheit (OU). |
|
OU ist vorhanden
|
OUExists | boolean |
Wird auf "true" festgelegt, wenn die Organisationseinheit (OU) vorhanden ist, wenn dies nicht der Fall ist. |