Delen via


IA-Connect JML

IA-Connect is een RPA-platform voor Robotic Process Automation waarmee RPA-functionaliteit van de cloud wordt toegevoegd aan on-premises virtuele machines of via Citrix- of Microsoft Remote Desktop RDS-verbindingen. Dit is de module voor het automatiseren van Joiner-, Mover-, Leaver-processen.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Ultima Labs
URL https://www.ultima.com/ultima-labs
E-mailen IAConnect@ultima.com
Connectormetagegevens
Uitgever Ultima Business
Webpagina https://www.ultima.com/ultima-labs
Privacybeleid https://www.ultima.com/privacy-policy
Categorieën IT-bewerkingen; Productiviteit

IA-Connect is een RPA-platform (Robotic Process Automation) waarmee RPA-functionaliteit van Power Automate Cloud Flows wordt toegevoegd aan on-premises virtuele machines of via Citrix- of RdS-verbindingen (Remote Desktop). De IA-Connect Connectors bieden meer dan 800 acties, zodat u elk type on-premises toepassing rechtstreeks vanuit een Power Automate Cloud Flow kunt automatiseren. Alle IA-Connect acties zijn rechtstreeks beschikbaar vanuit uw Power Automate Cloud Flow en bieden eenvoudige integratie tussen cloudtoepassingen en on-premises toepassingen, de mogelijkheid om gebruik te maken van bestaande Power Automate-voorwaarden, lussen, dynamische inhoud, expressies en afhandeling van uitzonderingen in uw RPA-processen. Door de IA-Connect Connectors te gebruiken, beschikt u ook over een volledige uitvoeringsgeschiedenis en controlebaarheid uit de uitvoeringsgeschiedenis van Flow, terwijl u ook hoeft te beschikken over een afzonderlijke toepassing/console/studio voor het ontwikkelen van uw RPA-processen.

Vereiste voorwaarden

Als u een van de IA-Connect Connectors wilt gebruiken, moet u de IA-Connect-software installeren. Dit is gratis om 30 dagen te testen, waarna u een IA-Connect licentie nodig hebt.

De IA-Connect software bestaat uit twee hoofdonderdelen:

  • De IA-Connect Orchestrator, een Azure-web-app die u in uw eigen Azure-tenant zou hosten. Dit verwerkt de routering en beveiliging van RPA-stromen naar een of meer on-premises of cloudgebaseerde virtuele machines.

  • De IA-Connect Agent en Director, die is geïnstalleerd op de virtuele machines waar de software die u wilt automatiseren, toegankelijk is. Daarnaast kan de IA-Connect Agent worden uitgevoerd in een Citrix- of Microsoft RdS-sessie (Remote Desktop Services), waarbij de RPA-opdrachten worden doorgegeven aan een virtueel kanaal in de externe sessie voor uitvoering. De IA-Connect-agent kan worden uitgevoerd vanuit een netwerkshare en vereist geen installatie.

Beschikbare IA-Connect connectors

De beschikbare IA-Connect Connectors zijn:

  • dynamische code IA-Connect
  • IA-Connect Java
  • IA-Connect JML
  • IA-Connect Mainframe
  • IA-Connect Microsoft Office
  • SAP-GUI IA-Connect
  • IA-Connect sessie
  • IA-Connect gebruikersinterface
  • IA-Connect webbrowser

Referenties ophalen

Als u uw licentie wilt ontvangen en uw gratis proefperiode van 30 dagen wilt starten, dient u een aanvraag in op onze website (https://www.ultima.com/IA-Connect/Power-Automate).

Zodra een proefaanvraag is ontvangen, zullen we contact met u opnemen via het e-mailadres dat is opgegeven om u te helpen bij het instellen van de IA-Connect software en om u de proeflicentie te geven. Dit is een volledig aanbevolen proefversie en stelt u in staat om een van de 800 acties te testen voor alle 9 IA-Connect Connectors binnen uw eigen omgeving tijdens de proefperiode.

Aan de slag met uw connector

Nadat u een proefaanvraag voor IA-Connect hebt ingediend, kunt u een ZIP-bestand downloaden met de IA-Connect software en documentatie over de installatie en installatie. We zullen ook contact met u opnemen om ondersteuning en begeleiding te bieden via het installatieproces, indien nodig.

Support

Tijdens de proefperiode kunt u contact opnemen met Ultima Labs (IAConnect@ultima.com) voor ondersteuning en hulp.

Bij het aanschaffen van IA-Connect licenties ontvangt u ondersteuningstokens die kunnen worden ingewisseld voor op maat gemaakte training of ondersteuning van het Uk-based Technical Service Centre (TSC).

Bekende problemen, veelvoorkomende fouten en veelgestelde vragen

Onze Knowledge Base bevat een aantal artikelen met betrekking tot bekende problemen, veelvoorkomende fouten die kunnen optreden bij het gebruik van de IA-Connect Connectors en veelgestelde vragen. Dit is toegankelijk op https://support.ultima.com/ultimalabs en een account voor toegang tot deze resources wordt aangeboden tijdens de IA-Connect proefversie en bij het aanschaffen van een IA-Connect licentie.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
API-sleutel beveiligde string De API-sleutel voor deze API Klopt
Orchestratoradres IA-Connect touw Geef het IA-Connect Orchestrator-adres op zonder het HTTP(S)-onderdeel Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Active Directory-account ontgrendelen

Ontgrendel een Active Directory-account. Als het account niet is vergrendeld, doet deze opdracht niets.

Active Directory DirSync uitvoeren

Hiermee wordt een synchronisatie uitgevoerd tussen Active Directory (on-premises) en Azure Active Directory (cloud). Deze opdracht moet worden uitgegeven aan de server met de rol DirSync (d.w. de computer die de synchronisatie uitvoert).

Active Directory-domein-FQDN ophalen uit DN

Een hulpprogrammafunctie. Op basis van de DN (Distinguished Name) van een Active Directory-gebruiker wordt het Active Directory-domein met de gebruiker geretourneerd.

Active Directory-domeingegevens ophalen

Haalt informatie over een Active Directory-domein op.

Active Directory-gebruiker instellen die is beveiligd tegen onbedoeld verwijderen

Hiermee stelt u een Active Directory-account in dat moet worden beveiligd (of niet beveiligd) tegen onbedoelde verwijdering. Als u een account beveiligt tegen onbedoeld verwijderen, kunt u dat account pas verwijderen nadat u de beveiliging hebt verwijderd.

Active Directory-gebruiker ophalen

Retourneert de eigenschappen van een opgegeven Active Directory-gebruiker. U kunt zoeken op identiteit (om één gebruiker te zoeken) of met behulp van een filter (om een of meer gebruikers te zoeken).

Active Directory-gebruiker toevoegen

Hiermee maakt u een nieuw Active Directory-gebruikersaccount.

Active Directory-gebruiker verplaatsen naar organisatie-eenheid

Hiermee verplaatst u een Active Directory-gebruiker naar een bestaande Organisatie-eenheid (OE) van Active Directory.

Active Directory-gebruiker verwijderen

Hiermee verwijdert u een gebruiker uit Active Directory.

Active Directory-gebruiker verwijderen uit alle groepen

Hiermee verwijdert u een Active Directory-gebruiker uit alle Active Directory-groepen waarvan ze lid zijn. IA-Connect de gebruiker uit zoveel mogelijk groepen verwijdert en rapporteert over het resultaat. Deze actie werkt alleen met gebruikersaccounts. U kunt deze actie niet gebruiken om de groepslidmaatschappen van een groep of computer te verwijderen.

Active Directory-gebruikersaccount inschakelen

Hiermee schakelt u een Active Directory-gebruikersaccount in. Als het account niet is uitgeschakeld, doet deze opdracht niets.

Active Directory-gebruikersaccount uitschakelen

Hiermee schakelt u een Active Directory-gebruikersaccount uit. Als een gebruikersaccount is uitgeschakeld, kan de gebruiker zich niet aanmelden.

Active Directory-gebruikerseigenschappen klonen

Hiermee configureert u de opgegeven eigenschappen/kenmerken van de bron-Active Directory-gebruiker naar de doel-Active Directory-gebruiker.

Active Directory-gebruikerswachtwoord opnieuw instellen

Stelt het wachtwoord van een Active Directory-gebruiker opnieuw in met een nieuw wachtwoord en stelt desgewenst wachtwoordeigenschappen in.

Active Directory-groep ophalen

Retourneert de eigenschappen van een opgegeven Active Directory-groep of -groepen. U kunt zoeken op identiteit (om één groep te zoeken) of met behulp van een filter (om een of meer groepen te zoeken).

Active Directory-groep toevoegen

Hiermee maakt u een nieuwe Active Directory-groep.

Active Directory-groep verwijderen

Hiermee verwijdert u een groep uit Active Directory. Als er objecten zijn (bijvoorbeeld gebruikers, groepen of computers) in de groep, worden deze objecten verwijderd als onderdeel van de verwijdering van de groep.

Active Directory-groepsleden ophalen

Retourneert een lijst met leden van een Active Directory-groep.

Active Directory-groepslid toevoegen

Voeg een Active Directory-object (meestal een gebruiker, groep of computer) toe aan een bestaande Active Directory-groep. Als groep en groepslid zich in verschillende domeinen bevinden, moet u de DN (Distinguished Name) opgeven voor zowel groep als leden.

Active Directory-groepslid verwijderen

Hiermee verwijdert u een Active Directory-lid (gebruiker, groep of computer) uit een Active Directory-groep.

Active Directory-object toevoegen aan meerdere groepen

Voeg een Active Directory-object (meestal een gebruiker, groep of computer) toe aan meerdere bestaande Active Directory-groepen. IA-Connect voegt het object toe aan zoveel mogelijk groepen en rapporteert over het resultaat. Als het object al lid is van een of meer van de opgegeven groepen, wordt dit geteld als een succes.

Active Directory-object verwijderen uit meerdere groepen

Hiermee verwijdert u een Active Directory-object (meestal een gebruiker, groep of computer) uit meerdere bestaande Active Directory-groepen. IA-Connect verwijdert het object uit zoveel mogelijk groepen en rapporteert het over het resultaat. Als het object geen lid is van een of meer van de opgegeven groepen, wordt dit geteld als een succes.

Active Directory OE ophalen van gebruikers-DN

Een hulpprogrammafunctie. Met de DN (Distinguished Name) van een Active Directory-gebruiker wordt de organisatie-eenheid (OE) geretourneerd waarin de gebruiker zich bevindt.

Active Directory PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Active Directory-runspace in de sessie waarin de IA-Connect Agent wordt uitgevoerd, waarbij de inhoud van het script wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Active Directory PowerShell-code. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread.

Active Directory-server instellen

Hiermee stelt u een specifieke Active Directory-server in die moet worden gebruikt voor alle verdere Active Directory-acties.

Algemene gebruikerseigenschappen van Active Directory wijzigen

Algemene eigenschappen van een Active Directory-gebruiker wijzigen. U kunt alleen waarden toewijzen aan eigenschappen, niet op leeg instellen. Als u eigenschappen wilt instellen op leeg, gebruikt u de actie 'Eigenschappen van Active Directory-gebruikersreeks wijzigen'.

Alle Azure AD-gebruikerslicenties verwijderen

Hiermee verwijdert u alle Azure AD-gebruikerslicenties (SKU) die aan een gebruiker zijn toegewezen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Automatische antwoorden instellen (niet aanwezig) voor een Microsoft Exchange-postvak

Automatische antwoorden (niet aanwezig) instellen voor een Microsoft Exchange-postvak. Deze actie werkt niet voor extern postvak in Microsoft Exchange Online of Office 365: Gebruik in plaats daarvan de actie Automatische antwoorden instellen (niet aanwezig) voor een Office 365-postvak.

Automatische antwoorden instellen (niet aanwezig) voor een Office 365-postvak

Automatische antwoorden (niet aanwezig) instellen voor een Microsoft Exchange Online- of Office 365-postvak.

Azure AD-beveiliging of Microsoft 365-groep verwijderen

Een Azure Active Directory-beveiligingsgroep of Microsoft 365-groep verwijderen. Met deze actie kunnen beveiligingsgroepen of distributielijsten waarvoor e-mail is ingeschakeld, niet worden verwijderd: gebruik in plaats daarvan de actie Office 365-distributiegroep verwijderen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker inschakelen

Hiermee schakelt u een Azure Active Directory-gebruiker in. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker toevoegen

Hiermee maakt u een nieuw Azure Active Directory-gebruikersaccount. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker toevoegen aan groep

Voeg een Azure Active Directory-gebruiker toe aan een bestaande Azure Active Directory-beveiliging of M365-groep. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker toevoegen aan meerdere groepen

Voegt een Azure Active Directory-gebruiker toe aan meerdere bestaande Azure Active Directory-groepen waarbij de groepen worden opgegeven met object-id of weergavenaam. IA-Connect voegt de gebruiker toe aan zoveel mogelijk groepen en rapporteert over het resultaat. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker toewijzen aan beheerdersrol

Wijs een Azure Active Directory-gebruiker (of ander object) toe aan een bestaande Azure Active Directory-beheerdersrol. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker toewijzen aan meerdere beheerdersrollen

Wijs een Azure Active Directory-gebruiker (of ander object) toe aan een of meer bestaande Azure Active Directory-beheerdersrollen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker uit groep verwijderen

Hiermee verwijdert u een Azure Active Directory-gebruiker uit een Azure Active Directory-groep. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker uit meerdere groepen verwijderen

Hiermee verwijdert u een Azure Active Directory-gebruiker uit meerdere bestaande Azure Active Directory-groepen waarbij de groepen worden opgegeven met object-id of weergavenaam. IA-Connect de gebruiker uit zoveel mogelijk groepen verwijdert en rapporteert over het resultaat. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker uitschakelen

Hiermee schakelt u een Azure Active Directory-gebruiker uit. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker verwijderen

Een Azure Active Directory-gebruiker verwijderen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker verwijderen uit alle beheerdersroltoewijzingen

Hiermee verwijdert u een Azure Active Directory-gebruiker (of ander object) uit alle Azure Active Directory-beheerdersrollen waaraan ze zijn toegewezen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker verwijderen uit alle groepen

Hiermee verwijdert u een Azure Active Directory-gebruiker uit alle Azure Active Directory-groepen waarvan ze lid zijn. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker verwijderen uit beheerdersroltoewijzing

Verwijder een Azure Active Directory-gebruiker (of ander object) uit een bestaande Azure Active Directory-beheerdersroltoewijzing. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruiker verwijderen uit meerdere beheerdersrollen

Hiermee verwijdert u een Azure Active Directory-gebruiker (of een ander object) uit een of meer bestaande Azure Active Directory-beheerdersrollen. Deze actie doorloopt de lijst met roltoewijzingen van de gebruiker en verwijdert overeenkomende items, dus als u niet-bestaande rollen opgeeft om te verwijderen, wordt er geen fout geactiveerd (omdat er niets wordt geprobeerd als de gebruiker zich niet in die rol bevindt). Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruikers ophalen

Retourneert de details van gebruikers in Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). U kunt zoeken op object-id of met behulp van een filter. Een object-id-zoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruikerseigenschappen opnieuw instellen

Algemene eigenschappen van een Azure Active Directory-gebruiker opnieuw instellen op een lege waarde. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruikerseigenschappen wijzigen

Algemene eigenschappen van een Azure Active Directory-gebruiker wijzigen. U kunt alleen waarden toewijzen aan eigenschappen, niet instellen op leeg, omdat een lege waarde wordt geïnterpreteerd als een intentie om de waarde ongewijzigd te laten. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruikerslicentie instellen

Hiermee voegt u een Azure AD-gebruikerslicentie (SKU) toe of verwijdert u deze. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruikerslicenties ophalen

Hiermee haalt u een lijst met licenties (SKU) op die zijn toegewezen aan een Azure AD-gebruiker. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-gebruikerswachtwoord opnieuw instellen

Hiermee stelt u het wachtwoord van een Azure Active Directory-gebruiker opnieuw in met een nieuw wachtwoord. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-groepen ophalen

Retourneert de details van groepen in Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). U kunt zoeken op object-id of met behulp van een filter. Een object-id-zoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-groepsleden ophalen

Retourneert een lijst met leden van een Azure Active Directory-groep. Leden kunnen gebruikers, groepen, apparaten of service-principals/bedrijfstoepassingen zijn. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD-licentie-SKU's ophalen

Retourneert een lijst met Azure Active Directory-licentie-SKU's (Stock Keeping Units) waarop de verbonden Azure AD is geabonneerd. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Azure AD PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Azure Active Directory-runspace (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD) in de sessie waarin de IA-Connect Agent wordt uitgevoerd, waarbij de scriptinhoud wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Azure AD PowerShell-scripts. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules.

Beheer van Azure AD-gebruikers instellen

Stel de manager van een Azure Active Directory-gebruiker in. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Bestaat de Active Directory-groep?

Retourneert of een opgegeven Active Directory-groep bestaat.

Bestaat het Microsoft Exchange-postvak?

Retourneert of het opgegeven Exchange-postvak bestaat.

Bestaat het Postvak van Microsoft Exchange Online?

Retourneert of het opgegeven Postvak van Microsoft Exchange Online of Office 365 (extern) bestaat. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Booleaanse eigenschap Active Directory-gebruiker wijzigen

Wijzig een afzonderlijke booleaanse eigenschap (waar/onwaar) van een Active Directory-gebruiker. Hiermee kunt u een zeer specifieke gebruikersinstelling wijzigen, inclusief aangepaste eigenschappen.

Controleren of de organisatie-eenheid van Active Directory bestaat

Rapporteert of er een Organisatie-eenheid (OE) van Active Directory bestaat.

De eigenschappen instellen in een Microsoft Exchange Online-postvak

Stel de eigenschappen van een bestaand Microsoft Exchange Online- of Office 365-postvak (extern) in. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

De eigenschappen van een Microsoft Exchange Online-postvak opnieuw instellen

Stel de opgegeven eigenschappen van een bestaand Microsoft Exchange Online- of Office 365-postvak (extern) in op leeg. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

De eigenschappen van een Microsoft Exchange-postvak opnieuw instellen

Stel de opgegeven eigenschappen van een bestaand Microsoft Exchange-postvak in op leeg.

De eigenschappen voor een Microsoft Exchange-postvak instellen

Stel de eigenschappen van een bestaand Microsoft Exchange-postvak in.

De eigenschappen voor een Office 365-postvak instellen

Stel de eigenschappen in een Microsoft Exchange Online- of Office 365-postvak in.

De startpagina van Active Directory-gebruikers wijzigen

Hiermee stelt u de basismap/map/station in voor een Active Directory-gebruiker.

De volgende beschikbare accountnaam ophalen

Gegeven details met betrekking tot de naamgevingsindeling voor Active Directory- en Exchange-accountnamen, geeft u de details van de volgende beschikbare reserveaccountnaam. Wordt gebruikt om te bepalen welk Active Directory- en Exchange-account moet worden gemaakt voor een bepaalde gebruiker. Met deze actie worden geen accounts gemaakt. Deze actie bevat informatie over de beschikbaarheid van namen.

Details van Microsoft Exchange-distributiegroep ophalen

Haal de details van een Microsoft Exchange-distributiegroep op. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

Details van Microsoft Exchange Online-postvak ophalen

Retourneert de eigenschappen van het opgegeven Microsoft Exchange Online- of Office 365-postvak (extern). De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

Details van Microsoft Exchange-postvak ophalen

Retourneert de eigenschappen van het opgegeven Exchange-postvak. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

E-mailadressen van een Microsoft Exchange Online-postvak ophalen

Hiermee haalt u een lijst op met alle e-mailadressen die zijn toegewezen aan een bestaand Microsoft Exchange Online- of Office 365-postvak (extern). Dit omvat het primaire SMTP-adres, proxy-e-mailadressen, X.400-adressen en EUM-adressen (Exchange Unified Messaging). De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

E-mailadressen van een Microsoft Exchange Online-postvak wijzigen

Wijzig de e-mailadressen in een bestaand Microsoft Exchange Online- of Office 365-postvak (extern). U kunt primaire en alias-e-mailadressen toevoegen, verwijderen en vervangen. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

E-mailadressen van een Microsoft Exchange-postvak ophalen

Hiermee wordt een lijst opgehaald met alle e-mailadressen die zijn toegewezen aan een Microsoft Exchange-postvak. Dit omvat het primaire SMTP-adres, proxy-e-mailadressen, X.400-adressen en EUM-adressen (Exchange Unified Messaging).

E-mailadressen van een Microsoft Exchange-postvak wijzigen

Wijzig de e-mailadressen in een Microsoft Exchange-postvak. U kunt primaire en alias-e-mailadressen toevoegen, verwijderen en vervangen.

Een gedeeld Office 365-postvak en gebruikersaccount maken

Maak een gedeeld postvak in Microsoft Exchange Online en een gebruikersaccount in Azure Active Directory/Entra-id. Gebruik deze actie alleen als de gebruiker nog niet bestaat in Azure Active Directory/Entra-id. Het SMTP-adres van het gedeelde postvak is gebaseerd op de naam, alias of het primaire SMTP-adres (afhankelijk van de invoer).

Een Microsoft Exchange Online-postvak maken voor een gebruiker

Hiermee maakt u een Microsoft Exchange Online- of Office 365-postvak (extern) of archiefpostvak voor een bestaande gebruiker in on-premises Active Directory die nog geen postvak heeft. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie. U kunt deze actie ook gebruiken om een bestaand extern postvak te archiveren.

Een Microsoft Exchange-postvak voor een gebruiker maken

Hiermee maakt u een Microsoft Exchange-postvak voor een bestaande gebruiker die nog geen postvak heeft.

Een nieuwe Azure AD-beveiligingsgroep maken

Hiermee maakt u een nieuwe Azure Active Directory-beveiligingsgroep. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Een nieuwe Azure AD Microsoft 365-groep maken

Hiermee maakt u een nieuwe Azure Active Directory Microsoft 365-groep. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Een nieuwe Microsoft Exchange-distributiegroep maken

Hiermee maakt u een nieuwe Microsoft Exchange-distributiegroep of beveiligingsgroep met e-mail.

Een nieuwe Office 365-distributiegroep maken

Hiermee maakt u een nieuwe Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Eigenschappen van Active Directory-gebruikerstekenreeksen wijzigen

Wijzig de afzonderlijke tekenreekseigenschap(en) van een Active Directory-gebruiker. Hiermee kunt u zeer specifieke gebruikersinstellingen wijzigen, inclusief aangepaste eigenschappen. U kunt ook afzonderlijke gebruikerseigenschappen instellen op leeg.

Exchange instellen om het hele Active Directory-forest weer te geven

Geef op of het hele Active Directory-forest (inclusief subdomeinen) wordt doorzocht/bekeken bij het uitvoeren van Exchange-acties. Mogelijk moet u deze actie gebruiken als u meerdere gekoppelde domeinen hebt.

Exchange-postvak verzenden instellen namens

Geef op wie namens dit bestaande postvak mag worden verzonden.

Exchange PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Exchange-runspace in de sessie waarop de IA-Connect Agent wordt uitgevoerd, waarbij de inhoud van het script wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Exchange PowerShell-code. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread.

Groepslidmaatschap van Microsoft Exchange-postvakdistributie ophalen

Haal op van welke distributiegroepen een postvak lid is.

Heeft het Office 365-postvak een archief

Rapporteert of een bestaand postvak in Microsoft Exchange Online een archiefpostvak heeft. Als het postvak niet bestaat, wordt er een uitzondering gegenereerd.

Het Microsoft Exchange Online-postvak voor een gebruiker uitschakelen

Schakel een bestaand Postvak in Microsoft Exchange Online of Office 365 (extern) uit. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Het Microsoft Exchange-postvak voor een gebruiker uitschakelen

Schakel een bestaand Microsoft Exchange-postvak uit.

Is Azure AD-gebruiker toegewezen aan de beheerdersrol

Hiermee wordt geretourneerd of een Azure Active Directory-gebruiker is toegewezen aan een Azure Active Directory-beheerdersrol. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Is de Azure AD PowerShell-module geïnstalleerd

Rapporteert of de PowerShell-modules die vereist zijn voor Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD) zijn geïnstalleerd op de computer waarop de IA-Connect Agent wordt uitgevoerd. Met deze actie wordt gecontroleerd op de PowerShell-modules van Azure AD v2 en Microsoft Graph Users.

Is gebruiker in Azure AD-gebruikersgroep

Hiermee wordt geretourneerd of een gebruiker lid is van een Azure Active Directory-groep. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Is verbonden met Active Directory

Rapporteert of IA-Connect is verbonden met Active Directory. Standaard wordt IA-Connect automatisch verbonden met het domein waarvan de computer waarop de IA-Connect Agent wordt uitgevoerd lid is, met behulp van het account waarop de IA-Connect Agent wordt uitgevoerd. Gebruik de actie Verbinding maken met Active Directory met referenties om verbinding te maken met behulp van alternatieve referenties of een alternatief domein.

Is verbonden met Azure AD

Rapporteert of IA-Connect is verbonden met Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). Gebruik een van de acties Verbinding maken met Azure AD om verbinding te maken.

Is verbonden met Microsoft Exchange

Rapporteert of IA-Connect is verbonden met een Microsoft Exchange-server. Gebruik de actie Verbinding maken met Microsoft Exchange om verbinding te maken.

Is verbonden met Office 365

Rapporteert of IA-Connect is verbonden met Office 365 met behulp van de Office 365 PowerShell-modules. Gebruik de actie Verbinding maken met Office 365 om verbinding te maken.

Leden van De Office 365-distributiegroep ophalen

Haal een lijst op van de leden van een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Leden van Microsoft Exchange-distributiegroep ophalen

Haal een lijst op met de leden van een Microsoft Exchange-distributiegroep.

Lidmaatschap van Active Directory-gebruikersgroep klonen

Voegt de doel-Active Directory-gebruiker toe aan dezelfde Active Directory-groepen waarvan de eerste gebruiker lid is, minus de primaire groep (meestal 'Domeingebruikers') omdat het technisch geen lidmaatschap is.

Lidmaatschap van Active Directory-gebruikersgroep ophalen

Retourneert een lijst met Active Directory-groepen waarvan de opgegeven gebruiker lid is, minus de primaire groep (meestal 'Domeingebruikers') omdat het technisch geen lidmaatschap is. Deze actie werkt alleen met gebruikersaccounts. U kunt deze actie niet gebruiken om een query uit te voeren op groepslidmaatschap van groepen of computers.

Lidmaatschap van Azure AD-gebruikersgroep ophalen

Retourneert een lijst met Azure Active Directory-groepen waarvan de opgegeven gebruiker lid is. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Lidmaatschap van office 365-postvakdistributiegroep ophalen

Haal op van welke distributiegroepen of beveiligingsgroepen met e-mail een Office 365- of Exchange Online-postvak lid is.

Meerdere Active Directory-groepsleden toevoegen

Voeg een of meer Active Directory-objecten (meestal gebruikers, groepen of computers) toe aan een bestaande Active Directory-groep. IA-Connect zo veel mogelijk leden aan de groep toevoegt en rapporteert over het resultaat. Als groep en groepslid zich in verschillende domeinen bevinden, moet u de DN (Distinguished Name) opgeven voor zowel groep als leden. Als sommige objecten al lid zijn van de groep, wordt dit geteld als een succes.

Meerdere Active Directory-groepsleden verwijderen

Verwijder een of meer Active Directory-objecten (meestal gebruikers, groepen of computers) uit een bestaande Active Directory-groep. IA-Connect verwijdert zoveel mogelijk leden uit de groep en rapporteert het resultaat. Als groep en groepslid zich in verschillende domeinen bevinden, moet u de DN (Distinguished Name) opgeven voor zowel groep als leden. Als sommige objecten geen lid van de groep zijn, wordt dit geteld als een succes.

Microsoft Exchange-distributiegroep verwijderen

Een Microsoft Exchange-distributiegroep verwijderen.

Microsoft Exchange-lid toevoegen aan distributiegroep

Voeg een lid (bijvoorbeeld een gebruiker) toe aan een Exchange-distributiegroep. Als het lid zich al in de groep bevindt, wordt er geen actie ondernomen.

Microsoft Exchange-lid verwijderen uit distributiegroep

Een lid (bijvoorbeeld een gebruiker) verwijderen uit een Exchange-distributiegroep. Als het lid zich niet in de groep bevindt, wordt er geen actie ondernomen.

Microsoft Exchange Online-postvak en gebruikersaccount maken

Maak een gebruiker met e-mail in on-premises Active Directory en maak een gekoppeld extern postvak in Microsoft Exchange Online of Office 365. Gebruik deze actie alleen als de gebruiker niet bestaat in on-premises Active Directory. Als de gebruiker al bestaat, gebruikt u de actie 'Microsoft Exchange Online-postvak voor een gebruiker maken'. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Microsoft Exchange-postvak en gebruikersaccount maken

Maak een gebruiker met e-mail in on-premises Active Directory en maak een gekoppeld postvak in Microsoft Exchange. Gebruik deze actie alleen als de gebruiker niet bestaat in on-premises Active Directory. Als de gebruiker al bestaat, gebruikt u de actie 'Een Microsoft Exchange-postvak voor een gebruiker maken'.

Microsoft Exchange-postvakmachtiging toevoegen

Wijs postvakmachtigingen toe aan een Active Directory-object (bijvoorbeeld gebruiker of groep).

Microsoft Exchange-postvakmachtiging toevoegen aan gebruiker

Wijs postvakmachtigingen toe aan een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Microsoft Exchange-postvakmachtiging verwijderen van gebruiker

Verwijder postvakmachtigingen uit een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Office 365-archiefpostvak maken voor bestaande gebruiker

Hiermee maakt u een gearchiveerd postvak in Microsoft Exchange Online voor een bestaande gebruiker in Azure Active Directory/Entra-id. De gebruiker moet al een postvak en een geschikte licentie hebben.

Office 365-distributiegroep ophalen

Retourneert de eigenschappen van de opgegeven Microsoft Exchange Online- of Office 365-distributiegroepen of beveiligingsgroepen met e-mail. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

Office 365-distributiegroep verwijderen

Verwijder een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Office 365-lid toevoegen aan distributiegroep

Voeg een lid toe aan een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Office 365-lid verwijderen uit distributiegroep

Een lid verwijderen uit een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Office 365-postvak en gebruikersaccount maken

Maak een postvak in Microsoft Exchange Online en een gebruikersaccount in Azure Active Directory/Entra-id. Gebruik deze actie alleen als de gebruiker nog niet bestaat in Azure Active Directory/Entra-id. Als de gebruiker al bestaat, wijst u in plaats daarvan een geschikte licentie toe aan het gebruikersaccount.

Office 365-postvak ophalen

Retourneert de eigenschappen van het opgegeven Microsoft Exchange Online- of Office 365-postvak.

Office 365-postvak verwijderen uit alle distributiegroepen

Verwijder een postvak uit alle Microsoft Exchange Online- of Office 365-distributiegroepen of beveiligingsgroepen met e-mail waarvan het lid is.

Office 365-postvakmachtiging toevoegen aan gebruiker

Wijs microsoft Exchange Online- of Office 365-postvakmachtigingen toe aan een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Office 365-postvakmachtiging verwijderen van gebruiker

Verwijder microsoft Exchange Online- of Office 365-postvakmachtigingen van een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Office 365 PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Office 365-runspace in de sessie waarop de IA-Connect Agent wordt uitgevoerd, waarbij de scriptinhoud wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Office 365 Exchange Online PowerShell-code. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread.

Organisatie-eenheid van Active Directory toevoegen

Hiermee maakt u een nieuwe Organisatie-eenheid (OE) van Active Directory.

Organisatie-eenheid van Active Directory verwijderen

Hiermee verwijdert u een organisatie-eenheid (OE) uit Active Directory. De organisatie-eenheid kan niet worden verwijderd als er objecten zijn (bijvoorbeeld gebruikers, groepen of computers) in de organisatie-eenheid.

Roltoewijzingen voor Azure AD-gebruikersbeheerders ophalen

Retourneert een lijst met Azure Active Directory-beheerdersrollen waaraan de opgegeven gebruiker is toegewezen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Serviceabonnementen voor Azure AD-gebruikerslicenties ophalen

Hiermee wordt een lijst opgehaald met licenties die zijn toegewezen aan een opgegeven Azure AD-gebruikerslicentie (SKU). Bijvoorbeeld: Als de gebruiker de FLOW_FREE licentie heeft toegewezen, kunt u hiermee bekijken welke serviceplannen ze hebben ingericht voor die licentie. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Verbinding maken met Active Directory met referenties

Hiermee kunt u een alternatief account opgeven dat moet worden gebruikt bij het uitvoeren van Active Directory PowerShell-opdrachten. Dit is van invloed op alle Active Directory-opdrachten die na deze actie zijn uitgegeven. Als u deze actie niet gebruikt, worden alle Active Directory PowerShell-opdrachten uitgevoerd als het gebruikersaccount IA-Connect Agent wordt uitgevoerd zoals.

Verbinding maken met Azure AD met een certificaat

Verbindt IA-Connect met Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). Deze actie (of 'Verbinding maken met Azure AD met referenties') moet worden uitgegeven voordat u andere Azure AD-acties uitvoert. Voor deze actie moeten een Azure-service-principal en azure AD-app-registratie met certificaat worden ingesteld in Azure AD voordat deze werkt, maar heeft het voordeel dat MFA (2FA) niet vereist is. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph PowerShell-modules.

Verbinding maken met Azure AD met referenties

Verbindt IA-Connect met Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). Deze actie (of 'Verbinding maken met Azure AD met certificaat') moet worden uitgegeven voordat u andere Azure AD-acties uitvoert. Voor deze actie is een account vereist dat geen gebruik maakt van MFA (2FA) of dat u de UI-automatiseringsmodule moet gebruiken om het 2FA-onderdeel te automatiseren (bijvoorbeeld het pop-upvenster voor eenmalige wachtwoordverificatie). U kunt ook de actie Verbinding maken met Azure AD met een certificaat gebruiken. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules.

Verbinding maken met het standaard Active Directory-domein

Hiermee wordt de IA-Connect-agent verbonden met het domein waarvan de computer waarop de IA-Connect Agent wordt uitgevoerd, lid is van het account waarvan de IA-Connect Agent wordt uitgevoerd (bijvoorbeeld het standaardgedrag).

Verbinding maken met JML-omgeving

Maak verbinding met een JML-omgeving waarin de details van die omgeving worden bewaard in de IA-Connect Orchestrator. Deze details kunnen referenties, adressen en andere connectiviteitsinstellingen bevatten. U kunt deze actie bijvoorbeeld gebruiken om verbinding te maken met Active Directory, Microsoft Exchange, Azure AD of Office 365 Exchange Online.

Verbinding maken met Microsoft Exchange

Hiermee wordt IA-Connect verbonden met een Microsoft Exchange-server. Deze actie moet worden uitgegeven voordat andere Exchange-acties worden uitgevoerd. Als u een gebruikersnaam en wachtwoord opgeeft, worden alle volgende Exchange-acties uitgevoerd als dat account. Als u geen gebruikersnaam en wachtwoord opgeeft, worden alle volgende Exchange-acties uitgevoerd als het gebruikersaccount waarop de IA-Connect Agent wordt uitgevoerd.

Verbinding maken met Office 365 met een certificaat

Verbindt IA-Connect met Office 365 met behulp van de Office 365 PowerShell-modules. Deze actie (of 'Verbinding maken met Office 365 met referenties') moet worden uitgegeven voordat u andere Office 365-acties uitvoert. Voor deze actie is een Azure AD-app-registratie met certificaat vereist en moeten de juiste rollen worden ingesteld in Azure AD voordat deze werkt, maar heeft het voordeel dat MFA (2FA) niet vereist is.

Verbinding maken met Office 365 met referenties

Verbindt IA-Connect met Office 365 met behulp van de Office 365 PowerShell-modules. Deze actie (of 'Verbinding maken met Office 365 met certificaat') moet worden uitgegeven voordat andere Office 365-acties worden uitgevoerd. Voor deze actie is een account vereist waarvoor MFA (2FA) niet is vereist, of u moet de UI-automatiseringsmodule gebruiken om het 2FA-onderdeel te automatiseren (bijvoorbeeld het pop-upvenster voor eenmalige wachtwoordverificatie). U kunt ook de actie Verbinding maken met Office 365 met een certificaat gebruiken.

Verbinding met Active Directory verbreken

Als u de actie Active Directory PowerShell-runspace openen met referenties hebt gebruikt om Active Directory PowerShell-opdrachten uit te voeren als een alternatief gebruikersaccount of een alternatief domein, retourneert deze actie de IA-Connect-agent naar het standaardgedrag van het uitvoeren van Active Directory-acties als het gebruikersaccount waarop de IA-Connect Agent wordt uitgevoerd.

Verbinding met Azure AD verbreken

Verbreekt IA-Connect van Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). U kunt azure AD-acties pas opnieuw uitgeven nadat u opnieuw verbinding hebt gemaakt. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van wat oorspronkelijk is gebruikt om verbinding te maken.

Verbinding met Microsoft Exchange verbreken

Hiermee wordt IA-Connect van een Microsoft Exchange-server verbroken (verbonden met behulp van de actie Verbinding maken met Microsoft Exchange). U kunt microsoft Exchange PowerShell-acties pas opnieuw uitgeven nadat u opnieuw verbinding hebt gemaakt.

Verbinding verbreken met Office 365

Hiermee wordt IA-Connect van Office 365 verbroken met behulp van de Office 365 PowerShell-modules (verbonden met de actie Verbinding maken met Office 365). U kunt office 365 PowerShell-acties pas opnieuw uitgeven nadat u opnieuw verbinding hebt gemaakt.

Verlooptijd van Active Directory-gebruikersaccount wissen

Hiermee wist u de vervaldatum voor een Active Directory-account.

Vervaldatum van Active Directory-gebruikersaccount instellen

Hiermee stelt u de vervaldatum van het account in voor een Active Directory-gebruikersaccount. Dit is de laatste volledige dag waarin het account bruikbaar is, dus technisch verloopt het account aan het begin van de volgende dag. De IA-Connect-agent is hiervan op de hoogte en voegt automatisch 1 dag toe aan de opgegeven invoerdatum bij het opslaan van de datum in Active Directory.

Wachten op een Office 365-postvak

Wacht tot een opgegeven Microsoft Exchange Online- of Office 365-postvak bestaat. Dit is gebruikelijk als u wacht totdat een AD-synchronisatie of licentie-instelling van kracht wordt. Als het postvak al bestaat, wordt de actie onmiddellijk geretourneerd.

Active Directory-account ontgrendelen

Ontgrendel een Active Directory-account. Als het account niet is vergrendeld, doet deze opdracht niets.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryUnlockADAccountByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory DirSync uitvoeren

Hiermee wordt een synchronisatie uitgevoerd tussen Active Directory (on-premises) en Azure Active Directory (cloud). Deze opdracht moet worden uitgegeven aan de server met de rol DirSync (d.w. de computer die de synchronisatie uitvoert).

Parameters

Name Sleutel Vereist Type Description
Beleidstype
PolicyType string

Het type synchronisatie dat moet worden uitgevoerd. Opties zijn Delta om een synchronisatie van wijzigingen uit te voeren sinds de laatste synchronisatie (de standaardoptie) en 'Initial' om een volledige synchronisatie uit te voeren (doe dit alleen als u precies weet wat u doet).

Computernaam
ComputerName string

De server met de rol DirSync (d.w.w.v. de computer die de synchronisatie uitvoert).

Maximum aantal nieuwe pogingen
MaxRetryAttempts integer

Als de adreslijstsynchronisatie een bezet- of time-outfout ontvangt, kan deze onderbreken en opnieuw proberen. Met deze invoer wordt het maximum aantal nieuwe pogingen opgegeven. Ingesteld op 0 om nieuwe pogingen uit te schakelen. Houd rekening met mogelijke time-outs voor IA-Connect actie als u deze waarde te hoog instelt.

Seconden tussen nieuwe pogingen
SecondsBetweenRetries integer

Als de agent een adreslijstsynchronisatie opnieuw probeert uit te proberen, hoeveel seconden er moet zijn tussen nieuwe pogingen. Als deze waarde is ingesteld op een waarde kleiner dan 1, negeert de agent deze invoer en wordt een waarde van 1 seconde gebruikt.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
DirSync-resultaat JSON
PowerShellJSONOutput string

Het resultaat van de Active Directory-synchronisatiebewerking, in JSON-indeling.

Active Directory-domein-FQDN ophalen uit DN

Een hulpprogrammafunctie. Op basis van de DN (Distinguished Name) van een Active Directory-gebruiker wordt het Active Directory-domein met de gebruiker geretourneerd.

Parameters

Name Sleutel Vereist Type Description
DN van gebruiker
DN True string

De DN-naam van de zoekgebruiker (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=local).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Domein-FQDN
DomainFQDN string

Het Active Directory-domein met de gebruiker.

Active Directory-domeingegevens ophalen

Haalt informatie over een Active Directory-domein op.

Parameters

Name Sleutel Vereist Type Description
AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om de domeinaanvraag naar te verzenden. De domeincontroller verkrijgt vervolgens de gevraagde informatie voor het opgegeven domein.

Vooraf gedefinieerde domeinidentiteit
PredefinedIdentity string

Gebruiker: Informatie wordt opgehaald voor het domein waartoe de aangemelde gebruiker behoort. Computer: Informatie wordt opgehaald voor het domein waartoe de computer (waarop de IA-Connect sessie wordt uitgevoerd) behoort. Handmatig: Voer het Active Directory-domein in het veld Domeinidentiteit in. Als dit veld leeg is en het veld Domeinidentiteit een waarde heeft, wordt die waarde gebruikt.

Domeinidentiteit
Identity string

Dit veld wordt alleen gebruikt als de vooraf gedefinieerde domeinidentiteit is ingesteld op 'Handmatig' (of leeg). De identiteit van een Active Directory-domein waarvoor domeingegevens moeten worden opgehaald. U kunt een Active Directory-domein opgeven op DN-naam (bijvoorbeeld DC=mydomain, DC=local), GUID, SID, DNS-domeinnaam (bijvoorbeeld mydomain.local) of NetBIOS-naam (bijvoorbeeld MYDOMAIN).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Onderscheidende naam
DistinguishedName string

De DN (Distinguished Name) van het domein.

DNS-hoofdnaam
DNSRoot string

De naam van de DNS-hoofdmap op het hoogste niveau van het domein.

Domeinmodus
DomainMode string

De modus of het niveau van het domein (bijvoorbeeld Windows2003Domain of Windows2016Domain).

Domein-SID
DomainSID string

De beveiligings-id (SID) van het domein.

Bos
Forest string

De naam van het Active Directory-forest (de meest logische container).

Infrastructuurbeheerder
InfrastructureMaster string

De naam van de domeincontroller (DC) met de rol infrastructuurmaster.

NetBIOS-naam van domein
NetBIOSName string

De NetBIOS-naam van het domein (bijvoorbeeld MYDOMAIN).

Domein-GUID
ObjectGUID string

De GUID van het domein.

PDC-emulator
PDCEmulator string

De naam van de domeincontroller (DC) met de rol PDC-emulator.

RID-master
RIDMaster string

De naam van de domeincontroller (DC) met de RID-hoofdrol.

Active Directory-gebruiker instellen die is beveiligd tegen onbedoeld verwijderen

Hiermee stelt u een Active Directory-account in dat moet worden beveiligd (of niet beveiligd) tegen onbedoelde verwijdering. Als u een account beveiligt tegen onbedoeld verwijderen, kunt u dat account pas verwijderen nadat u de beveiliging hebt verwijderd.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Beveiligd tegen onbedoeld verwijderen
ProtectedFromAccidentalDeletion True boolean

Ingesteld op Waar om een gebruiker te beschermen tegen onbedoeld verwijderen. Ingesteld op onwaar om de beveiliging tegen onbedoelde verwijdering te verwijderen.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectorySetADUserProtectedFromAccidentalDeletionByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-gebruiker ophalen

Retourneert de eigenschappen van een opgegeven Active Directory-gebruiker. U kunt zoeken op identiteit (om één gebruiker te zoeken) of met behulp van een filter (om een of meer gebruikers te zoeken).

Parameters

Name Sleutel Vereist Type Description
Identiteit
Identity string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op waarop de gebruikers moeten worden gefilterd. Algemene eigenschapsnamen zijn: plaats, bedrijf, land, afdeling, beschrijving, displayname, divisie, e-mailadres, ingeschakeld, givenname, homedirectory, homedrive, homephone, initialen, manager, kantoor, organisatie, postcode, profielpad, samaccountname, scriptpath, state, streetaddress, achternaam, titel, userprincipalname. Als u de invoer 'Filtereigenschapsvergelijking' instelt op Raw of LDAP, kunt u deze invoer leeg laten.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in. Als u een LDAP-filter wilt invoeren, kiest u een vergelijkingstype LDAP: LDAP-filter invoeren en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als alternatief voor het zoeken op identiteit, de waarde van de naam van de eigenschap Filter waarop de gebruikers moeten worden gefilterd.

OE-basis zoeken
SearchOUBase string

De organisatie-eenheid (OE) op het hoogste niveau die u wilt doorzoeken. Alleen ondersteund bij het zoeken met behulp van een filter, niet op identiteit. Als dit niet is opgegeven, wordt het hele domein doorzocht. De OE van de zoekbasis kan worden opgegeven in de indeling Distinguished Name (bijvoorbeeld OU=Londen,OU=MyUsers,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld MyUsers\London).

OE-basissubstructuur zoeken
SearchOUBaseSubtree boolean

Als deze optie is ingesteld op true (de standaardinstelling) en er een zoek-OE-basis wordt opgegeven, worden de basis van de zoek-OE en alle sub-OE's doorzocht. Als deze optie is ingesteld op onwaar en er een zoek-OE-basis wordt opgegeven, wordt alleen de zoek-OE-basis doorzocht. Deze invoer wordt niet gebruikt als er geen zoek-OE-basis wordt opgegeven of als u zoekt op identiteit.

Eigenschappen die moeten worden opgehaald
Properties string

Een door komma's gescheiden lijst met aanvullende gebruikerseigenschappen die moeten worden opgehaald. Algemene eigenschappen zijn: plaats, bedrijf, land, afdeling, beschrijving, displayname, divisie, e-mailadres, ingeschakeld, givenname, homedirectory, homedrive, homephone, initialen, manager, kantoor, organisatie, postcode, profielpad, samaccountname, scriptpath, state, streetaddress, achternaam, titel, userprincipalname. Als u dit veld leeg laat, wordt een standaardset eigenschappen geretourneerd.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Eigenschappen die moeten worden geretourneerd als verzameling
PropertiesToReturnAsCollectionJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect moet proberen terug te keren als een verzameling. Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschapsnamen te serialiseren' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Deze invoer kan worden ingevoerd in JSON- of CSV-indeling. Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf-matrix wilt retourneren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Eigenschapsnamen die moeten worden geserialiseerd
PropertyNamesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf wilt serialiseren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Eigenschapstypen die moeten worden geserialiseerd
PropertyTypesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (per type) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapsnamen om te serialiseren' te gebruiken (kies een). Deze invoer is een verzameling met één eigenschapstypeveld. Bijvoorbeeld: Als u een eigenschap van het type Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] wilt serialiseren, voer [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (JSON-tabelindeling), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-matrixindeling) of Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServiceInfoPlan[] (CSV-indeling) in.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met gebruikers (en hun aangevraagde eigenschappen) die overeenkomen met de zoekidentiteit, in JSON-indeling.

Aantal gevonden gebruikers
CountOfUsersFound integer

Het aantal gevonden gebruikers dat overeenkomt met de zoekidentiteit. Meestal 0 of 1 als u zoekt op identiteit, of 0 of meer als u zoekt op filtereigenschap.

Active Directory-gebruiker toevoegen

Hiermee maakt u een nieuw Active Directory-gebruikersaccount.

Parameters

Name Sleutel Vereist Type Description
Naam
Name True string

De naam van de Active Directory-gebruiker. Dit wordt weergegeven in de kolom 'Naam' in AD-gebruikers en -computers en bovenaan het tabblad Gebruiker 'Algemeen' (in de titel). Dit is niet de aanmeldingsnaam van de gebruiker.

Hoofdgebruikersnaam
UserPrincipalName string

De aanmeldingsnaam van de gebruiker in Active Directory. Dit moet over het algemeen de notatie 'name@domainFQDN' hebben (bijvoorbeeld 'TestUser1@domain.local'). De gebruiker kan zich aanmelden met behulp van deze indeling: name@domainFQDN.

SAM-accountnaam
SamAccountName string

De aanmeldingsnaam van de gebruiker (pre-Windows 2000) in Active Directory. Dit heeft de notatie 'name' (bijvoorbeeld 'TestUser1'). De gebruiker kan zich aanmelden met behulp van deze indeling: DOMAIN\name.

Voornaam
GivenName string

De optionele voornaam van de gebruiker.

Achternaam
SurName string

De optionele achternaam van de gebruiker.

Path
Path string

De organisatie-eenheid (OE) waarin de gebruiker moet worden opgeslagen in de indeling Distinguished Name (bijvoorbeeld OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld MyUsers\London). Als dit leeg blijft, wordt de gebruiker gemaakt in de organisatie-eenheid Gebruikers.

Description
Description string

De optionele gebruikersbeschrijving.

Weergavenaam
DisplayName string

De optionele weergavenaam van de gebruiker.

Accountwachtwoord
AccountPassword password

Het gebruikerswachtwoord. Dit moet worden opgegeven en voldoen aan de regels voor wachtwoordcomplexiteit van Active Directory. Als dit een opgeslagen wachtwoord is, voert u de notatie {IAConnectPassword:StoredPasswordIdentifier} in en stelt u de invoer 'opgeslagen wachtwoord' in op waar. Als dit een algemene Orchestrator-referentie is, voert u de indeling {OrchestratorCredential:FriendlyName} in en stelt u de invoer voor het 'opgeslagen wachtwoord' in op true.

Wachtwoord voor account is opgeslagen
AccountPasswordIsStoredPassword boolean

Ingesteld op waar als het wachtwoord een IA-Connect opgeslagen wachtwoord-id is (bijvoorbeeld: gegenereerd door de actie Wachtwoord genereren) of een IA-Connect Algemene Orchestrator-referentie (bijvoorbeeld: Als u IA-Connect gebruikt met een PA-stroom).

Ingeschakeld
Enabled boolean

Stel in op true als u wilt dat het account direct na het maken is ingeschakeld. Ingesteld op onwaar voor het account om te worden uitgeschakeld. Deze optie is standaard ingesteld op true.

De gebruiker moet het wachtwoord bij de volgende aanmelding wijzigen
ChangePasswordAtLogon boolean

Ingesteld op Waar als u wilt afdwingen dat de gebruiker het wachtwoord wijzigt wanneer hij of zij zich aanmeldt (het nieuwe wachtwoord dat hier wordt ingesteld, is een eenmalig wachtwoord om de gebruiker aan te melden). Ingesteld op onwaar als dit het wachtwoord is dat de gebruiker zal gebruiken totdat deze handmatig wordt gewijzigd. U kunt deze optie niet instellen op true op hetzelfde moment als het instellen van 'Gebruiker kan wachtwoord niet wijzigen' of 'Wachtwoord verloopt nooit' op waar.

Gebruiker kan het wachtwoord niet wijzigen
CannotChangePassword boolean

Ingesteld op True om te voorkomen dat de gebruiker het wachtwoord kan wijzigen. Ingesteld op onwaar als de gebruiker het wachtwoord kan wijzigen. U kunt deze optie niet instellen op true op hetzelfde moment als het instellen van 'Gebruiker moet wachtwoord wijzigen bij volgende aanmelding' in waar.

Wachtwoord verloopt nooit
PasswordNeverExpires boolean

Ingesteld op True als het wachtwoord nooit verloopt (dat wil bijvoorbeeld dat de gebruiker nooit wordt gevraagd het wachtwoord te wijzigen). Ingesteld op onwaar als het wachtwoord kan verlopen zoals ingesteld in active Directory-domeinbeleid. U kunt deze optie niet instellen op true op hetzelfde moment als het instellen van 'Gebruiker moet wachtwoord wijzigen bij volgende aanmelding' in waar.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
PowerShell-uitvoer-JSON
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

De DN-naam van de gebruiker gemaakt
CreatedUserDistinguishedName string

De DN (Active Directory Distinguished Name) van het gemaakte gebruikersaccount.

De sam-accountnaam van de gebruiker gemaakt
CreatedUserSAMAccountName string

De ACTIVE Directory SAM-accountnaam van het gemaakte gebruikersaccount.

User Principal Name gemaakt
CreatedUserPrincipalName string

De UPN (User Principal Name) van het gemaakte gebruikersaccount.

Active Directory-gebruiker verplaatsen naar organisatie-eenheid

Hiermee verplaatst u een Active Directory-gebruiker naar een bestaande Organisatie-eenheid (OE) van Active Directory.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Doelpad
TargetPath True string

Het pad naar de doelorganisatie-eenheid (OE) in DN-naamindeling (bijvoorbeeld OU=Doel-OE,OU=Londen,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld MyUsers\London).

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryMoveADUserToOUByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-gebruiker verwijderen

Hiermee verwijdert u een gebruiker uit Active Directory.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Beveiliging verwijderen tegen onbedoeld verwijderen
RemoveProtectionFromAccidentalDeletion boolean

Ingesteld op true om te proberen de beveiliging te verwijderen tegen onbedoelde verwijdering, voordat u de gebruiker probeert te verwijderen.

Zelfs als de gebruiker subobjecten heeft
DeleteEvenIfUserHasSubObjects boolean

Als een gebruikersaccount subobjecten heeft (de gebruiker is geen leaf-object), mislukt de normale opdracht om de gebruiker te verwijderen. Stel deze invoer in op true als u wilt terugvallen op een alternatieve verwijderingsmethode als subobjecten worden gedetecteerd.

Recursief verwijderen forceren
ForceDeleteRecursive boolean

Als een gebruikersaccount subobjecten heeft (de gebruiker is geen leaf-object), mislukt de normale opdracht om de gebruiker te verwijderen. Stel deze invoer in op true als u een recursieve subobjectverwijderen wilt uitvoeren zonder eerst de gebruiker normaal te verwijderen. Dit kan handig zijn als de terugvaldetectie niet werkt.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryRemoveADUserByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-gebruiker verwijderen uit alle groepen

Hiermee verwijdert u een Active Directory-gebruiker uit alle Active Directory-groepen waarvan ze lid zijn. IA-Connect de gebruiker uit zoveel mogelijk groepen verwijdert en rapporteert over het resultaat. Deze actie werkt alleen met gebruikersaccounts. U kunt deze actie niet gebruiken om de groepslidmaatschappen van een groep of computer te verwijderen.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity string

De gebruiker die uit alle groepen moet worden verwijderd. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

AD-groepen die moeten worden uitgesloten
GroupsToExcludeJSON string

Een lijst met AD-groepen die moeten worden uitgesloten van verwijdering, in JSON- of CSV-indeling. Bijvoorbeeld: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-tabelindeling), ["Groep 1", "Groep 2"] (JSON-matrixindeling) of Groep 1, Groep 2 (CSV-indeling). U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

Uitzondering als er geen uitgesloten groep bestaat
ExceptionIfExcludedGroupDoesNotExist boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als een van de uitgesloten groepen niet bestaat (IA-Connect moet de groep opzoeken om de DN van de groep te verkrijgen). Als deze optie is ingesteld op false (de standaardinstelling): Als een uitgesloten groep niet bestaat, wordt deze genegeerd, omdat de gebruiker geen lid kan zijn van die groep.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Uitvoeren als thread
RunAsThread boolean

Als deze optie is ingesteld op onwaar, wordt de actie door de IA-Connect-agent onmiddellijk uitgevoerd en worden de resultaten geretourneerd wanneer de actie is voltooid, maar mislukt het als het langer duurt dan de time-out van de werkrol/RPA-opdracht. Als deze optie is ingesteld op true, voert de IA-Connect Agent deze actie uit als agentthread en controleert deze totdat deze is voltooid. Hierdoor kan de actie langer worden uitgevoerd dan de time-out van de werkrol/RPA-opdracht.

Uitvoergegevens ophalen voor thread-id
RetrieveOutputDataFromThreadId integer

Als u deze actie eerder hebt uitgevoerd als agentthread en 'Seconden om te wachten op thread' hebt ingesteld op 0, geeft u de agentthread-id op om de resultaten op te halen. Deze agentthread-id is verstrekt door de eerdere aanroep van deze actie. Ingesteld op 0 (de standaardinstelling) als u deze actie gewoon uitvoert (en daarom de resultaten van een eerder exemplaar van deze actie niet als agentthread ophalen).

Seconden om te wachten op thread
SecondsToWaitForThread integer

Als 'Uitvoeren als-thread' is ingesteld op waar, hoeveel seconden moet worden gewacht totdat de agentthread is voltooid. Als de agentthread waarop deze actie wordt uitgevoerd, deze keer niet is voltooid, wordt er een uitzondering gegenereerd. Ingesteld op 0 om de wachttijd te omzeilen: de agent blijft de actie uitvoeren, maar is ook beschikbaar voor de volgende actie. Vervolgens kunt u de actieresultaten op een later tijdstip ophalen met behulp van de actie 'Wachten tot agentthread is voltooid' om te wachten totdat de agentthread is voltooid en voer deze actie Active Directory-gebruiker uit alle groepen opnieuw uit, waarbij de invoer Uitvoergegevens voor thread-id ophalen is ingesteld op de agentthread-id.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD-groepen zijn verwijderd
ADGroupsRemovedSuccessfully integer

Het aantal AD-groepen waaruit de gebruiker is verwijderd.

AD-groepen kunnen niet worden verwijderd
ADGroupsFailedToRemove integer

Het aantal AD-groepen waaruit de gebruiker niet kan verwijderen.

AD-groepen uitgesloten van verwijdering
ADGroupsExcludedFromRemoval integer

Het aantal AD-groepen dat niet kan worden verwijderd.

Foutbericht ad-groepen verwijderen
RemoveADGroupsMasterErrorMessage string

Als de gebruiker niet kan verwijderen uit een aantal AD-groepen, geeft dit foutbericht details van het probleem.

Thread-id
ThreadId integer

Als deze actie wordt uitgevoerd als een agentthread, bevat deze uitvoer de agentthread-id die kan worden gebruikt om de uitvoering van de actie te bewaken en de resultaten op te halen wanneer de actie is voltooid.

Active Directory-gebruikersaccount inschakelen

Hiermee schakelt u een Active Directory-gebruikersaccount in. Als het account niet is uitgeschakeld, doet deze opdracht niets.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryEnableADUserByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-gebruikersaccount uitschakelen

Hiermee schakelt u een Active Directory-gebruikersaccount uit. Als een gebruikersaccount is uitgeschakeld, kan de gebruiker zich niet aanmelden.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryDisableADUserByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-gebruikerseigenschappen klonen

Hiermee configureert u de opgegeven eigenschappen/kenmerken van de bron-Active Directory-gebruiker naar de doel-Active Directory-gebruiker.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit van bron
SourceUserIdentity True string

De identiteit van de Active Directory-brongebruiker (de gebruiker waaruit kenmerken moeten worden gekopieerd). U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Doelgebruikersidentiteit
DestinationUserIdentity True string

De identiteit van de doel-Active Directory-gebruiker (de gebruiker waaraan kenmerken moeten worden gekopieerd). U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Eigenschappen die moeten worden gekloond
PropertiesToClone True string

Een door komma's gescheiden lijst met gebruikerseigenschappen die moeten worden gekopieerd van de brongebruiker naar de doelgebruiker. Veelvoorkomende eigenschappen voor klonen zijn: plaats, bedrijf, land, afdeling, beschrijving, divisie, ingeschakeld, homedirectory, homedrive, homephone, manager, kantoor, organisatie, postcode, profielpad, scriptpath, staat, streetaddress.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryCloneADUserPropertiesResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-gebruikerswachtwoord opnieuw instellen

Stelt het wachtwoord van een Active Directory-gebruiker opnieuw in met een nieuw wachtwoord en stelt desgewenst wachtwoordeigenschappen in.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Nieuw wachtwoord
NewPassword True password

Het nieuwe wachtwoord. Dit moet worden opgegeven en voldoen aan de regels voor wachtwoordcomplexiteit van Active Directory. Als dit een opgeslagen wachtwoord is, voert u de notatie {IAConnectPassword:StoredPasswordIdentifier} in en stelt u de invoer 'opgeslagen wachtwoord' in op waar. Als dit een algemene Orchestrator-referentie is, voert u de indeling {OrchestratorCredential:FriendlyName} in en stelt u de invoer voor het 'opgeslagen wachtwoord' in op true.

Wachtwoord voor account is opgeslagen
AccountPasswordIsStoredPassword boolean

Ingesteld op waar als het wachtwoord een IA-Connect opgeslagen wachtwoord-id is (bijvoorbeeld: gegenereerd door de actie Wachtwoord genereren) of een IA-Connect Algemene Orchestrator-referentie (bijvoorbeeld: Als u IA-Connect gebruikt met een PA-stroom).

Eigenschappen van gebruikerswachtwoorden instellen
SetUserPasswordProperties boolean

Ingesteld op Ja (de standaardinstelling) als u opgegeven eigenschappen voor gebruikerswachtwoorden wilt instellen om het wachtwoord te wijzigen. Eigenschappen van gebruikerswachtwoorden zijn 'Wachtwoord wijzigen bij aanmelding', 'Gebruiker kan wachtwoord niet wijzigen' en 'Wachtwoord verloopt nooit'. Ingesteld op Nee om alleen het wachtwoord van de gebruiker te wijzigen, waarbij de andere invoer voor deze actie wordt genegeerd.

De gebruiker moet het wachtwoord bij de volgende aanmelding wijzigen
ChangePasswordAtLogon boolean

Ingesteld op Ja (de standaardinstelling) als u wilt afdwingen dat de gebruiker het wachtwoord wijzigt wanneer deze zich aanmeldt (het nieuwe wachtwoord dat hier wordt ingesteld, is een eenmalig wachtwoord om de gebruiker aan te melden). Ingesteld op Nee als dit het wachtwoord is dat de gebruiker zal gebruiken totdat deze handmatig wordt gewijzigd. Ingesteld op leeg/leeg om deze wachtwoordoptie ongewijzigd te laten (nieuw in IA-Connect 9.4). U kunt deze optie niet instellen op Ja op hetzelfde moment als het instellen van 'Gebruiker kan wachtwoord niet wijzigen' of 'Wachtwoord verloopt nooit' op Ja.

Gebruiker kan het wachtwoord niet wijzigen
CannotChangePassword boolean

Stel deze in op Ja om te voorkomen dat de gebruiker het wachtwoord kan wijzigen. Ingesteld op Nee (de standaardinstelling) als de gebruiker het wachtwoord kan wijzigen. Ingesteld op leeg/leeg om deze wachtwoordoptie ongewijzigd te laten (nieuw in IA-Connect 9.4). U kunt deze optie niet instellen op Ja op hetzelfde moment als het instellen van 'Gebruiker moet wachtwoord wijzigen bij volgende aanmelding' op Ja.

Wachtwoord verloopt nooit
PasswordNeverExpires boolean

Ingesteld op Ja als het wachtwoord nooit verloopt (de gebruiker wordt nooit gevraagd het wachtwoord te wijzigen). Ingesteld op Nee (de standaardinstelling) als het wachtwoord kan verlopen zoals ingesteld in active Directory-domeinbeleid. Ingesteld op leeg/leeg om deze wachtwoordoptie ongewijzigd te laten (nieuw in IA-Connect 9.4). U kunt deze optie niet instellen op Ja op hetzelfde moment als het instellen van 'Gebruiker moet wachtwoord wijzigen bij volgende aanmelding' op Ja.

Wachtwoord twee keer opnieuw instellen
ResetPasswordTwice boolean

Stel deze optie in op Ja om het wachtwoord tweemaal opnieuw in te stellen. De eerste reset is een willekeurige aanpassing van het aangevraagde nieuwe wachtwoord (hetzelfde aantal hoofdletters, kleine letters, cijfers en dezelfde symbolen, maar in een willekeurige volgorde). Dit beperkt het risico van een beveiligingsprobleem met pass-the-hash als u deze gebruiker synchroniseert met Azure Active Directory. Ingesteld op Nee (de standaardinstelling) om het aangevraagde wachtwoord in te stellen zonder eerst een willekeurig wachtwoord in te stellen.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryResetADUserPasswordByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-groep ophalen

Retourneert de eigenschappen van een opgegeven Active Directory-groep of -groepen. U kunt zoeken op identiteit (om één groep te zoeken) of met behulp van een filter (om een of meer groepen te zoeken).

Parameters

Name Sleutel Vereist Type Description
Identiteit
Identity string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op waarop u de groepen wilt filteren. Algemene eigenschapsnamen voor een groepszoekopdracht zijn: naam, beschrijving, samaccountname.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in. Als u een LDAP-filter wilt invoeren, kiest u een vergelijkingstype LDAP: LDAP-filter invoeren en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als alternatief voor het zoeken op identiteit, de waarde van de naam van de eigenschap Filter om de groepen te filteren op.

OE-basis zoeken
SearchOUBase string

De organisatie-eenheid (OE) op het hoogste niveau die u wilt doorzoeken. Alleen ondersteund bij het zoeken met behulp van een filter, niet op identiteit. Als dit niet is opgegeven, wordt het hele domein doorzocht. De organisatie-eenheid kan worden opgegeven in de indeling Distinguished Name (bijvoorbeeld OU=Londen,OU=MyGroups,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld MyGroups\London).

OE-basissubstructuur zoeken
SearchOUBaseSubtree boolean

Als deze optie is ingesteld op true (de standaardinstelling) en er een zoek-OE-basis wordt opgegeven, worden de basis van de zoek-OE en alle sub-OE's doorzocht. Als deze optie is ingesteld op onwaar en er een zoek-OE-basis wordt opgegeven, wordt alleen de zoek-OE-basis doorzocht. Deze invoer wordt niet gebruikt als er geen zoek-OE-basis wordt opgegeven of als u zoekt op identiteit.

Uitzondering genereren als de groep niet bestaat
RaiseExceptionIfGroupDoesNotExist boolean

Als deze optie is ingesteld op true en de groep niet bestaat, wordt er een uitzondering gegenereerd. Als deze optie is ingesteld op false en de groep niet bestaat, rapporteert de actie geslaagd, maar de uitvoer rapporteert dat er geen groepen zijn gevonden.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met groepen (en de aangevraagde eigenschappen) die overeenkomen met de zoekidentiteit.

Aantal gevonden groepen
CountOfGroupsFound integer

Het aantal groepen dat overeenkomt met de zoekidentiteit. Verwachte waarden zijn 0 of 1 voor een identiteitszoekopdracht of een waarde voor een filterzoekopdracht.

Active Directory-groep toevoegen

Hiermee maakt u een nieuwe Active Directory-groep.

Parameters

Name Sleutel Vereist Type Description
Naam
Name True string

De naam van de Active Directory-groep. Dit wordt weergegeven in de kolom 'Naam' in AD-gebruikers en -computers en boven aan het tabblad Groep 'Algemeen' (in de titel).

SAM-accountnaam
SamAccountName string

De groepsnaam (pre-Windows 2000) in Active Directory. Dit heeft de notatie 'name' (bijvoorbeeld 'TestGroup1').

Path
Path string

De organisatie-eenheid (OE) waarin de groep moet worden opgeslagen in DN-naamindeling (bijvoorbeeld OU=Doel-OE,OU=Londen,DC=mydomain,DC=lokaal), GUID-indeling of als pad (bijvoorbeeld MyGroups\Londen). Als dit leeg blijft, wordt de groep gemaakt in de organisatie-eenheid Gebruikers.

Description
Description string

De optionele groepsbeschrijving.

Opmerkingen
Notes string

De optionele groepsnotities.

Weergavenaam
DisplayName string

De weergavenaam van de optionele groep. In tegenstelling tot gebruikersaccounts wordt de weergavenaam van een groep niet weergegeven in AD-gebruikers en -computers.

Groepscategorie
GroupCategory True string

Het type groep dat moet worden gemaakt. Een beveiligingsgroep wordt doorgaans gebruikt voor het beheren van gebruikers- en computertoegang tot IT-resources. Een distributiegroep wordt meestal gebruikt om een groeps-e-mail te maken, zodat u een groep gebruikers kunt e-mailen.

Groepsbereik
GroupScope True string

Het bereik van de groep die moet worden gemaakt. Er is een complexe set regels waarin wordt beschreven waar naar een groep kan worden verwezen en wat in een groep kan worden geplaatst, afhankelijk van het bereik van die groep. U kunt later niet altijd converteren naar een ander groepsbereik. Kies daarom het juiste bereik bij het maken.

Startpagina
HomePage string

De optionele startpagina van de groep.

Beheerd door
ManagedBy string

Hiermee geeft u de gebruiker of groep die deze groep beheert. U kunt deze invoer opgeven in DN-naamindeling (bijvoorbeeld CN=MrBig,OU=Londen,DC=mydomain,DC=local), GUID-indeling, SID of SAMAccountName (bijvoorbeeld 'MrBig').

Beveiligd tegen onbedoeld verwijderen
ProtectedFromAccidentalDeletion boolean

Ingesteld op Waar om deze groep te beschermen tegen onbedoeld verwijderen. Ingesteld op Onwaar om de groep te laten staan op de standaardinstelling dat deze niet wordt beveiligd tegen onbedoelde verwijdering.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
PowerShell-uitvoer-JSON
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

Gemaakte DN-naam voor groep
CreatedGroupDistinguishedName string

De DN (Active Directory Distinguished Name) van de gemaakte groep.

Sam-accountnaam voor groep gemaakt
CreatedGroupSAMAccountName string

De Active Directory SAM-accountnaam van de gemaakte groep.

Active Directory-groep verwijderen

Hiermee verwijdert u een groep uit Active Directory. Als er objecten zijn (bijvoorbeeld gebruikers, groepen of computers) in de groep, worden deze objecten verwijderd als onderdeel van de verwijdering van de groep.

Parameters

Name Sleutel Vereist Type Description
Groepsidentiteit
GroupIdentity True string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Zelfs verwijderen als beveiligd
DeleteEvenIfProtected boolean

Ingesteld op True om de groep te verwijderen, zelfs als deze is beveiligd tegen verwijdering. Ingesteld op Onwaar om alleen de groep te verwijderen als deze niet is beveiligd tegen verwijderen en een uitzondering genereren als de groep is beveiligd.

Uitzondering genereren als de groep niet bestaat
RaiseExceptionIfGroupDoesNotExist boolean

Als deze optie is ingesteld op true en de groep niet bestaat, wordt er een uitzondering gegenereerd. Als deze optie is ingesteld op onwaar en de groep niet bestaat, rapporteert de actie geslaagd, maar de uitvoer rapporteert dat er geen groepen zijn verwijderd.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Aantal groepen verwijderd
NumberOfGroupsDeleted integer

Deze uitvoer bevat het aantal AD-groepen dat moet worden verwijderd. Dit moet 0 of 1 zijn.

Active Directory-groepsleden ophalen

Retourneert een lijst met leden van een Active Directory-groep.

Parameters

Name Sleutel Vereist Type Description
Groepsidentiteit
GroupIdentity True string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Recursief
Recursive boolean

Als deze optie is ingesteld op onwaar (de standaardinstelling), worden alleen directe leden van de groep geretourneerd. Als deze optie is ingesteld op waar, worden directe leden en leden van leden geretourneerd, zodat alle AD-leden op alle niveaus worden geretourneerd.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON groepsleden
GroupMembersJSON string

De lijst met AD-groepsleden, in JSON-indeling.

Aantal gevonden groepsleden
CountOfGroupMembersFound integer

Het aantal LEDEN van de AD-groep.

Active Directory-groepslid toevoegen

Voeg een Active Directory-object (meestal een gebruiker, groep of computer) toe aan een bestaande Active Directory-groep. Als groep en groepslid zich in verschillende domeinen bevinden, moet u de DN (Distinguished Name) opgeven voor zowel groep als leden.

Parameters

Name Sleutel Vereist Type Description
Groepsidentiteit
GroupIdentity string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Groepsnaam
GroupName string

Als alternatief voor zoeken op identiteit geeft u de pre-2K-naam (SAMAccountName) van de Active Directory-groep op. Omdat de invoer 'Groepsidentiteit' ook de pre-2K-naam accepteert, is deze invoer nu redundant, maar blijft behouden voor compatibiliteit met eerdere versies.

Lid van de groep
UserIdentity True string

Het groepslid dat moet worden toegevoegd (meestal een gebruiker, groep of computer). U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryAddADGroupMemberByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-groepslid verwijderen

Hiermee verwijdert u een Active Directory-lid (gebruiker, groep of computer) uit een Active Directory-groep.

Parameters

Name Sleutel Vereist Type Description
Groepsidentiteit
GroupIdentity string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Groepsnaam
GroupName string

Als alternatief voor zoeken op identiteit geeft u de pre-2K-naam (SAMAccountName) van de Active Directory-groep op. Omdat de invoer 'Groepsidentiteit' ook de pre-2K-naam accepteert, is deze invoer nu redundant, maar blijft behouden voor compatibiliteit met eerdere versies.

Lid van de groep
UserIdentity True string

Het groepslid dat moet worden verwijderd. U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryRemoveADGroupMemberByGroupIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Active Directory-object toevoegen aan meerdere groepen

Voeg een Active Directory-object (meestal een gebruiker, groep of computer) toe aan meerdere bestaande Active Directory-groepen. IA-Connect voegt het object toe aan zoveel mogelijk groepen en rapporteert over het resultaat. Als het object al lid is van een of meer van de opgegeven groepen, wordt dit geteld als een succes.

Parameters

Name Sleutel Vereist Type Description
Objectidentiteit
UserIdentity True string

Het object (meestal een gebruiker, groep of computer) die moet worden toegevoegd aan een of meer groepen. U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

AD-groepen die moeten worden toegevoegd
GroupNamesJSON string

Een lijst met ad-groepen waaraan het object moet worden toegevoegd, in JSON- of CSV-indeling. Bijvoorbeeld: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-tabelindeling), ["Groep 1", "Groep 2"] (JSON-matrixindeling) of Groep 1, Groep 2 (CSV-indeling). U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Uitzondering als groepen niet kunnen worden toegevoegd
ExceptionIfAnyGroupsFailToAdd boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als één groep niet kan worden toegevoegd (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn toegevoegd en hoeveel er niet zijn toegevoegd.

Uitzondering als alle groepen niet kunnen worden toegevoegd
ExceptionIfAllGroupsFailToAdd boolean

Als deze optie is ingesteld op true: er wordt alleen een uitzondering (fout) gegenereerd als alle groepen niet kunnen worden toegevoegd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn toegevoegd en hoeveel er niet zijn toegevoegd.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Maximum aantal groepen per gesprek
MaxGroupsPerCall integer

Als er een groot aantal AD-groepen is opgegeven voor toevoeging, kan dit een time-out veroorzaken. Door de waarde 'Maximum aantal groepen per aanroep' in te stellen op 1 of hoger, splitst de IA-Connect Orchestrator deze actie op in meerdere aanroepen naar de IA-Connect Director en Agent met het opgegeven maximum aantal groepen per aanroep. Eerst beschikbaar in IA-Connect 9.3. Als u bijvoorbeeld een waarde van 5 en 14 groepen instelt, wordt dit door orchestrator gesplitst in aanvragen van 5, 5, 4.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD-groepen zijn toegevoegd
ADGroupsAddedSuccessfully integer

Het aantal AD-groepen waaraan het object is toegevoegd.

AD-groepen kunnen niet worden toegevoegd
ADGroupsFailedToAdd integer

Het aantal AD-groepen waaraan het object niet kan worden toegevoegd.

Foutbericht AD-groepen toevoegen
AddADGroupsMasterErrorMessage string

Als het object niet kan worden toegevoegd aan een aantal AD-groepen en er geen uitzondering is gegenereerd, bevat dit foutbericht details van het probleem.

Active Directory-object verwijderen uit meerdere groepen

Hiermee verwijdert u een Active Directory-object (meestal een gebruiker, groep of computer) uit meerdere bestaande Active Directory-groepen. IA-Connect verwijdert het object uit zoveel mogelijk groepen en rapporteert het over het resultaat. Als het object geen lid is van een of meer van de opgegeven groepen, wordt dit geteld als een succes.

Parameters

Name Sleutel Vereist Type Description
Objectidentiteit
UserIdentity True string

Het object (meestal een gebruiker, groep of computer) die uit een of meer groepen moet worden verwijderd. U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

AD-groepen die moeten worden verwijderd
GroupNamesJSON string

Een lijst met de AD-groepen waaruit het object moet worden verwijderd, in JSON- of CSV-indeling. Bijvoorbeeld: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-tabelindeling), ["Groep 1", "Groep 2"] (JSON-matrixindeling) of Groep 1, Groep 2 (CSV-indeling). U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

Uitzondering als groepen niet kunnen worden verwijderd
ExceptionIfAnyGroupsFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als één groep niet kan worden verwijderd (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

Uitzondering als alle groepen niet kunnen worden verwijderd
ExceptionIfAllGroupsFailToRemove boolean

Als deze optie is ingesteld op true: er wordt alleen een uitzondering (fout) gegenereerd als alle groepen niet kunnen worden verwijderd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Maximum aantal groepen per gesprek
MaxGroupsPerCall integer

Als er een groot aantal AD-groepen is opgegeven voor verwijdering, kan dit een time-out veroorzaken. Door de waarde 'Maximum aantal groepen per aanroep' in te stellen op 1 of hoger, splitst de IA-Connect Orchestrator deze actie op in meerdere aanroepen naar de IA-Connect Director en Agent met het opgegeven maximum aantal groepen per aanroep. Eerst beschikbaar in IA-Connect 9.3. Als u bijvoorbeeld een waarde van 5 en 14 groepen instelt voor verwijdering, splitst orchestrator dit op in aanvragen van 5, 5, 4.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD-groepen zijn verwijderd
ADGroupsRemovedSuccessfully integer

Het aantal AD-groepen waaruit het object is verwijderd.

AD-groepen kunnen niet worden verwijderd
ADGroupsFailedToRemove integer

Het aantal AD-groepen waaruit het object niet kan worden verwijderd.

Foutbericht ad-groepen verwijderen
RemoveADGroupsMasterErrorMessage string

Als het object niet kan worden verwijderd uit een aantal AD-groepen en er geen uitzondering is gegenereerd, geeft dit foutbericht details van het probleem.

Active Directory OE ophalen van gebruikers-DN

Een hulpprogrammafunctie. Met de DN (Distinguished Name) van een Active Directory-gebruiker wordt de organisatie-eenheid (OE) geretourneerd waarin de gebruiker zich bevindt.

Parameters

Name Sleutel Vereist Type Description
DN van gebruiker
UserDN True string

De DN-naam van de zoekgebruiker (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=local).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
OE gebruiker
UserOU string

De organisatie-eenheid (OE) waar de gebruiker zich in bevindt.

Active Directory PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Active Directory-runspace in de sessie waarin de IA-Connect Agent wordt uitgevoerd, waarbij de inhoud van het script wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Active Directory PowerShell-code. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread.

Parameters

Name Sleutel Vereist Type Description
Inhoud van PowerShell-script
PowerShellScriptContents string

De inhoud van het PowerShell-script dat moet worden uitgevoerd in de Active Directory-runspace. IA-Connect voert dit script as-is uit door rechtstreeks door te geven aan de PowerShell-automatiseringsengine. Er wordt geen PowerShell-script op schijf gemaakt. U kunt ook een bestaand PowerShell-script op schijf uitvoeren door het volgende in te voeren: return & 'scriptpath'. Bijvoorbeeld: return &c:\scripts\ADTestScript.ps1'.

Treedt er geen fout op
IsNoResultAnError boolean

Als er geen gegevens worden geretourneerd door de PowerShell-opdracht, wordt er dan een fout voorgesteld?

Complexe typen retourneren
ReturnComplexTypes boolean

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met de invoer 'Eigenschappen die als verzameling moeten worden geretourneerd', 'Eigenschapsnamen om te serialiseren' en 'Eigenschapstypen die moeten worden geserialiseerd' kunt u opgeven welke 'complexe' eigenschappen moeten worden geretourneerd en de methode die wordt gebruikt om de gegevens op te maken (kies op basis van eigenschap per eigenschap het beste). Met deze invoer kunt u opgeven wat er moet worden gedaan met eventuele resterende eigenschappen (dat wil bijvoorbeeld eigenschappen die 'complex' zijn en niet expliciet worden genoemd). Als deze optie is ingesteld op true, probeert IA-Connect een tekenreeksweergave van de gegevens te retourneren met behulp van ToString(). Als deze optie is ingesteld op false (de standaardinstelling), retourneert IA-Connect de eigenschap niet.

Booleaanse waarde retourneren als booleaanse waarde
ReturnBooleanAsBoolean boolean

Moeten Booleaanse eigenschappen worden geretourneerd als booleaanse waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Numeriek als decimaal retourneren
ReturnNumericAsDecimal boolean

Moeten numerieke eigenschappen worden geretourneerd als numerieke waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Retourdatum als datum
ReturnDateAsDate boolean

Moeten datumeigenschappen worden geretourneerd als datums? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Eigenschappen die moeten worden geretourneerd als verzameling
PropertiesToReturnAsCollectionJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect moet proberen terug te keren als een verzameling. Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschapsnamen te serialiseren' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Deze invoer kan worden ingevoerd in JSON- of CSV-indeling. Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf-matrix wilt retourneren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Script uitvoeren als thread
RunScriptAsThread boolean

Als deze optie is ingesteld op onwaar (de standaardinstelling), wordt het PowerShell-script direct uitgevoerd door de IA-Connect Agent en worden de resultaten geretourneerd naar de directeur wanneer het script is voltooid. Als u een lang of complex PowerShell-script uitvoert, kan er een time-out optreden voor deze actie. Als dit is ingesteld op true, voert de IA-Connect Agent het PowerShell-script uit als agentthread en kan de IA-Connect Director (of Orchestrator, PowerShell-module, Blue Prism) de status van deze agentthread controleren, waarna deze is voltooid. Hierdoor kunnen lange of complexe PowerShell-scripts zonder time-outs worden uitgevoerd. IA-Connect Agents 9.3 en eerder kunnen PowerShell-scripts niet als agentthread worden uitgevoerd.

Uitvoergegevens ophalen voor thread-id
RetrieveOutputDataFromThreadId integer

Als u eerder een PowerShell-script als agentthread hebt uitgevoerd en 'Seconden om te wachten op thread' hebt ingesteld op 0, geeft u de agentthread-id op om de resultaten op te halen. Deze agentthread-id is verstrekt door de eerdere aanroep van deze actie. Ingesteld op 0 (de standaardinstelling) als u gewoon een PowerShell-script uitvoert (en daarom de resultaten van een vorige PowerShell-scriptuitvoering als agentthread niet ophalen).

Seconden om te wachten op thread
SecondsToWaitForThread integer

Als 'Script uitvoeren als thread' is ingesteld op waar, hoeveel seconden er moet worden gewacht totdat de agentthread is voltooid. Als de agentthread met het PowerShell-script op dit moment niet is voltooid, wordt er een uitzondering gegenereerd. Ingesteld op 0 om de wachttijd te omzeilen: de agent blijft het PowerShell-script uitvoeren, maar is ook beschikbaar voor de volgende actie. Vervolgens kunt u de scriptresultaten op een later tijdstip ophalen met behulp van de actie 'Wachten tot agentthread is voltooid' om te wachten totdat de agentthread is voltooid en voer vervolgens deze actie PowerShell-script uitvoeren opnieuw uit met de invoer Uitvoergegevens ophalen voor thread-id ingesteld op de agentthread-id.

Script bevat opgeslagen wachtwoord
ScriptContainsStoredPassword boolean

Ingesteld op true als het script een IA-Connect opgeslagen wachtwoord-id bevat, in de indeling {IAConnectPassword:StoredPasswordIdentifier} of een IA-Connect Orchestrator generic credential, in de indeling {OrchestratorCredential:FriendlyName}. De woordgroep { } wordt vervangen door het opgegeven wachtwoord, ontsnapt en tussen enkele aanhalingstekens geplaatst (tenzij deze al tussen aanhalingstekens in het script staat).

Uitgebreide uitvoer van logboek
LogVerboseOutput boolean

Ingesteld op waar om uitgebreide PowerShell-uitvoer in de IA-Connect-logboeken te registreren. Dit kan handig zijn voor foutopsporing. Als u uitgebreid wilt registreren in uw script, gebruikt u de volgende PowerShell: Write-Verbose 'Mijn bericht' -Uitgebreid.

Eigenschapsnamen die moeten worden geserialiseerd
PropertyNamesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf wilt serialiseren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Eigenschapstypen die moeten worden geserialiseerd
PropertyTypesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (per type) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapsnamen om te serialiseren' te gebruiken (kies een). Deze invoer is een verzameling met één eigenschapstypeveld. Bijvoorbeeld: Als u een eigenschap van het type Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] wilt serialiseren, voer [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (JSON-tabelindeling), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-matrixindeling) of Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServiceInfoPlan[] (CSV-indeling) in.

Naam
Name string

De naam van de PowerShell-invoerparameter. Dit moet voldoen aan de naamgevingsindelingen van PowerShell-variabelen (dat wil gezegd worden aanbevolen om spaties of speciale symbolen te voorkomen). Namen van PowerShell-variabelen zijn niet hoofdlettergevoelig. Bijvoorbeeld: MyVariable resulteert in een variabele $MyVariable wordt gemaakt.

Tekenreekswaarde
StringValue string

De tekenreekswaarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een Booleaanse of numerieke waarde invoert.

Integerwaarde
IntValue integer

De waarde voor een geheel getal (geheel getal) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Booleaanse waarde
BooleanValue boolean

De booleaanse waarde (waar of onwaar) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks of numerieke waarde invoert.

Decimale waarde
DecimalValue double

De decimale waarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks, booleaanse waarde of een geheel getal invoert.

Objectwaarde
ObjectValue object

De objectwaarde die moet worden toegewezen aan de PowerShell-invoerparameter. Dit wordt een met JSON geserialiseerde tekenreeksvariabele in het PowerShell-script, dus deserialiseren naar een object met behulp van ConvertFrom-Json. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
PowerShell-uitvoer-JSON
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

Thread-id
ThreadId integer

Als het PowerShell-script wordt uitgevoerd als een agentthread, bevat deze uitvoer de agentthread-id die kan worden gebruikt om de uitvoering van het PowerShell-script te bewaken en de Resultaten van het PowerShell-script op te halen wanneer het script is voltooid.

Active Directory-server instellen

Hiermee stelt u een specifieke Active Directory-server in die moet worden gebruikt voor alle verdere Active Directory-acties.

Parameters

Name Sleutel Vereist Type Description
Vooraf gedefinieerde AD-serverkeuze
PredefinedADServerChoice string

GEBRUIKERS-PDC: de PDC-emulator voor het domein waartoe de momenteel aangemelde gebruiker behoort, wordt gebruikt. Computer PDC: De PDC-emulator voor het domein waarop de computer (waarop de IA-Connect sessie wordt uitgevoerd) behoort, wordt gebruikt. Handmatig: Voer de Active Directory-domeincontroller (DC) in het veld AD-server in. Als dit veld leeg is en het veld AD-server een waarde heeft, wordt die waarde gebruikt.

AD-server
ADServer string

Dit veld wordt alleen gebruikt als de vooraf gedefinieerde AD-serverkeuze is ingesteld op 'Handmatig' (of leeg). De naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen voor alle verdere Active Directory-acties. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectorySetADServerResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Algemene gebruikerseigenschappen van Active Directory wijzigen

Algemene eigenschappen van een Active Directory-gebruiker wijzigen. U kunt alleen waarden toewijzen aan eigenschappen, niet op leeg instellen. Als u eigenschappen wilt instellen op leeg, gebruikt u de actie 'Eigenschappen van Active Directory-gebruikersreeks wijzigen'.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

City
City string

De eigenschap Plaats van de gebruiker (op het tabblad Adres in AD-gebruikers en -computers).

Bedrijf
Company string

De eigenschap 'Bedrijf' van de gebruiker (op het tabblad Organisatie in AD-gebruikers en -computers).

Landcode
Country string

De eigenschap Land van de gebruiker (op het tabblad Adres in AD-gebruikers en -computers). Dit moet een landcode van twee tekens zijn (bijvoorbeeld GB voor Verenigd Koninkrijk, VS voor Verenigde Staten, FR voor Frankrijk, ES voor Spanje, JP voor Japan). Dit wordt toegewezen aan de eigenschap c in het Active Directory-schema. IA-Connect 'Landcode' niet automatisch toe te wijzen aan 'Country string' en 'Country ISO 3166 value' zodat u een opzoektabel moet gebruiken.

Landtekenreeks
CountryString string

De volledige naam van de eigenschap Land van de gebruiker (op het tabblad Adres in AD-gebruikers en -computers). Dit is de volledige gelokaliseerde weergavetekenreeks (bijvoorbeeld 'Verenigd Koninkrijk', 'Verenigde Staten', 'Frankrijk', 'Spanje' of 'Japan'). Dit wordt toegewezen aan de eigenschap Co in het Active Directory-schema. IA-Connect wijst 'Landreeks' niet automatisch toe aan 'Landcode' en 'Land ISO 3166-waarde' zodat u een opzoektabel moet gebruiken.

Land ISO 3166-waarde
CountryISO3166 string

De ISO3166 code voor de eigenschap Land van de gebruiker (op het tabblad Adres in AD-gebruikers en -computers). Dit is een geheel getal van 3 cijfers (bijvoorbeeld 826 voor Verenigd Koninkrijk, 840 voor De Verenigde Staten, 250 voor Frankrijk, 724 voor Spanje, 392 voor Japan). Dit wordt toegewezen aan de eigenschap 'countryCode' in het Active Directory-schema. IA-Connect 'Land ISO 3166-waarde' niet automatisch toe te wijzen aan 'Landcode' en 'Landtekenreeks', zodat u een opzoektabel moet gebruiken.

Afdeling
Department string

De eigenschap Afdeling van de gebruiker (op het tabblad Organisatie in AD-gebruikers en -computers).

Description
Description string

De eigenschap Beschrijving van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

Weergavenaam
DisplayName string

De weergavenaam van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

E-mailadres
EmailAddress string

De eigenschap E-mail van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

Voornaam
GivenName string

De voornaam van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

Telefoonnummer thuis
HomePhone string

De eigenschap 'Start' van het telefoonnummer van de gebruiker (op het tabblad Telefoon in AD-gebruikers en -computers).

Initialen
Initials string

De initialen van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

IP-telefoonnummer
IPPhone string

De eigenschap IP-telefoon van de gebruiker (op het tabblad Telefoon in AD-gebruikers en -computers).

Directeur
Manager string

De eigenschap Manager van de gebruiker (op het tabblad Organisatie in AD-gebruikers en -computers). U kunt een manager opgeven in DN-naamindeling (bijvoorbeeld CN=MrBig,OU=Londen,DC=mydomain,DC=local), GUID-indeling, SID of SAMAccountName (bijvoorbeeld 'MrBig').

Mobiel telefoonnummer
MobilePhone string

De eigenschap Mobiele telefoonnummer van de gebruiker (op het tabblad Telefoons in AD-gebruikers en -computers).

Opmerkingen
Notes string

De eigenschap Notities van de gebruiker (op het tabblad Telefoon in AD-gebruikers en -computers). Dit wordt toegewezen aan de eigenschap Info in het Active Directory-schema.

Kantoor
Office string

De eigenschap Office van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

Telefoonnummer (Office)
OfficePhone string

De eigenschap Telefoonnummer van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

Postcode/postcode
PostalCode string

De eigenschap Postcode van de gebruiker (op het tabblad Adres in AD-gebruikers en -computers).

Profielpad
ProfilePath string

De eigenschap Profielpad van de gebruiker (op het tabblad Profiel in AD-gebruikers en -computers).

Aanmeldingsscript
ScriptPath string

De eigenschap 'Aanmeldingsscript' van de gebruiker (op het tabblad Profiel in AD-gebruikers en -computers).

Staat/provincie
State string

De eigenschap Staat/provincie van de gebruiker (op het tabblad Adres in AD-gebruikers en -computers).

Straatadres
StreetAddress string

De eigenschap 'Adres' van de gebruiker (op het tabblad Adres in AD-gebruikers en -computers).

Achternaam
Surname string

De eigenschap Achternaam van de gebruiker (op het tabblad Algemeen in AD-gebruikers en -computers).

Functietitel
Title string

De eigenschap Functie van de gebruiker (op het tabblad Organisatie in AD-gebruikers en -computers).

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryModifyADUserPropertiesResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Alle Azure AD-gebruikerslicenties verwijderen

Hiermee verwijdert u alle Azure AD-gebruikerslicenties (SKU) die aan een gebruiker zijn toegewezen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2RemoveAllAzureADUserLicenseResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Automatische antwoorden instellen (niet aanwezig) voor een Microsoft Exchange-postvak

Automatische antwoorden (niet aanwezig) instellen voor een Microsoft Exchange-postvak. Deze actie werkt niet voor extern postvak in Microsoft Exchange Online of Office 365: Gebruik in plaats daarvan de actie Automatische antwoorden instellen (niet aanwezig) voor een Office 365-postvak.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Automatische antwoordstatus
AutoReplyState True string

Hiermee kunt u automatische antwoorden in- of uitschakelen.

Intern bericht
InternalMessage string

Het automatische antwoordbericht (niet aanwezig) dat naar interne afzenders moet worden verzonden. Ingesteld op leeg om het bericht te verwijderen.

Externe doelgroep
ExternalAudience string

Hiermee kunt u opgeven of automatische antwoorden naar externe doelgroepen worden verzonden. Antwoorden worden standaard verzonden naar alle externe afzenders.

Extern bericht
ExternalMessage string

Het automatische antwoordbericht (niet aanwezig) dat naar externe afzenders moet worden verzonden, als de externe doelgroep is ingesteld op 'Alle' of 'Bekend'. Ingesteld op leeg om het bericht te verwijderen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeSetMailboxAutoReplyConfigurationResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Automatische antwoorden instellen (niet aanwezig) voor een Office 365-postvak

Automatische antwoorden (niet aanwezig) instellen voor een Microsoft Exchange Online- of Office 365-postvak.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Automatische antwoordstatus
AutoReplyState True string

Hiermee kunt u automatische antwoorden in- of uitschakelen.

Intern bericht
InternalMessage string

Het automatische antwoordbericht (niet aanwezig) dat naar interne afzenders moet worden verzonden. Ingesteld op leeg om het bericht te verwijderen.

Externe doelgroep
ExternalAudience string

Hiermee kunt u opgeven of automatische antwoorden naar externe doelgroepen worden verzonden. Antwoorden worden standaard verzonden naar alle externe afzenders.

Extern bericht
ExternalMessage string

Het automatische antwoordbericht (niet aanwezig) dat naar externe afzenders moet worden verzonden, als de externe doelgroep is ingesteld op 'Alle' of 'Bekend'. Ingesteld op leeg om het bericht te verwijderen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365SetO365MailboxAutoReplyConfigurationResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-beveiliging of Microsoft 365-groep verwijderen

Een Azure Active Directory-beveiligingsgroep of Microsoft 365-groep verwijderen. Met deze actie kunnen beveiligingsgroepen of distributielijsten waarvoor e-mail is ingeschakeld, niet worden verwijderd: gebruik in plaats daarvan de actie Office 365-distributiegroep verwijderen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Groepsobject-id of weergavenaam
GroupObjectId True string

De id of weergavenaam van een Azure Active Directory-groep. U kunt een groep opgeven op weergavenaam (bijvoorbeeld 'Financiële gebruikers') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Uitzondering als de groep niet bestaat
ErrorIfGroupDoesNotExist boolean

Moet er een uitzondering optreden als de groep niet bestaat? Ingesteld op onwaar om niets te doen als de groep niet bestaat (bijvoorbeeld dat de groep al is verwijderd). Ingesteld op waar als de groep die niet bestaat een fout is (dat wil bijvoorbeeld dat deze bestaat).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Groep bestaat
GroupExisted boolean

Als de groep bestaat en is verwijderd, wordt deze ingesteld op true. Als de groep niet bestond (en 'Fout als de groep niet bestaat' is ingesteld op onwaar, zodat er geen uitzondering is gegenereerd), wordt deze ingesteld op onwaar om u te laten weten dat de groep niet bestond en daarom IA-Connect geen actie hoefde uit te voeren.

Azure AD-gebruiker inschakelen

Hiermee schakelt u een Azure Active Directory-gebruiker in. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2EnableUserResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruiker toevoegen

Hiermee maakt u een nieuw Azure Active Directory-gebruikersaccount. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Hoofdgebruikersnaam
UserPrincipalName True string

De aanmeldingsnaam van de gebruiker in Azure Active Directory. Dit moet over het algemeen de notatie 'name@domainFQDN' hebben (bijvoorbeeld 'TestUser1@mydomain.onmicrosoft.com').

Account ingeschakeld
AccountEnabled True boolean

Stel in op true als u wilt dat het account direct na het maken is ingeschakeld. Ingesteld op onwaar voor het account om te worden uitgeschakeld. Deze optie is standaard ingesteld op true.

Accountwachtwoord
AccountPassword True password

Het gebruikerswachtwoord. Dit moet worden opgegeven en voldoen aan de regels voor wachtwoordcomplexiteit van Azure Active Directory. Als dit een opgeslagen wachtwoord is, voert u de notatie {IAConnectPassword:StoredPasswordIdentifier} in en stelt u de invoer 'opgeslagen wachtwoord' in op waar. Als dit een algemene Orchestrator-referentie is, voert u de indeling {OrchestratorCredential:FriendlyName} in en stelt u de invoer voor het 'opgeslagen wachtwoord' in op true.

Wachtwoord voor account is opgeslagen
AccountPasswordIsStoredPassword boolean

Ingesteld op waar als het wachtwoord een IA-Connect opgeslagen wachtwoord-id is (bijvoorbeeld: gegenereerd door de actie Wachtwoord genereren) of een IA-Connect Algemene Orchestrator-referentie (bijvoorbeeld: Als u IA-Connect gebruikt met een PA-stroom).

Voornaam
FirstName string

De voornaam van de gebruiker.

Achternaam
LastName string

De familienaam/achternaam/achternaam van de gebruiker.

Weergavenaam
DisplayName True string

De volledige weergavenaam voor deze gebruiker.

City
City string

De naam van de plaats waar de gebruiker woont of waar het kantoor zich bevindt.

Bedrijfsnaam
CompanyName string

De naam van het bedrijf waarvoor de gebruiker werkt.

Land of regio
Country string

Het land of de regio waarin de gebruiker zich bevindt of waar het kantoor zich bevindt.

Afdeling
Department string

De naam van de afdeling waarvoor de gebruiker in het bedrijf werkt.

Faxnummer
FaxNumber string

Het faxnummer van de gebruiker (facsimile).

Functietitel
JobTitle string

De functie van de gebruiker.

Bijnaam van e-mail
MailNickName True string

De bijnaam van de e-mail van de gebruiker.

Mobiel telefoonnummer
MobilePhone string

Het mobiele telefoonnummer van de gebruiker.

Kantoor
Office string

De locatie van het kantoor waar de gebruiker werkt.

Telefoonnummer
PhoneNumber string

Het telefoonnummer van de gebruiker.

Postcode
PostalCode string

De postcode waar de gebruiker woont, of het kantoor waarin hij of zij werkt.

Voorkeurstaal
PreferredLanguage string

De voorkeurstaal van de gebruiker. Dit wordt meestal ingevoerd als een taalcode van twee letters (ISO 639-1), gevolgd door een streepje, gevolgd door een tweeletterige hoofdletter landcode (ISO 3166). Bijvoorbeeld: en-US, en-GB, fr-FR, ja-JP.

Staat of provincie
State string

De staat, provincie of provincie waar de gebruiker woont of waar het kantoor zich bevindt.

Straatadres
StreetAddress string

Het adres waar de gebruiker woont of het adres van het kantoor.

Gebruikslocatie
UsageLocation string

Een landcode van twee letters (ISO 3166). Vereist voor gebruikers waaraan licenties worden toegewezen vanwege een wettelijke vereiste. Bijvoorbeeld: VS (Verenigde Staten), JP (Japan), GB (Verenigd Koninkrijk), FR (Frankrijk), IN (India). Zie https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes.

Leeftijdsgroep
AgeGroup string

De leeftijdsgroep van de gebruiker, voor ouderlijk toezicht. De standaardwaarde is geen/niet opgegeven die (vanuit het perspectief van besturingselementen) hetzelfde is als Volwassenen.

Toestemming gegeven voor secundaire
ConsentProvidedForMinor string

Als de 'Leeftijdsgroep' 'Secundair' is, kunt u in dit veld opgeven of er toestemming is gegeven voor de minderjarige, voor ouderlijk toezicht.

Werknemer-id
EmployeeId string

Een optionele werknemer-id. U kunt dit gebruiken om uniek onderscheid te maken tussen elke gebruiker in uw organisatie.

Wachtwoord voor wijziging afdwingen bij volgende aanmelding
ForceChangePasswordNextLogin boolean

Ingesteld op waar als u wilt afdwingen dat de gebruiker het wachtwoord wijzigt wanneer hij of zij zich de volgende keer aanmeldt (het nieuwe wachtwoord dat hier wordt ingesteld, is een eenmalig wachtwoord waarmee de gebruiker zich kan aanmelden). Ingesteld op onwaar als dit het wachtwoord is dat de gebruiker zal gebruiken totdat deze handmatig wordt gewijzigd.

Wachtwoordbeleid voor wijzigingen afdwingen
EnforceChangePasswordPolicy boolean

Stel deze optie in op waar om het wachtwoordbeleid voor Azure Active Directory-wijzigingen af te dwingen, die (afhankelijk van uw omgeving) kan definiëren hoe vaak de gebruiker het wachtwoord, de opties voor wachtwoordherstel en aanvullende beveiligingsverificatie moet wijzigen. Dit kan ertoe leiden dat de gebruiker om aanvullende informatie wordt gevraagd.

Wachtwoord verloopt nooit
PasswordNeverExpires boolean

Ingesteld op True als het wachtwoord nooit verloopt (dat wil bijvoorbeeld dat de gebruiker nooit wordt gevraagd het wachtwoord te wijzigen). Ingesteld op onwaar als het wachtwoord kan verlopen zoals ingesteld in het Azure Active Directory-wachtwoordbeleid.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

User Principal Name gemaakt
CreatedUserPrincipalName string

De UPN (User Principal Name) van azure Active Directory van het gemaakte gebruikersaccount.

Gebruikersobject-id gemaakt
CreatedUserObjectId string

De Azure Active Directory-gebruikersobject-id van het gemaakte gebruikersaccount.

Azure AD-gebruiker toevoegen aan groep

Voeg een Azure Active Directory-gebruiker toe aan een bestaande Azure Active Directory-beveiliging of M365-groep. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Groepsobject-id of weergavenaam
GroupObjectId True string

De id of weergavenaam van een Azure Active Directory-groep. U kunt een groep opgeven op weergavenaam (bijvoorbeeld 'Financiële gebruikers') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Controleer eerst de lidmaatschappen van gebruikersgroepen
CheckUserGroupMembershipsFirst boolean

Als deze optie is ingesteld op waar, controleert IA-Connect de groepslidmaatschappen van de gebruiker voordat ze aan de groep worden toegevoegd. Als de gebruiker al lid is van de groep, rapporteert IA-Connect gewoon succes zonder iets te hoeven doen. Als deze optie is ingesteld op false, voegt IA-Connect de gebruiker onmiddellijk toe aan de groep zonder controle, wat resulteert in een fout als de gebruiker al in de groep is.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2AddUserToGroupResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruiker toevoegen aan meerdere groepen

Voegt een Azure Active Directory-gebruiker toe aan meerdere bestaande Azure Active Directory-groepen waarbij de groepen worden opgegeven met object-id of weergavenaam. IA-Connect voegt de gebruiker toe aan zoveel mogelijk groepen en rapporteert over het resultaat. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Azure AD-groepen die u wilt toevoegen
GroupNamesJSON string

Een lijst met de id's of weergavenamen van Azure AD-groepen waaraan de gebruiker moet worden toegevoegd, in JSON- of CSV-indeling. Bijvoorbeeld: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-tabelindeling), ["Groep 1", "Groep 2"] (JSON-matrixindeling) of Groep 1, Groep 2 (CSV-indeling).

Uitzondering als groepen niet kunnen worden toegevoegd
ExceptionIfAnyGroupsFailToAdd boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als één groep niet kan worden toegevoegd (dat wil bijvoorbeeld 100% geslaagd is). Sommige groepen (bijvoorbeeld: Office 365-groepen) kunnen niet worden toegevoegd, zodat een uitzondering gebruikelijk kan zijn. Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn toegevoegd en hoeveel er niet zijn toegevoegd.

Uitzondering als alle groepen niet kunnen worden toegevoegd
ExceptionIfAllGroupsFailToAdd boolean

Als deze optie is ingesteld op true: er wordt alleen een uitzondering (fout) gegenereerd als alle groepen niet kunnen worden toegevoegd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn toegevoegd en hoeveel er niet zijn toegevoegd.

Controleer eerst de lidmaatschappen van gebruikersgroepen
CheckUserGroupMembershipsFirst boolean

Als deze optie is ingesteld op waar, controleert IA-Connect de groepslidmaatschappen van de gebruiker voordat ze aan de groep worden toegevoegd. Als de gebruiker al lid is van de groep, rapporteert IA-Connect gewoon succes zonder iets te hoeven doen. Als deze optie is ingesteld op false, voegt IA-Connect de gebruiker onmiddellijk toe aan de groep zonder controle, wat resulteert in een fout als de gebruiker al in de groep is.

Maximum aantal Azure AD-groepen per aanroep
MaxAzureADGroupsPerCall integer

Als er een groot aantal Azure AD-groepen is opgegeven voor toevoeging, kan dit een time-out veroorzaken. Door de waarde 'Max Azure AD-groepen per aanroep' in te stellen op 1 of hoger, splitst de IA-Connect Orchestrator deze actie op in meerdere aanroepen naar de IA-Connect Director en Agent met het opgegeven maximum aantal groepen per aanroep. Als u bijvoorbeeld een waarde van 5 en 14 groepen instelt, moet de Orchestrator deze splitsen in aanvragen van 5, 5, 4.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Azure AD-groepen zijn toegevoegd
AzureADGroupsAddedSuccessfully integer

Het aantal Azure AD-groepen waaraan de gebruiker is toegevoegd.

Azure AD-groepen kunnen niet worden toegevoegd
AzureADGroupsFailedToAdd integer

Het aantal Azure AD-groepen waaraan de gebruiker niet kan toevoegen.

Azure AD-groepshoofdfoutbericht toevoegen
AddAzureADGroupsMasterErrorMessage string

Als de gebruiker een aantal Azure AD-groepen niet kan toevoegen en er geen uitzondering is gegenereerd, bevat dit foutbericht details van het probleem.

Azure AD-gebruiker toewijzen aan beheerdersrol

Wijs een Azure Active Directory-gebruiker (of ander object) toe aan een bestaande Azure Active Directory-beheerdersrol. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Id of weergavenaam van rolobject
RoleObjectId True string

De id of weergavenaam van een Azure Active Directory-beheerdersrol. U kunt een AAD-beheerdersrol opgeven op weergavenaam (bijvoorbeeld 'Toepassingsontwikkelaar') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Mapbereik-id
DirectoryScopeId string

De mapbereik-id voor de roltoewijzing. Bijvoorbeeld: / vertegenwoordigt de hele tenant, /GUID vertegenwoordigt een app-registratie, /administrativeUnits/GUID vertegenwoordigt een beheereenheid.

Controleer eerst lidmaatschappen van gebruikersrollen
CheckUserRoleMembershipsFirst boolean

Als deze optie is ingesteld op true (de standaardinstelling), controleert IA-Connect de roltoewijzingen van de gebruiker voordat ze aan de rol worden toegewezen. Als de gebruiker al aan de rol is toegewezen, rapporteert IA-Connect gewoon succes zonder iets te hoeven doen. Als deze optie is ingesteld op onwaar, wijst IA-Connect de gebruiker onmiddellijk toe aan de rol zonder controle, wat resulteert in een fout als de gebruiker al aan de rol is toegewezen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2AssignUserToRoleResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruiker toewijzen aan meerdere beheerdersrollen

Wijs een Azure Active Directory-gebruiker (of ander object) toe aan een of meer bestaande Azure Active Directory-beheerdersrollen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Id's of weergavenamen van rolobjecten
RolesJSON string

Een lijst met de beheerdersrollen die moeten worden toegewezen aan de gebruiker, in JSON- of CSV-indeling. Bijvoorbeeld: [{"Role": "Application Developer"}, {"Role": "Exchange Administrator"}] (JSON-tabelindeling), ["Application Developer", "Exchange Administrator"] (JSON-matrixindeling) of Application Developer, Exchange Administrator (CSV-indeling). U kunt een AAD-beheerdersrol opgeven op weergavenaam (bijvoorbeeld 'Toepassingsontwikkelaar') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Uitzondering als rollen niet kunnen worden toegewezen
ExceptionIfAnyRolesFailToAssign boolean

Als deze is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als een enkele Azure AD-beheerdersrol niet kan worden toegewezen (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel Azure AD-beheerdersrollen zijn toegewezen en hoeveel er niet kunnen worden toegewezen.

Uitzondering als alle rollen niet kunnen worden toegewezen
ExceptionIfAllRolesFailToAssign boolean

Als deze optie is ingesteld op true: er wordt alleen een uitzondering (fout) gegenereerd als alle Azure AD-beheerdersrollen niet kunnen worden toegewezen (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel Azure AD-beheerdersrollen zijn toegewezen en hoeveel er niet kunnen worden toegewezen.

Mapbereik-id
DirectoryScopeId string

De mapbereik-id voor alle rollen die worden toegewezen. Bijvoorbeeld: / vertegenwoordigt de hele tenant, /GUID vertegenwoordigt een app-registratie, /administrativeUnits/GUID vertegenwoordigt een beheereenheid.

Controleer eerst lidmaatschappen van gebruikersrollen
CheckUserRoleMembershipsFirst boolean

Als deze optie is ingesteld op true (de standaardinstelling), controleert IA-Connect de roltoewijzingen van de gebruiker voordat ze aan de rol worden toegewezen. Als de gebruiker al aan de rol is toegewezen, rapporteert IA-Connect gewoon succes zonder iets te hoeven doen. Als deze optie is ingesteld op onwaar, wijst IA-Connect de gebruiker onmiddellijk toe aan de rol zonder controle, wat resulteert in een fout als de gebruiker al aan de rol is toegewezen.

Controleren of er rol-id's bestaan
CheckRoleIdsExist boolean

Als deze optie is ingesteld op true (de standaardinstelling) en een of meer van de rollen zijn opgegeven in object-id-indeling, controleert IA-Connect of deze rol-id's geldig zijn. Dit wordt aanbevolen omdat het foutbericht dat is ontvangen van Azure AD, niet nuttig is wanneer u een ongeldige object-id opgeeft. Als deze optie is ingesteld op onwaar, controleert IA-Connect niet de geldigheid van opgegeven rol-id's, wat sneller is.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Toegewezen Azure AD-rollen
AzureADRolesAssignedSuccessfully integer

Het aantal Azure AD-rollen dat is toegewezen.

Azure AD-rollen kunnen niet worden toegewezen
AzureADRolesFailedToAssign integer

Het aantal Azure AD-rollen dat niet kan worden toegewezen.

Foutbericht azure AD-rollen toewijzen
AssignAzureADRolesMasterErrorMessage string

Als sommige rollen niet kunnen worden toegewezen en er geen uitzondering is gegenereerd, bevat dit foutbericht details van het probleem.

Azure AD-gebruiker uit groep verwijderen

Hiermee verwijdert u een Azure Active Directory-gebruiker uit een Azure Active Directory-groep. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Groepsobject-id of weergavenaam
GroupObjectId True string

De id of weergavenaam van een Azure Active Directory-groep. U kunt een groep opgeven op weergavenaam (bijvoorbeeld 'Financiële gebruikers') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Controleer eerst de lidmaatschappen van gebruikersgroepen
CheckUserGroupMembershipsFirst boolean

Als deze optie is ingesteld op true, controleert IA-Connect de groepslidmaatschappen van de gebruiker voordat ze uit de groep worden verwijderd. Als de gebruiker geen lid is van de groep, rapporteert IA-Connect gewoon succes zonder iets te hoeven doen. Als deze optie is ingesteld op false, verwijdert IA-Connect de gebruiker onmiddellijk uit de groep zonder controle, wat resulteert in een fout als de gebruiker zich niet in de groep bevindt.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2RemoveUserFromGroupResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruiker uit meerdere groepen verwijderen

Hiermee verwijdert u een Azure Active Directory-gebruiker uit meerdere bestaande Azure Active Directory-groepen waarbij de groepen worden opgegeven met object-id of weergavenaam. IA-Connect de gebruiker uit zoveel mogelijk groepen verwijdert en rapporteert over het resultaat. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Azure AD-groepen die moeten worden verwijderd
GroupNamesJSON string

Een lijst met de id's of weergavenamen van Azure AD-groepen waaruit de gebruiker moet worden verwijderd, in JSON- of CSV-indeling. Bijvoorbeeld: [{"GroupName": "Group 1"}, {"GroupName": "Group 2"}] (JSON-tabelindeling), ["Groep 1", "Groep 2"] (JSON-matrixindeling) of Groep 1, Groep 2 (CSV-indeling).

Uitzondering als groepen niet kunnen worden verwijderd
ExceptionIfAnyGroupsFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als één groep niet kan worden verwijderd (dat wil bijvoorbeeld 100% geslaagd is). Sommige groepen (bijvoorbeeld: Office 365-groepen) kunnen niet worden verwijderd, zodat een uitzondering gebruikelijk kan zijn. Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

Uitzondering als alle groepen niet kunnen worden verwijderd
ExceptionIfAllGroupsFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als alle groepen niet kunnen worden verwijderd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

Controleer eerst de lidmaatschappen van gebruikersgroepen
CheckUserGroupMembershipsFirst boolean

Als deze optie is ingesteld op true, controleert IA-Connect de groepslidmaatschappen van de gebruiker voordat ze uit elke groep worden verwijderd. Als de gebruiker geen lid is van een bepaalde groep, rapporteert IA-Connect gewoon succes voor die groep zonder iets te hoeven doen. Als deze optie is ingesteld op onwaar, verwijdert IA-Connect de gebruiker onmiddellijk uit elke opgegeven groep zonder controle, wat resulteert in een fout als de gebruiker zich niet in de groep bevindt.

Maximum aantal Azure AD-groepen per aanroep
MaxAzureADGroupsPerCall integer

Als de gebruiker lid is van een groot aantal Azure AD-groepen, kan dit een time-out veroorzaken. Door de waarde 'Max Azure AD-groepen per aanroep' in te stellen op 1 of hoger, splitst de IA-Connect Orchestrator deze actie op in meerdere aanroepen naar de IA-Connect Director en Agent met het opgegeven maximum aantal groepen per aanroep. Als u bijvoorbeeld een waarde van 5 en 14 groepen instelt, moet de Orchestrator deze splitsen in aanvragen van 5, 5, 4.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Azure AD-groepen zijn verwijderd
AzureADGroupsRemovedSuccessfully integer

Het aantal Azure AD-groepen waaruit de gebruiker is verwijderd.

Verwijderen van Azure AD-groepen is mislukt
AzureADGroupsFailedToRemove integer

Het aantal Azure AD-groepen waaruit de gebruiker niet kan verwijderen.

Foutbericht over hoofdfout van Azure AD-groepen verwijderen
RemoveAzureADGroupsErrorMessage string

Als de gebruiker niet kan verwijderen uit een aantal Azure AD-groepen en er geen uitzondering is opgetreden, geeft dit foutbericht details van het probleem.

Azure AD-gebruiker uitschakelen

Hiermee schakelt u een Azure Active Directory-gebruiker uit. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Tokens voor het vernieuwen van gebruikers intrekken
RevokeUserRefreshTokens boolean

Ingesteld op True om vernieuwingstokens in te trekken die zijn uitgegeven aan de gebruiker, waardoor geopende sessies niet meer werken, meestal binnen het uur (wanneer hun sessies proberen een vernieuwingstoken te gebruiken om de verbinding actief te houden).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2DisableUserResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruiker verwijderen

Een Azure Active Directory-gebruiker verwijderen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Uitzondering als de gebruiker niet bestaat
ErrorIfUserDoesNotExist boolean

Moet er een uitzondering optreden als de gebruiker niet bestaat? Ingesteld op onwaar om niets te doen als de gebruiker niet bestaat (bijvoorbeeld dat deze al is verwijderd). Ingesteld op true als de gebruiker die niet bestaat een fout is (dat wil bijvoorbeeld dat deze bestaat).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Gebruiker bestond
UserExisted boolean

Als de gebruiker bestaat en is verwijderd, wordt dit ingesteld op true. Als de gebruiker niet bestond (en 'Fout als de gebruiker niet bestaat' is ingesteld op onwaar, zodat er geen uitzondering is gegenereerd), wordt deze ingesteld op onwaar om u te laten weten dat de gebruiker niet bestond en daarom IA-Connect geen actie hoefde uit te voeren.

Azure AD-gebruiker verwijderen uit alle beheerdersroltoewijzingen

Hiermee verwijdert u een Azure Active Directory-gebruiker (of ander object) uit alle Azure Active Directory-beheerdersrollen waaraan ze zijn toegewezen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Uitzondering als rollen niet kunnen worden verwijderd
ExceptionIfAnyRolesFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als een enkele beheerdersrol niet kan worden verwijderd (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel rollen zijn verwijderd en hoeveel niet kunnen worden verwijderd.

Uitzondering als alle rollen niet kunnen worden verwijderd
ExceptionIfAllRolesFailToRemove boolean

Als deze optie is ingesteld op true (de standaardinstelling): er wordt een uitzondering (fout) gegenereerd als alle beheerdersrollen niet kunnen worden verwijderd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel rollen zijn verwijderd en hoeveel niet kunnen worden verwijderd.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Azure AD-rollen zijn verwijderd
AzureADRolesRemovedSuccessfully integer

Het aantal Azure AD-rollen waaruit de gebruiker is verwijderd.

Verwijderen van Azure AD-rollen is mislukt
AzureADRolesFailedToRemove integer

Het aantal Azure AD-rollen waaruit de gebruiker niet kan verwijderen.

Foutbericht over hoofdfouten van Azure AD-rollen verwijderen
RemoveAzureADRolesErrorMessage string

Als de gebruiker niet kan worden verwijderd uit een aantal Azure AD-rollen en er geen uitzondering is opgetreden, bevat dit foutbericht details van het probleem.

Azure AD-gebruiker verwijderen uit alle groepen

Hiermee verwijdert u een Azure Active Directory-gebruiker uit alle Azure Active Directory-groepen waarvan ze lid zijn. Met deze actie kunnen distributielijsten of beveiligingsgroepen met e-mail niet worden gewijzigd. Gebruik in plaats daarvan de Office 365 Exchange Online-acties. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Uitzondering als groepen niet kunnen worden verwijderd
ExceptionIfAnyGroupsFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als één groep niet kan worden verwijderd (dat wil bijvoorbeeld 100% geslaagd is). Sommige groepen (bijvoorbeeld: Office 365-groepen) kunnen niet worden verwijderd, zodat een uitzondering gebruikelijk kan zijn. Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

Uitzondering als alle groepen niet kunnen worden verwijderd
ExceptionIfAllGroupsFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als alle groepen niet kunnen worden verwijderd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

Maximum aantal Azure AD-groepen per aanroep
MaxAzureADGroupsPerCall integer

Als de gebruiker lid is van een groot aantal Azure AD-groepen, kan dit een time-out veroorzaken. Door de waarde 'Max Azure AD-groepen per aanroep' in te stellen op 1 of hoger, splitst de IA-Connect Orchestrator deze actie op in meerdere aanroepen naar de IA-Connect Director en Agent met het opgegeven maximum aantal groepen per aanroep. Als u bijvoorbeeld een waarde van 5 en 14 groepen instelt, moet de Orchestrator deze splitsen in aanvragen van 5, 5, 4.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Azure AD-groepen zijn verwijderd
AzureADGroupsRemovedSuccessfully integer

Het aantal Azure AD-groepen waaruit de gebruiker is verwijderd.

Verwijderen van Azure AD-groepen is mislukt
AzureADGroupsFailedToRemove integer

Het aantal Azure AD-groepen waaruit de gebruiker niet kan verwijderen.

Foutbericht over hoofdfout van Azure AD-groepen verwijderen
RemoveAzureADGroupsErrorMessage string

Als de gebruiker niet kan verwijderen uit een aantal Azure AD-groepen en er geen uitzondering is opgetreden, geeft dit foutbericht details van het probleem.

Azure AD-gebruiker verwijderen uit beheerdersroltoewijzing

Verwijder een Azure Active Directory-gebruiker (of ander object) uit een bestaande Azure Active Directory-beheerdersroltoewijzing. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Id of weergavenaam van rolobject
RoleObjectId True string

De id of weergavenaam van een Azure Active Directory-beheerdersrol. U kunt een AAD-beheerdersrol opgeven op weergavenaam (bijvoorbeeld 'Toepassingsontwikkelaar') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Mapbereik-id
DirectoryScopeId string

Een optionele mapbereik-id die overeenkomt met de roltoewijzing die is opgegeven voor verwijdering. Bijvoorbeeld: / vertegenwoordigt de hele tenant (en resulteert in alleen benoemde roltoewijzingen met een mapbereik-id van / te verwijderen), /GUID vertegenwoordigt een app-registratie, /administrativeUnits/GUID vertegenwoordigt een beheereenheid. Als u een roltoewijzing wilt verwijderen, ongeacht het adreslijstbereik, geeft u * of een lege waarde op.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Gebruiker verwijderd uit rol
UserRemovedFromRole boolean

Waar als de gebruiker is verwijderd uit de rol. Onwaar als de gebruiker niet is toegewezen aan de rol (dus er was niets te doen).

Azure AD-gebruiker verwijderen uit meerdere beheerdersrollen

Hiermee verwijdert u een Azure Active Directory-gebruiker (of een ander object) uit een of meer bestaande Azure Active Directory-beheerdersrollen. Deze actie doorloopt de lijst met roltoewijzingen van de gebruiker en verwijdert overeenkomende items, dus als u niet-bestaande rollen opgeeft om te verwijderen, wordt er geen fout geactiveerd (omdat er niets wordt geprobeerd als de gebruiker zich niet in die rol bevindt). Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Id's of weergavenamen van rolobjecten
RolesJSON string

Een lijst met de beheerdersrollen die moeten worden toegewezen aan de gebruiker, in JSON- of CSV-indeling. Bijvoorbeeld: [{"Role": "Application Developer"}, {"Role": "Exchange Administrator"}] (JSON-tabelindeling), ["Application Developer", "Exchange Administrator"] (JSON-matrixindeling) of Application Developer, Exchange Administrator (CSV-indeling). U kunt een AAD-beheerdersrol opgeven op weergavenaam (bijvoorbeeld 'Toepassingsontwikkelaar') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Mapbereik-id
DirectoryScopeId string

Een optionele mapbereik-id die overeenkomt met de roltoewijzingen die zijn opgegeven voor verwijdering. Bijvoorbeeld: / vertegenwoordigt de hele tenant (en resulteert in alleen benoemde roltoewijzingen met een mapbereik-id van / te verwijderen), /GUID vertegenwoordigt een app-registratie, /administrativeUnits/GUID vertegenwoordigt een beheereenheid. Als u een benoemde roltoewijzing wilt verwijderen, ongeacht het adreslijstbereik, geeft u * of een lege waarde op.

Uitzondering als rollen niet kunnen worden verwijderd
ExceptionIfAnyRolesFailToRemove boolean

Als deze is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als een enkele Azure AD-beheerdersrol niet kan worden verwijderd (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel Azure AD-beheerdersrollen zijn verwijderd en hoeveel niet kunnen worden verwijderd.

Uitzondering als alle rollen niet kunnen worden verwijderd
ExceptionIfAllRolesFailToRemove boolean

Als deze optie is ingesteld op true: er wordt alleen een uitzondering (fout) gegenereerd als alle Azure AD-beheerdersrollen niet kunnen worden verwijderd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel Azure AD-beheerdersrollen zijn verwijderd en hoeveel niet kunnen worden verwijderd.

Uitzondering als er geen rol bestaat
ExceptionIfRoleDoesNotExist boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als een van de rollen die zijn opgegeven voor verwijdering niet bestaat. Als deze optie is ingesteld op onwaar (de standaardinstelling): Als er geen rol bestaat die is opgegeven voor verwijdering, wordt deze genegeerd, omdat de gebruiker er niet aan kan worden toegewezen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Azure AD-rollen zijn verwijderd
AzureADRolesRemovedSuccessfully integer

Het aantal Azure AD-rollen dat is verwijderd. Hiermee worden alleen rollen geteld die daadwerkelijk zijn verwijderd (rollen die de gebruiker niet heeft gebruikt, tellen niet).

Verwijderen van Azure AD-rollen is mislukt
AzureADRolesFailedToRemove integer

Het aantal Azure AD-rollen dat niet kan worden verwijderd.

Foutbericht over Azure AD-rollen verwijderen
RemoveAzureADRolesMasterErrorMessage string

Als sommige rollen niet kunnen worden verwijderd en er geen uitzondering is opgetreden, bevat dit foutbericht details van het probleem.

Azure AD-gebruikers ophalen

Retourneert de details van gebruikers in Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). U kunt zoeken op object-id of met behulp van een filter. Een object-id-zoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId string

De object-id van een Azure Active Directory-gebruiker waarnaar moet worden gezocht. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor het zoeken op gebruikersobject-id geeft u de naam van de eigenschap op waarop de gebruikers moeten worden gefilterd. Algemene eigenschapsnamen zijn: UserPrincipalName en DisplayName. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op gebruikersobject-id, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'UserPrincipalName' is, kan de vergelijking gelijk zijn aan of 'begint met'). Als u een onbewerkt filter wilt invoeren (in ODATA 3-indeling), kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op gebruikersobject-id, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap userPrincipalName is, is de waarde van de filtereigenschap mogelijk 'JohnDoe@mydomain.com').

Is geen resultaat een uitzondering
NoResultIsAnException boolean

Ingesteld op True om een uitzondering te genereren als er geen gebruikers worden gevonden. Ingesteld op Onwaar om een telling van 0 te rapporteren als er geen postvakken worden gevonden. Houd er rekening mee dat de optie 'onwaar' mogelijk niet werkt wanneer deze wordt gebruikt met identiteit in niet-Engelse talen, dus overweeg in plaats daarvan te zoeken met behulp van filters.

Eigenschappen die moeten worden geretourneerd
PropertiesToReturn string

Een door komma's gescheiden lijst met gebruikerseigenschappen die moeten worden geretourneerd (ophalen). Veelvoorkomende eigenschappen zijn: AccountEnabled, Plaats, Bedrijfsnaam, Land, Afdeling, DisplayName, GivenName, JobTitle, PostalCode, State, StreetAddress, Surname, UserPrincipalName. Als u dit veld leeg laat, wordt een standaardset eigenschappen opgehaald. Als u eigenschappen opgeeft die moeten worden opgehaald, worden alleen deze eigenschappen opgehaald. Heeft geen effect als u de PowerShell-modules van Azure AD v2 gebruikt.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met gebruikers die overeenkomen met het zoekfilter, in JSON-indeling.

Aantal gevonden gebruikers
CountOfUsersFound integer

Het aantal gebruikers dat overeenkomt met de id van het zoekobject, de UPN of het filter.

Azure AD-gebruikerseigenschappen opnieuw instellen

Algemene eigenschappen van een Azure Active Directory-gebruiker opnieuw instellen op een lege waarde. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Voornaam opnieuw instellen
ResetFirstName boolean

Stel in op True om de voornaam van de gebruiker opnieuw in te stellen op leeg.

Achternaam opnieuw instellen
ResetLastName boolean

Ingesteld op true om de familienaam van de gebruiker/achternaam/achternaam opnieuw in te stellen op leeg.

Plaats opnieuw instellen
ResetCity boolean

Stel in op true om de naam van de plaats waar de gebruiker woont opnieuw in te stellen of waar het kantoor zich bevindt, leeg is.

Bedrijfsnaam opnieuw instellen
ResetCompanyName boolean

Ingesteld op True om de naam van het bedrijf opnieuw in te stellen waarvoor de gebruiker werkt.

Land of regio opnieuw instellen
ResetCountry boolean

Stel in op True om het land of de regio waar de gebruiker zich bevindt, opnieuw in te stellen of waar het kantoor zich bevindt.

Afdeling opnieuw instellen
ResetDepartment boolean

Stel in op true om de naam van de afdeling opnieuw in te stellen waarvoor de gebruiker binnen het bedrijf werkt, leeg te maken.

Faxnummer opnieuw instellen
ResetFaxNumber boolean

Ingesteld op True om het telefoonnummer (facsimile) opnieuw in te stellen op leeg.

Functie opnieuw instellen
ResetJobTitle boolean

Ingesteld op True om de functie van de gebruiker opnieuw in te stellen op leeg.

Mobiel telefoonnummer opnieuw instellen
ResetMobilePhone boolean

Ingesteld op True om het mobiele telefoonnummer van de gebruiker opnieuw in te stellen op leeg.

Kantoor opnieuw instellen
ResetOffice boolean

Stel in op True om de naam van het kantoor waar de gebruiker werkt, opnieuw in te stellen.

Telefoonnummer opnieuw instellen
ResetPhoneNumber boolean

Ingesteld op True om het telefoonnummer van de gebruiker opnieuw in te stellen op leeg.

Postcode of postcode opnieuw instellen
ResetPostalCode boolean

Stel in op True om de postcode opnieuw in te stellen waar de gebruiker zich bevindt, of het kantoor waarin hij of zij werkt.

Voorkeurstaal opnieuw instellen
ResetPreferredLanguage boolean

Stel in op True om de voorkeurstaal van de gebruiker opnieuw in te stellen op leeg.

Status of provincie opnieuw instellen
ResetState boolean

Ingesteld op waar om de staat, provincie of provincie waar de gebruiker zich bevindt, opnieuw in te stellen of waar het kantoor zich in leeg bevindt.

Straatadres opnieuw instellen
ResetStreetAddress boolean

Stel in op Waar om het adres van de gebruiker opnieuw in te stellen, of het adres van het kantoor op leeg.

Gebruikslocatie opnieuw instellen
ResetUsageLocation boolean

Ingesteld op True om de gebruikslocatie leeg te maken. Dit is vereist voor gebruikers aan wie licenties worden toegewezen vanwege een wettelijke vereiste, dus het opnieuw instellen op leeg is waarschijnlijk het verbreken van dingen.

Leeftijdsgroep opnieuw instellen
ResetAgeGroup boolean

Ingesteld op True om de leeftijdsgroep van de gebruiker opnieuw in te stellen voor ouderlijk toezicht op leeg.

Toestemming opnieuw instellen voor secundaire
ResetConsentProvidedForMinor boolean

Stel in op True om opnieuw in te stellen of toestemming is verstrekt voor de minderjarige, voor ouderlijk toezicht, op leeg.

Werknemer-id opnieuw instellen
ResetEmployeeId boolean

Stel in op True om de werknemer-id leeg te maken. U kunt dit gebruiken om uniek onderscheid te maken tussen elke gebruiker in uw organisatie.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2ResetAzureADUserPropertiesResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruikerseigenschappen wijzigen

Algemene eigenschappen van een Azure Active Directory-gebruiker wijzigen. U kunt alleen waarden toewijzen aan eigenschappen, niet instellen op leeg, omdat een lege waarde wordt geïnterpreteerd als een intentie om de waarde ongewijzigd te laten. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Voornaam
FirstName string

De voornaam van de gebruiker.

Achternaam
LastName string

De familienaam/achternaam/achternaam van de gebruiker.

Weergavenaam
DisplayName string

De volledige weergavenaam voor deze gebruiker.

City
City string

De naam van de plaats waar de gebruiker woont of waar het kantoor zich bevindt.

Bedrijfsnaam
CompanyName string

De naam van het bedrijf waarvoor de gebruiker werkt.

Land of regio
Country string

Het land of de regio waarin de gebruiker zich bevindt of waar het kantoor zich bevindt.

Afdeling
Department string

De naam van de afdeling waarvoor de gebruiker in het bedrijf werkt.

Faxnummer
FaxNumber string

Het faxnummer van de gebruiker (facsimile).

Functietitel
JobTitle string

De functie van de gebruiker.

Mobiel telefoonnummer
MobilePhone string

Het mobiele telefoonnummer van de gebruiker.

Kantoor
Office string

De locatie van het kantoor waar de gebruiker werkt.

Telefoonnummer
PhoneNumber string

Het telefoonnummer van de gebruiker.

Postcode
PostalCode string

De postcode waar de gebruiker woont, of het kantoor waarin hij of zij werkt.

Voorkeurstaal
PreferredLanguage string

De voorkeurstaal van de gebruiker. Dit wordt meestal ingevoerd als een taalcode van twee letters (ISO 639-1), gevolgd door een streepje, gevolgd door een tweeletterige hoofdletter landcode (ISO 3166). Bijvoorbeeld: en-US, en-GB, fr-FR, ja-JP.

Staat of provincie
State string

De staat, provincie of provincie waar de gebruiker woont of waar het kantoor zich bevindt.

Straatadres
StreetAddress string

Het adres waar de gebruiker woont of het adres van het kantoor.

Gebruikslocatie
UsageLocation string

Een landcode van twee letters (ISO 3166). Vereist voor gebruikers waaraan licenties worden toegewezen vanwege een wettelijke vereiste. Bijvoorbeeld: VS (Verenigde Staten), JP (Japan), GB (Verenigd Koninkrijk), FR (Frankrijk), IN (India). Zie https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes.

Leeftijdsgroep
AgeGroup string

De leeftijdsgroep van de gebruiker, voor ouderlijk toezicht.

Toestemming gegeven voor secundaire
ConsentProvidedForMinor string

Als de 'Leeftijdsgroep' 'Secundair' is, kunt u in dit veld opgeven of er toestemming is gegeven voor de minderjarige, voor ouderlijk toezicht.

Bijnaam van e-mail
MailNickName string

De bijnaam van de e-mail van de gebruiker.

Werknemer-id
EmployeeId string

De werknemer-id. U kunt dit gebruiken om uniek onderscheid te maken tussen elke gebruiker in uw organisatie.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2SetAzureADUserResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruikerslicentie instellen

Hiermee voegt u een Azure AD-gebruikerslicentie (SKU) toe of verwijdert u deze. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Licentie om toe te voegen
LicenseToAdd string

Eén Azure AD-licentie-SKU die moet worden toegevoegd. Dit kan worden ingevoerd als een SKU-id (een GUID) of een SKU-onderdeelnummer (een woord). Bijvoorbeeld: TEAMS_EXPLORATORY. Als u meerdere licenties wilt inschakelen, roept u deze actie eenmaal per licentie aan.

Licentieplannen om toe te voegen
LicensePlansChoice string

Sommige licenties hebben abonnementen: als u alle abonnementen wilt inschakelen (of niet weet), kiest u 'Alles'. Als u alleen bepaalde benoemde abonnementen wilt inschakelen, kiest u 'Opt-in' en voert u de plannen in die u wilt inschakelen in het veld Csv voor licentieplannen. Als u alle abonnementen wilt inschakelen, behalve de abonnementen die u opgeeft, kiest u Opt-out en voert u de plannen in die u wilt uitschakelen in het veld Csv-licentieabonnementen.

Licentieabonnementen
LicensePlansCSV string

Een door komma's gescheiden lijst (CSV) van de licentieplannen (een onderdeel van de licentie) om deze in of uit te schakelen. Als u dit veld leeg laat, worden alle licentieplannen ingeschakeld. Dit kan worden ingevoerd als een SKU-id (een GUID) of een SKU-onderdeelnummer (een woord). Bijvoorbeeld: YAMMER_ENTERPRISE, SHAREPOINTSTANDARD.

Licenties om te verwijderen
LicensesToRemoveCSV string

Een door komma's gescheiden lijst met Azure AD-licentie-SKU's die moeten worden verwijderd. Dit kan worden ingevoerd als een door komma's gescheiden lijst met SKU-id (een GUID) of SKU-onderdeelnummer (een woord). Bijvoorbeeld: TEAMS_EXPLORATORY,FLOW_FREE.

Gebruikslocatie
UsageLocation string

Een landcode van twee letters (ISO 3166). Vereist voor gebruikers waaraan licenties worden toegewezen vanwege een wettelijke vereiste. Bijvoorbeeld: VS (Verenigde Staten), JP (Japan), GB (Verenigd Koninkrijk), FR (Frankrijk), IN (India). Zie https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes. Als u deze waarde niet instelt, moet de gebruiker al zijn of haar gebruikslocatie instellen of kan de licentie niet worden toegepast.

Lokaal PowerShell-bereik
LocalScope boolean

Als de onderliggende Azure AD v2 PowerShell-opdracht moet worden uitgevoerd in het lokale bereik. Dit is standaard niet ingesteld en daarom valt PowerShell terug op de standaardinstellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2SetAzureADUserLicenseResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-gebruikerslicenties ophalen

Hiermee haalt u een lijst met licenties (SKU) op die zijn toegewezen aan een Azure AD-gebruiker. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
SKU JSON met gebruikerslicentie
UserLicenseSKUJSONOutput string

De lijst met Azure AD-licentie-SKU's die zijn toegewezen aan de gebruiker, in JSON-indeling.

Aantal gevonden gebruikerslicentie-SKU's
CountOfUserLicenseSKUsFound integer

Het aantal Azure AD-licentie-SKU's dat is toegewezen aan de gebruiker.

Azure AD-gebruikerswachtwoord opnieuw instellen

Hiermee stelt u het wachtwoord van een Azure Active Directory-gebruiker opnieuw in met een nieuw wachtwoord. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Hoofdgebruikersnaam
UserPrincipalName True string

De aanmeldingsnaam van de gebruiker in Azure Active Directory. Dit moet over het algemeen de notatie 'name@domainFQDN' hebben (bijvoorbeeld 'TestUser1@mydomain.onmicrosoft.com').

Nieuw wachtwoord
NewPassword True password

Het nieuwe wachtwoord. Dit moet worden opgegeven en voldoen aan de regels voor wachtwoordcomplexiteit van Azure Active Directory. Als dit een opgeslagen wachtwoord is, voert u de notatie {IAConnectPassword:StoredPasswordIdentifier} in en stelt u de invoer 'opgeslagen wachtwoord' in op waar. Als dit een algemene Orchestrator-referentie is, voert u de indeling {OrchestratorCredential:FriendlyName} in en stelt u de invoer voor het 'opgeslagen wachtwoord' in op true.

Wachtwoord voor account is opgeslagen
AccountPasswordIsStoredPassword boolean

Ingesteld op waar als het wachtwoord een IA-Connect opgeslagen wachtwoord-id is (bijvoorbeeld: gegenereerd door de actie Wachtwoord genereren) of een IA-Connect Algemene Orchestrator-referentie (bijvoorbeeld: Als u IA-Connect gebruikt met een PA-stroom).

Wachtwoord voor wijziging afdwingen bij volgende aanmelding
ForceChangePasswordNextLogin boolean

Ingesteld op waar als u wilt afdwingen dat de gebruiker het wachtwoord wijzigt wanneer hij of zij zich de volgende keer aanmeldt (het nieuwe wachtwoord dat hier wordt ingesteld, is een eenmalig wachtwoord waarmee de gebruiker zich kan aanmelden). Ingesteld op onwaar als dit het wachtwoord is dat de gebruiker zal gebruiken totdat deze handmatig wordt gewijzigd.

Wachtwoordbeleid voor wijzigingen afdwingen
EnforceChangePasswordPolicy boolean

Stel deze optie in op waar om het wachtwoordbeleid voor Azure Active Directory-wijzigingen af te dwingen, die (afhankelijk van uw omgeving) kan definiëren hoe vaak de gebruiker het wachtwoord, de opties voor wachtwoordherstel en aanvullende beveiligingsverificatie moet wijzigen. Dit kan ertoe leiden dat de gebruiker om aanvullende informatie wordt gevraagd.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2ResetAzureADUserPasswordResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Azure AD-groepen ophalen

Retourneert de details van groepen in Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). U kunt zoeken op object-id of met behulp van een filter. Een object-id-zoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Groepsobject-id
ObjectId string

De object-id van een Azure Active Directory-groep waarnaar moet worden gezocht. U kunt een groep opgeven op weergavenaam (bijvoorbeeld 'Financiële gebruikers') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op groepsobject-id geeft u de naam van de eigenschap op waarop u de groepen wilt filteren. Algemene groepseigenschapsnamen zijn: Beschrijving, DisplayName en Mail. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op groepsobject-id, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'DisplayName' is, kan de vergelijking 'gelijk aan' of 'begint met'). Als u een onbewerkt filter wilt invoeren (in ODATA 3-indeling), kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op groepsobject-id, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'DisplayName' is, kan de waarde van de filtereigenschap 'London users' zijn).

Is geen resultaat een uitzondering
NoResultIsAnException boolean

Stel in op True om een uitzondering te genereren als er geen groepen worden gevonden. Ingesteld op onwaar om een telling van 0 te melden als er geen groepen worden gevonden. Houd er rekening mee dat de optie 'onwaar' mogelijk niet werkt wanneer deze wordt gebruikt met identiteit in niet-Engelse talen, dus overweeg in plaats daarvan te zoeken met behulp van filters.

Eigenschappen die moeten worden geretourneerd
PropertiesToReturn string

Een door komma's gescheiden lijst (CSV) van alle groepseigenschappen die moeten worden geretourneerd (ophalen). Als deze optie leeg is (de standaardinstelling), retourneert IA-Connect een standaardset algemene groepseigenschappen. Als u de PowerShell-modules van Microsoft Graph Users gebruikt, kunt u met de invoer de geretourneerde eigenschappen beperken of aanvullende eigenschappen retourneren. Als u Azure AD v2 gebruikt, kunt u met de invoer alleen de geretourneerde eigenschappen beperken.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met groepen die overeenkomen met de id of het filter van het zoekobject, in JSON-indeling.

Aantal gevonden groepen
CountOfGroupsFound integer

Het aantal gevonden groepen dat overeenkomt met de id of het filter van het zoekobject.

Azure AD-groepsleden ophalen

Retourneert een lijst met leden van een Azure Active Directory-groep. Leden kunnen gebruikers, groepen, apparaten of service-principals/bedrijfstoepassingen zijn. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Groepsobject-id of UPN
GroupObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Eigenschappen die moeten worden geretourneerd
PropertiesToReturn string

Een door komma's gescheiden lijst (CSV) van alle lideigenschappen die moeten worden geretourneerd (ophalen). Indien leeg (de standaardinstelling), retourneert IA-Connect AccountEnabled, DirSyncEnabled, DisplayName, Mail, MailNickName, ObjectId, ObjectType, SecurityEnabled, UserPrincipalName. Voer * in om alle eigenschappen te ontvangen.

Lidobjecttypen die moeten worden geretourneerd
MemberObjectTypesToReturn string

Een door komma's gescheiden lijst (CSV) van alle lidobjecttypen die moeten worden geretourneerd (ophalen). Als dit veld leeg is (de standaardinstelling), retourneert IA-Connect alle lidobjecttypen. Dit kan een of meer van de volgende zijn: Gebruiker, Groep,Apparaat,ServicePrincipal.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON groepsleden
PowerShellJSONOutput string

De lijst met AD-groepsleden, in JSON-indeling.

Aantal gevonden groepsleden
CountOfGroupMembersFound integer

Het aantal Azure AD-groepsleden.

Azure AD-licentie-SKU's ophalen

Retourneert een lijst met Azure Active Directory-licentie-SKU's (Stock Keeping Units) waarop de verbonden Azure AD is geabonneerd. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Eigenschap uitvouwen
ExpandProperty string

Een optionele licentie-eigenschap die moet worden uitgebreid en opgenomen in de uitvoer. Als u PrepaidUnits uitvouwt, worden licentiegegevens inclusief het totale aantal ingeschakelde licenties opgenomen in de uitvoer. Als u 'ServicePlans' uitvouwt, wordt elk afzonderlijk serviceplan binnen een SKU geretourneerd als een afzonderlijk uitvoerregelitem. U kunt slechts één eigenschap tegelijk uitbreiden.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Licentie-SKU JSON
LicenseSKUJSONOutput string

De lijst met geabonneerde voorraad-eenheden, in JSON-indeling.

Aantal gevonden SKU's
CountOfSKUsFound integer

Het aantal azure AD geabonneerde voorraadbeheereenheden (SKU's).

Azure AD PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Azure Active Directory-runspace (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD) in de sessie waarin de IA-Connect Agent wordt uitgevoerd, waarbij de scriptinhoud wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Azure AD PowerShell-scripts. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules.

Parameters

Name Sleutel Vereist Type Description
Inhoud van PowerShell-script
PowerShellScriptContents string

De inhoud van het PowerShell-script dat moet worden uitgevoerd in de Azure AD v2-runspace. IA-Connect voert dit script as-is uit door rechtstreeks door te geven aan de PowerShell-automatiseringsengine. Er wordt geen PowerShell-script op schijf gemaakt. U kunt ook een bestaand PowerShell-script op schijf uitvoeren door het volgende in te voeren: return & 'scriptpath'. Bijvoorbeeld: return &c:\scripts\AzureADTestScript.ps1'.

Treedt er geen fout op
IsNoResultAnError boolean

Als er geen gegevens worden geretourneerd door de PowerShell-opdracht, wordt er dan een fout voorgesteld?

Complexe typen retourneren
ReturnComplexTypes boolean

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met de invoer 'Eigenschappen die als verzameling moeten worden geretourneerd', 'Eigenschapsnamen om te serialiseren' en 'Eigenschapstypen die moeten worden geserialiseerd' kunt u opgeven welke 'complexe' eigenschappen moeten worden geretourneerd en de methode die wordt gebruikt om de gegevens op te maken (kies op basis van eigenschap per eigenschap het beste). Met deze invoer kunt u opgeven wat er moet worden gedaan met eventuele resterende eigenschappen (dat wil bijvoorbeeld eigenschappen die 'complex' zijn en niet expliciet worden genoemd). Als deze optie is ingesteld op true, probeert IA-Connect een tekenreeksweergave van de gegevens te retourneren met behulp van ToString(). Als deze optie is ingesteld op false (de standaardinstelling), retourneert IA-Connect de eigenschap niet.

Booleaanse waarde retourneren als booleaanse waarde
ReturnBooleanAsBoolean boolean

Moeten Booleaanse eigenschappen worden geretourneerd als booleaanse waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Numeriek als decimaal retourneren
ReturnNumericAsDecimal boolean

Moeten numerieke eigenschappen worden geretourneerd als numerieke waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Retourdatum als datum
ReturnDateAsDate boolean

Moeten datumeigenschappen worden geretourneerd als datums? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Eigenschappen die moeten worden geretourneerd als verzameling
PropertiesToReturnAsCollectionJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect moet proberen terug te keren als een verzameling. Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschapsnamen te serialiseren' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Deze invoer kan worden ingevoerd in JSON- of CSV-indeling. Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf-matrix wilt retourneren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Script uitvoeren als thread
RunScriptAsThread boolean

Als deze optie is ingesteld op onwaar (de standaardinstelling), wordt het PowerShell-script direct uitgevoerd door de IA-Connect Agent en worden de resultaten geretourneerd naar de directeur wanneer het script is voltooid. Als u een lang of complex PowerShell-script uitvoert, kan er een time-out optreden voor deze actie. Als dit is ingesteld op true, voert de IA-Connect Agent het PowerShell-script uit als agentthread en kan de IA-Connect Director (of Orchestrator, PowerShell-module, Blue Prism) de status van deze agentthread controleren, waarna deze is voltooid. Hierdoor kunnen lange of complexe PowerShell-scripts zonder time-outs worden uitgevoerd. IA-Connect Agents 9.3 en eerder kunnen PowerShell-scripts niet als agentthread worden uitgevoerd.

Uitvoergegevens ophalen voor thread-id
RetrieveOutputDataFromThreadId integer

Als u eerder een PowerShell-script als agentthread hebt uitgevoerd en 'Seconden om te wachten op thread' hebt ingesteld op 0, geeft u de agentthread-id op om de resultaten op te halen. Deze agentthread-id is verstrekt door de eerdere aanroep van deze actie. Ingesteld op 0 (de standaardinstelling) als u gewoon een PowerShell-script uitvoert (en daarom de resultaten van een vorige PowerShell-scriptuitvoering als agentthread niet ophalen).

Seconden om te wachten op thread
SecondsToWaitForThread integer

Als 'Script uitvoeren als thread' is ingesteld op waar, hoeveel seconden er moet worden gewacht totdat de agentthread is voltooid. Als de agentthread met het PowerShell-script op dit moment niet is voltooid, wordt er een uitzondering gegenereerd. Ingesteld op 0 om de wachttijd te omzeilen: de agent blijft het PowerShell-script uitvoeren, maar is ook beschikbaar voor de volgende actie. Vervolgens kunt u de scriptresultaten op een later tijdstip ophalen met behulp van de actie 'Wachten tot agentthread is voltooid' om te wachten totdat de agentthread is voltooid en voer vervolgens deze actie PowerShell-script uitvoeren opnieuw uit met de invoer Uitvoergegevens ophalen voor thread-id ingesteld op de agentthread-id.

Script bevat opgeslagen wachtwoord
ScriptContainsStoredPassword boolean

Ingesteld op true als het script een IA-Connect opgeslagen wachtwoord-id bevat, in de indeling {IAConnectPassword:StoredPasswordIdentifier} of een IA-Connect Orchestrator generic credential, in de indeling {OrchestratorCredential:FriendlyName}. De woordgroep { } wordt vervangen door het opgegeven wachtwoord, ontsnapt en tussen enkele aanhalingstekens geplaatst (tenzij deze al tussen aanhalingstekens in het script staat).

Uitgebreide uitvoer van logboek
LogVerboseOutput boolean

Ingesteld op waar om uitgebreide PowerShell-uitvoer in de IA-Connect-logboeken te registreren. Dit kan handig zijn voor foutopsporing. Als u uitgebreid wilt registreren in uw script, gebruikt u de volgende PowerShell: Write-Verbose 'Mijn bericht' -Uitgebreid.

Eigenschapsnamen die moeten worden geserialiseerd
PropertyNamesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf wilt serialiseren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Eigenschapstypen die moeten worden geserialiseerd
PropertyTypesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (per type) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapsnamen om te serialiseren' te gebruiken (kies een). Deze invoer is een verzameling met één eigenschapstypeveld. Bijvoorbeeld: Als u een eigenschap van het type Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] wilt serialiseren, voer [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (JSON-tabelindeling), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-matrixindeling) of Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServiceInfoPlan[] (CSV-indeling) in.

Naam
Name string

De naam van de PowerShell-invoerparameter. Dit moet voldoen aan de naamgevingsindelingen van PowerShell-variabelen (dat wil gezegd worden aanbevolen om spaties of speciale symbolen te voorkomen). Namen van PowerShell-variabelen zijn niet hoofdlettergevoelig. Bijvoorbeeld: MyVariable resulteert in een variabele $MyVariable wordt gemaakt.

Tekenreekswaarde
StringValue string

De tekenreekswaarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een Booleaanse of numerieke waarde invoert.

Integerwaarde
IntValue integer

De waarde voor een geheel getal (geheel getal) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Booleaanse waarde
BooleanValue boolean

De booleaanse waarde (waar of onwaar) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks of numerieke waarde invoert.

Decimale waarde
DecimalValue double

De decimale waarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks, booleaanse waarde of een geheel getal invoert.

Objectwaarde
ObjectValue object

De objectwaarde die moet worden toegewezen aan de PowerShell-invoerparameter. Dit wordt een met JSON geserialiseerde tekenreeksvariabele in het PowerShell-script, dus deserialiseren naar een object met behulp van ConvertFrom-Json. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
PowerShell-uitvoer-JSON
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

Thread-id
ThreadId integer

Als het PowerShell-script wordt uitgevoerd als een agentthread, bevat deze uitvoer de agentthread-id die kan worden gebruikt om de uitvoering van het PowerShell-script te bewaken en de Resultaten van het PowerShell-script op te halen wanneer het script is voltooid.

Beheer van Azure AD-gebruikers instellen

Stel de manager van een Azure Active Directory-gebruiker in. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Directeur
Manager string

Als u een manager wilt toevoegen, geeft u de object-id van de gebruiker op (bijvoorbeeld UUID/GUID-waarde) of UPN (bijvoorbeeld myboss@mydomain.com). Als u de manager van de gebruiker wilt verwijderen, stelt u dit veld in op leeg.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
AzureADv2SetAzureADUserManagerResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Bestaat de Active Directory-groep?

Retourneert of een opgegeven Active Directory-groep bestaat.

Parameters

Name Sleutel Vereist Type Description
Groepsidentiteit
GroupIdentity True string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD-groep bestaat
ADGroupExists boolean

Deze uitvoer retourneert waar als de AD-groep bestaat, onwaar als de AD-groep dat niet doet.

DN van AD-groep
ADGroupDN string

Als de AD-groep bestaat, bevat deze uitvoer de DN (Distinguished Name) van de groep.

Bestaat het Microsoft Exchange-postvak?

Retourneert of het opgegeven Exchange-postvak bestaat.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op om de postvakken te filteren. Algemene eigenschapsnamen zijn: Naam, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op 'Naam van filtereigenschap' als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap alias is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de waarde van de filtereigenschap 'JohnDoe' zijn).

Details van geadresseerdetype
RecipientTypeDetails string

Het type postvak dat moet worden gezocht. Als dit veld leeg blijft, worden alle typen postvakken opgenomen in de zoekopdracht.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Postvak bestaat
MailboxExists boolean

Waar als het Exchange-postvak bestaat. Onwaar als het Exchange-postvak niet bestaat.

Bestaat het Postvak van Microsoft Exchange Online?

Retourneert of het opgegeven Postvak van Microsoft Exchange Online of Office 365 (extern) bestaat. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity string

De identiteit van het postvak van Microsoft Exchange Online of Office 365 (extern). U kunt een Microsoft Exchange Online- of Office 365-postvak (extern) opgeven op basis van de Object-id van Active Directory, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, e-mailadres, GUID of User Principal Name (UPN).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op om de postvakken te filteren. Algemene eigenschapsnamen zijn: Naam, Alias, PrimarySMTPAddress, DisplayName. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de waarde van de filtereigenschap 'JohnDoe' zijn).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Postvak bestaat
MailboxExists boolean

Is waar als het Microsoft Exchange Online-postvak bestaat. Onwaar als het Microsoft Exchange Online-postvak niet bestaat.

Booleaanse eigenschap Active Directory-gebruiker wijzigen

Wijzig een afzonderlijke booleaanse eigenschap (waar/onwaar) van een Active Directory-gebruiker. Hiermee kunt u een zeer specifieke gebruikersinstelling wijzigen, inclusief aangepaste eigenschappen.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Naam van de eigenschap
PropertyName True string

De naam van de afzonderlijke gebruikerseigenschap die moet worden gewijzigd. Algemene booleaanse eigenschappen zijn: ingeschakeld, mTSAllowLogon, msExchHideFromAddressLists.

Eigenschapswaarde
PropertyValue boolean

De waarde waar/onwaar die moet worden toegewezen aan de opgegeven eigenschap. Als u de waarde op null wilt instellen, gebruikt u in plaats daarvan de actie 'Eigenschappen van Active Directory-gebruikerstekenreeks wijzigen' met een lege eigenschapswaarde en stelt u 'Waarde vervangen' in op Ja.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryModifyADUserBooleanPropertyByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Controleren of de organisatie-eenheid van Active Directory bestaat

Rapporteert of er een Organisatie-eenheid (OE) van Active Directory bestaat.

Parameters

Name Sleutel Vereist Type Description
OE-identiteit
OUIdentity True string

Het pad naar de doel-organisatie-eenheid (OE) in DN-naamindeling (bijvoorbeeld OU=Doel-OE,OE=Londen,DC=lokaal), GUID-indeling of als pad (bijvoorbeeld Londen\Doel-OE).

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
OE-eigenschappen als JSON
PowerShellJSONOutput string

De details van de locatie van de organisatie-eenheid (OE).

OE bestaat
OUExists boolean

Ingesteld op waar als de organisatie-eenheid (OE) bestaat, onwaar als dat niet het geval is.

De eigenschappen instellen in een Microsoft Exchange Online-postvak

Stel de eigenschappen van een bestaand Microsoft Exchange Online- of Office 365-postvak (extern) in. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het postvak van Microsoft Exchange Online of Office 365 (extern). U kunt een Microsoft Exchange Online- of Office 365-postvak (extern) opgeven op basis van de Object-id van Active Directory, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, e-mailadres, GUID of User Principal Name (UPN).

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen. Laat leeg als u de huidige waarde niet wilt wijzigen.

Weergavenaam
DisplayName string

De weergavenaam van het postvak. Dit is zichtbaar in adreslijsten. Laat leeg als u de huidige waarde niet wilt wijzigen.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias (en het beleid maakt het primaire SMTP-adres van de alias) of schakelt het e-mailadresbeleid uit. Laat leeg als u de huidige waarde niet wilt wijzigen.

Postvaktype
Type string

Het type postvak. Laat leeg als u de huidige waarde niet wilt wijzigen.

Verborgen in adreslijsten
HiddenFromAddressListsEnabled boolean

Ingesteld op Waar om het postvak te verbergen voor adreslijsten, onwaar om het postvak weer te geven in adreslijsten of geef geen waarde op om de huidige instelling ongewijzigd te laten.

Aangepast kenmerk 1
CustomAttribute1 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 2
CustomAttribute2 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 3
CustomAttribute3 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 4
CustomAttribute4 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 5
CustomAttribute5 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 6
CustomAttribute6 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 7
CustomAttribute7 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 8
CustomAttribute8 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 9
CustomAttribute9 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 10
CustomAttribute10 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 11
CustomAttribute11 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 12
CustomAttribute12 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 13
CustomAttribute13 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 14
CustomAttribute14 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 15
CustomAttribute15 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeSetRemoteMailboxResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

De eigenschappen van een Microsoft Exchange Online-postvak opnieuw instellen

Stel de opgegeven eigenschappen van een bestaand Microsoft Exchange Online- of Office 365-postvak (extern) in op leeg. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het postvak van Microsoft Exchange Online of Office 365 (extern). U kunt een Microsoft Exchange Online- of Office 365-postvak (extern) opgeven op basis van de Object-id van Active Directory, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, e-mailadres, GUID of User Principal Name (UPN).

Aangepast kenmerk opnieuw instellen 1
ResetCustomAttribute1 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 2
ResetCustomAttribute2 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 3
ResetCustomAttribute3 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 4
ResetCustomAttribute4 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 5
ResetCustomAttribute5 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 6
ResetCustomAttribute6 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 7
ResetCustomAttribute7 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 8
ResetCustomAttribute8 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 9
ResetCustomAttribute9 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 10
ResetCustomAttribute10 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 11
ResetCustomAttribute11 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 12
ResetCustomAttribute12 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 13
ResetCustomAttribute13 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 14
ResetCustomAttribute14 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 15
ResetCustomAttribute15 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeResetRemoteMailboxAttributesResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

De eigenschappen van een Microsoft Exchange-postvak opnieuw instellen

Stel de opgegeven eigenschappen van een bestaand Microsoft Exchange-postvak in op leeg.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Aangepast kenmerk opnieuw instellen 1
ResetCustomAttribute1 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 2
ResetCustomAttribute2 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 3
ResetCustomAttribute3 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 4
ResetCustomAttribute4 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 5
ResetCustomAttribute5 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 6
ResetCustomAttribute6 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 7
ResetCustomAttribute7 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 8
ResetCustomAttribute8 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 9
ResetCustomAttribute9 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 10
ResetCustomAttribute10 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 11
ResetCustomAttribute11 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 12
ResetCustomAttribute12 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 13
ResetCustomAttribute13 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 14
ResetCustomAttribute14 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Aangepast kenmerk opnieuw instellen 15
ResetCustomAttribute15 boolean

Stel in op True als u het aangepaste kenmerkveld opnieuw wilt instellen (ingesteld op een lege waarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeResetMailboxAttributesResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

De eigenschappen voor een Microsoft Exchange-postvak instellen

Stel de eigenschappen van een bestaand Microsoft Exchange-postvak in.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Account uitgeschakeld
AccountDisabled boolean

Stel in op True als u het account wilt uitschakelen, onwaar als u het account wilt inschakelen of geen waarde opgeeft om de huidige instelling ongewijzigd te laten.

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen. Laat leeg als u de huidige waarde niet wilt wijzigen.

Weergavenaam
DisplayName string

De weergavenaam van het postvak. Dit is zichtbaar in adreslijsten.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias (en het beleid maakt het primaire SMTP-adres van de alias) of schakelt het e-mailadresbeleid uit. Laat leeg als u de huidige waarde niet wilt wijzigen.

Verborgen in adreslijsten
HiddenFromAddressListsEnabled boolean

Ingesteld op Waar om het postvak te verbergen voor adreslijsten, onwaar om het postvak weer te geven in adreslijsten of geef geen waarde op om de huidige instelling ongewijzigd te laten.

Aangepast kenmerk 1
CustomAttribute1 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 2
CustomAttribute2 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 3
CustomAttribute3 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 4
CustomAttribute4 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 5
CustomAttribute5 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 6
CustomAttribute6 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 7
CustomAttribute7 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 8
CustomAttribute8 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 9
CustomAttribute9 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 10
CustomAttribute10 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 11
CustomAttribute11 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 12
CustomAttribute12 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 13
CustomAttribute13 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 14
CustomAttribute14 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Aangepast kenmerk 15
CustomAttribute15 string

Een waarde voor het aangepaste kenmerkveld. Laat leeg als u geen waarde wilt opgeven. Als u de waarde wilt instellen op leeg (dat wil weten dat deze al een waarde heeft en u deze opnieuw wilt instellen), gebruikt u de actie Opnieuw instellen.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeSetMailboxResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

De eigenschappen voor een Office 365-postvak instellen

Stel de eigenschappen in een Microsoft Exchange Online- of Office 365-postvak in.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Account uitgeschakeld
AccountDisabled boolean

Stel in op True als u het account wilt uitschakelen, onwaar als u het account wilt inschakelen of geen waarde opgeeft om de huidige instelling ongewijzigd te laten.

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker.

Weergavenaam
DisplayName string

De weergavenaam van het postvak. Dit is zichtbaar in adreslijsten.

Verborgen in adreslijsten
HiddenFromAddressListsEnabled boolean

Ingesteld op Waar om het postvak te verbergen voor adreslijsten, onwaar om het postvak weer te geven in adreslijsten of geef geen waarde op om de huidige instelling ongewijzigd te laten.

Aangepast kenmerk 1
CustomAttribute1 string

Een waarde voor het veld aangepast kenmerk 1.

Aangepast kenmerk 2
CustomAttribute2 string

Een waarde voor het veld aangepast kenmerk 2.

Aangepast kenmerk 3
CustomAttribute3 string

Een waarde voor het veld aangepast kenmerk 3.

Aangepast kenmerk 4
CustomAttribute4 string

Een waarde voor het veld aangepast kenmerk 4.

Postvaktype
Type string

Het type postvak. Laat leeg als u de huidige waarde niet wilt wijzigen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365SetO365MailboxResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

De startpagina van Active Directory-gebruikers wijzigen

Hiermee stelt u de basismap/map/station in voor een Active Directory-gebruiker.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Thuisstation
HomeDrive string

Als de basismap/map zich op een netwerkshare bevindt, geeft u een stationsletter op die wordt toegewezen aan die locatie. De stationsletter is meestal één teken tussen 'F' en 'Z'. Als de basismap/map lokaal is, laat u deze waarde leeg. Als u de basismap/map instelt op leeg, laat u deze waarde ook leeg.

Basismap
HomeDirectory string

Geef het pad op voor de basismap/map. Als u ook een stationsletter voor thuisgebruik opgeeft, wordt het huisstation toegewezen aan deze map / map. Als u de basismap/map instelt op leeg, stelt u deze waarde in op leeg.

Map maken
CreateFolder boolean

Stel in op True als u de basismap/map wilt maken als deze niet bestaat.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectorySetADUserHomeFolderByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

De volgende beschikbare accountnaam ophalen

Gegeven details met betrekking tot de naamgevingsindeling voor Active Directory- en Exchange-accountnamen, geeft u de details van de volgende beschikbare reserveaccountnaam. Wordt gebruikt om te bepalen welk Active Directory- en Exchange-account moet worden gemaakt voor een bepaalde gebruiker. Met deze actie worden geen accounts gemaakt. Deze actie bevat informatie over de beschikbaarheid van namen.

Parameters

Name Sleutel Vereist Type Description
Voornaam
FirstName string

De voornaam van de gebruiker. Laat leeg als de voornaam van een gebruiker niet wordt gebruikt om accountnamen te maken (zeldzaam).

Middelste naam
MiddleName string

De middelste naam van de gebruiker (optioneel). Laat leeg als de middelste naam van een gebruiker niet wordt gebruikt om accountnamen samen te stellen.

Achternaam
LastName string

De achternaam/ familie/sur-naam van de gebruiker. Laat leeg als de achternaam van een gebruiker niet wordt gebruikt om accountnamen samen te stellen.

Veld A
FieldA string

Een extra veld dat wordt gebruikt om accountnamen samen te stellen. Laat leeg als er geen extra velden nodig zijn om een accountnaam samen te stellen.

Veld B
FieldB string

Een extra veld dat wordt gebruikt om accountnamen samen te stellen. Laat leeg als er geen extra velden nodig zijn om een accountnaam samen te stellen.

Veld C
FieldC string

Een extra veld dat wordt gebruikt om accountnamen samen te stellen. Laat leeg als er geen extra velden nodig zijn om een accountnaam samen te stellen.

Veld D
FieldD string

Een extra veld dat wordt gebruikt om accountnamen samen te stellen. Laat leeg als er geen extra velden nodig zijn om een accountnaam samen te stellen.

M-beginwaarde
VariableMStartValue integer

U kunt eventueel de initiële waarde voor de variabele {M} instellen die in de eigenschapsindeling kan worden gebruikt om een variabele weer te geven die bij elke iteratie toeneemt.

N beginwaarde
VariableNStartValue integer

U kunt desgewenst de initiële waarde voor de variabele {N} instellen die in de eigenschapsindeling kan worden gebruikt om een variabele weer te geven die bij elke iteratie toeneemt.

X-beginwaarde
VariableXStartValue integer

U kunt desgewenst de initiële waarde voor de variabele {X} instellen die in de eigenschapsindeling kan worden gebruikt om een variabele weer te geven die bij elke iteratie toeneemt.

Maximum aantal pogingen
MaxAttempts integer

Het maximum aantal pogingen (verschillende waarden proberen) voordat IA-Connect probeert een beschikbaar account te vinden.

Terugval veroorzaakt opnieuw testen
FallbackCausesRetest boolean

Als deze optie is ingesteld op waar: als een beschikbaarheidscontrole voor een regel een andere indeling vereist, worden tests opnieuw gestart vanaf de bovenkant van de lijst om ervoor te zorgen dat alle eigenschappen dezelfde indeling gebruiken (bijvoorbeeld primaire, primaire, primaire of terugval, terugval, terugval, terugval). Dit houdt de resultaten gesynchroniseerd en is de aanbevolen waarde. Alleen ingesteld op onwaar als u precies weet wat u doet.

Lijst met niet te gebruiken getallen
NumbersNotToUse string

Een door komma's gescheiden lijst met getallen die niet moeten worden gebruikt voor waarden van M, N of X. Bijvoorbeeld: '13, 666'.

Tekens die uit invoer moeten worden verwijderd
CharactersToRemoveFromInputs string

Een tekenreeks met alle tekens die u uit de invoer wilt verwijderen (bijvoorbeeld als de naam van een gebruiker ongeldige tekens bevat). Bijvoorbeeld: !@&?^*.

Diakritische tekens verwijderen uit invoer
RemoveDiacriticsFromInputs boolean

Als deze optie is ingesteld op true, probeert IA-Connect alle diakritische tekens uit de invoervelden te verwijderen, waarbij tekens worden vervangen door een diakritische teken met hetzelfde teken min de diakritische tekens. Bijvoorbeeld: 'acute accent a' vervangen door 'a'. In scenario's waarin er geen directe toewijzing aan een eenvoudig teken is, wordt het teken verwijderd. Bijvoorbeeld: De Duitse scherpe S wordt verwijderd.

Niet-alfanumeriek verwijderen uit invoer
RemoveNonAlphaNumericFromInputs boolean

Als deze optie is ingesteld op true, verwijdert IA-Connect alle niet-alfanumerieke tekens uit de invoervelden.

Reeks A1
SequenceA1 string

Een door komma's gescheiden lijst met tekenreeksen die moeten worden gebruikt voor de variabele {A1}, die kan worden gebruikt in de eigenschapsindeling om een waarde weer te geven die verandert bij elke poging om een beschikbaar account te vinden. Als u bijvoorbeeld 'A,B,C,D,E,F' opgeeft voor deze waarde, controleert de notatie {FirstName}{A1} de beschikbaarheid van {FirstName}A gevolgd door {FirstName}B, enzovoort.

Vastgoed
PropertyToCheck string

Welke accounteigenschap moet worden gecontroleerd op beschikbaarheid

Formaat
PropertyNameFormat string

De notatie voor de waarde van deze eigenschap. Bijvoorbeeld: {FirstName}. {LastName} of {FirstName first 1}. {LastName}

Terugval opmaken
PropertyNameFallbackFormat string

De terugvalnotatie voor de waarde van deze eigenschap als de waarde al wordt gebruikt. Bijvoorbeeld: {FirstName}. {LastName}{NN} of {FirstName first 1}. {LastName}{NN}

Tweede terugval opmaken
PropertyNameFallbackFormat2 string

De tweede terugvalnotatie voor de waarde van deze eigenschap als de waarde en de eerste terugval al worden uitgevoerd. Bijvoorbeeld: {FirstName}. {LastName}{NN} of {FirstName first 1}. {LastName}{NN}

Maximale lengte van waarde
PropertyNameMaxLength integer

De maximale lengte voor de waarde van dit veld voordat er iets moet worden geknipt

Veld dat moet worden gesneden als maximale lengte
PropertyNameMaxLengthFieldToCut string

Als de maximumlengte voor de waarde van dit veld wordt overschreden, welke invoer moet worden geknipt. Kies bijvoorbeeld LastName als u wilt knippen van de achternaam/familienaam/achternaam om de waarde van de eigenschap te verkorten.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD User SAMAccountName
ActiveDirectorySAMAccountName string

De beschikbare SAMAccountName van Active Directory-gebruiker (als het een van de eigenschappen was om te controleren op beschikbaarheid).

AD-gebruikersaccountnaam
ActiveDirectoryAccountName string

De beschikbare Active Directory-gebruikersnaam (als dit een van de eigenschappen was om te controleren op beschikbaarheid).

Principal-naam van AD-gebruiker
ActiveDirectoryUPN string

De beschikbare Active Directory User Principal Name (als het een van de eigenschappen was om te controleren op beschikbaarheid).

E-mailadres van AD-gebruiker
ActiveDirectoryEmailAddress string

Het beschikbare Active Directory-e-mailadres (als het een van de eigenschappen was om te controleren op beschikbaarheid).

E-mailadres van Exchange-postvak
ExchangeMailboxAddress string

Het beschikbare e-mailadres van het Exchange-e-mailpostvak (als dit een van de eigenschappen was om te controleren op beschikbaarheid).

Exchange-postvakalias
ExchangeMailboxAlias string

De beschikbare Exchange-postvakalias (als dit een van de eigenschappen was om te controleren op beschikbaarheid).

Adres van extern postvak in Exchange
ExchangeRemoteMailboxAddress string

Het beschikbare externe Exchange-postvakadres (als dit een van de eigenschappen was om te controleren op beschikbaarheid).

Principal-naam van Azure AD-gebruiker
AzureADUPN string

De beschikbare Azure Active Directory User Principal Name (als dit een van de eigenschappen was om te controleren op beschikbaarheid).

Office 365 User Principal Name
Office365UPN string

De beschikbare Office 365 User Principal Name (als het een van de eigenschappen was om te controleren op beschikbaarheid).

E-mailadres van Office 365-postvak
Office365MailboxEmailAddress string

Het beschikbare e-mailpostvakadres van Office 365 (als dit een van de eigenschappen was om te controleren op beschikbaarheid).

M-eindwaarde
MValue integer

De uiteindelijke waarde van de variabele M, als deze is gebruikt.

N eindwaarde
NValue integer

De uiteindelijke waarde van de variabele N, als deze is gebruikt.

X-eindwaarde
XValue integer

De uiteindelijke waarde van de variabele X, als deze is gebruikt.

Gebruikte index opmaken
FormatIndexUsed integer

De index van de indeling die is gebruikt om eigenschappen te vinden. 1 = Primaire indeling, 2 = Fallback-indeling, 3 = Tweede terugvalnotatie. Dit laat u weten of uw oorspronkelijke indeling heeft geresulteerd in een beschikbaar account of dat IA-Connect moest terugvallen op een andere opgegeven indeling.

Details van Microsoft Exchange-distributiegroep ophalen

Haal de details van een Microsoft Exchange-distributiegroep op. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity string

De identiteit van de distributiegroep die moet worden gezocht. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op waarop u de distributiegroepen wilt filteren. Algemene eigenschapsnamen zijn: DisplayName, Name, GroupType, PrimarySMTPAddress. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de waarde van de filtereigenschap 'JohnDoe' zijn).

Is geen resultaat een uitzondering
NoResultIsAnException boolean

Stel in op True om een uitzondering te genereren als er geen distributiegroepen worden gevonden. Ingesteld op onwaar om een telling van 0 te melden als er geen distributiegroepen worden gevonden. Houd er rekening mee dat de optie 'onwaar' mogelijk niet werkt wanneer deze wordt gebruikt met identiteit in niet-Engelse talen, dus overweeg in plaats daarvan te zoeken met behulp van filters.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met Microsoft Exchange-distributiegroepen die overeenkomen met de zoekidentiteit of het filter, in JSON-indeling.

Aantal gevonden distributiegroepen
CountOfDistributionGroupsFound integer

Het aantal Microsoft Exchange-distributiegroepen dat overeenkomt met de zoekidentiteit of het filter. Meestal 1.

Details van Microsoft Exchange Online-postvak ophalen

Retourneert de eigenschappen van het opgegeven Microsoft Exchange Online- of Office 365-postvak (extern). De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity string

De identiteit van het postvak van Microsoft Exchange Online of Office 365 (extern). U kunt een Microsoft Exchange Online- of Office 365-postvak (extern) opgeven op basis van de Object-id van Active Directory, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, e-mailadres, GUID of User Principal Name (UPN).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op om de postvakken te filteren. Algemene eigenschapsnamen zijn: Naam, Alias, PrimarySMTPAddress, DisplayName. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de waarde van de filtereigenschap 'JohnDoe' zijn).

Is geen resultaat een uitzondering
NoResultIsAnException boolean

Stel in op True om een uitzondering te genereren als er geen postvakken worden gevonden. Ingesteld op Onwaar om een telling van 0 te rapporteren als er geen postvakken worden gevonden. Houd er rekening mee dat de optie 'onwaar' mogelijk niet werkt wanneer deze wordt gebruikt met identiteit in niet-Engelse talen, dus overweeg in plaats daarvan te zoeken met behulp van filters.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met Microsoft Exchange Online- of Office 365-postvakken (en de aangevraagde eigenschappen) die overeenkomen met de zoekidentiteit, in JSON-indeling.

Aantal gevonden postvakken
CountOfMailboxesFound integer

Het aantal Microsoft Exchange Online- of Office 365-postvakken dat overeenkomt met de zoekidentiteit of het filter. Meestal 1.

Details van Microsoft Exchange-postvak ophalen

Retourneert de eigenschappen van het opgegeven Exchange-postvak. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op om de postvakken te filteren. Algemene eigenschapsnamen zijn: Naam, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de waarde van de filtereigenschap 'JohnDoe' zijn).

Details van geadresseerdetype
RecipientTypeDetails string

Het type postvak dat moet worden gezocht. Als dit veld leeg blijft, worden alle typen postvakken opgenomen in de zoekopdracht.

Is geen resultaat een uitzondering
NoResultIsAnException boolean

Stel in op True om een uitzondering te genereren als er geen postvakken worden gevonden. Ingesteld op Onwaar om een telling van 0 te rapporteren als er geen postvakken worden gevonden. Houd er rekening mee dat de optie 'onwaar' mogelijk niet werkt wanneer deze wordt gebruikt met identiteit in niet-Engelse talen, dus overweeg in plaats daarvan te zoeken met behulp van filters.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met Exchange-postvakken (en de aangevraagde eigenschappen) die overeenkomen met de zoekidentiteit, in JSON-indeling.

Aantal gevonden postvakken
CountOfMailboxesFound integer

Het aantal Exchange-postvakken dat overeenkomt met de zoekidentiteit of het filter. 1 resultaat wordt verwacht als wordt gezocht op identiteit. Er worden 0 of meer resultaten verwacht als u zoekt op filter.

E-mailadressen van een Microsoft Exchange Online-postvak ophalen

Hiermee haalt u een lijst op met alle e-mailadressen die zijn toegewezen aan een bestaand Microsoft Exchange Online- of Office 365-postvak (extern). Dit omvat het primaire SMTP-adres, proxy-e-mailadressen, X.400-adressen en EUM-adressen (Exchange Unified Messaging). De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het postvak van Microsoft Exchange Online of Office 365 (extern). U kunt een Microsoft Exchange Online- of Office 365-postvak (extern) opgeven op basis van de Object-id van Active Directory, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, e-mailadres, GUID of User Principal Name (UPN).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
E-mailadressen van postvak
MailboxEmailAddresses array of string

Het e-mailadres van het postvak. Het primaire SMTP-e-mailadres wordt weergegeven als SMTP:emailaddress, secundaire (proxy) SMTP-e-mailadressen worden weergegeven als smtp:emailaddress, X.400 e-mailadressen worden weergegeven als x400:address en Exchange Unified Messaging -adressen (EUM) als eum:address.

E-mailadressen van een Microsoft Exchange Online-postvak wijzigen

Wijzig de e-mailadressen in een bestaand Microsoft Exchange Online- of Office 365-postvak (extern). U kunt primaire en alias-e-mailadressen toevoegen, verwijderen en vervangen. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het postvak van Microsoft Exchange Online of Office 365 (extern). U kunt een Microsoft Exchange Online- of Office 365-postvak (extern) opgeven op basis van de Object-id van Active Directory, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, e-mailadres, GUID of User Principal Name (UPN).

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen. Laat leeg als u de huidige waarde niet wilt wijzigen.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias (en het beleid maakt het primaire SMTP-adres van de alias) of schakelt het e-mailadresbeleid uit. Laat leeg als u de huidige waarde niet wilt wijzigen.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

E-mailadressen die moeten worden toegevoegd
EmailAddressesToAddList array of string

Een lijst met extra (niet-primaire) e-mailadressen die aan het postvak moeten worden toegewezen.

E-mailadressen vervangen
ReplaceEmailAddresses boolean

Stel in op True als u wilt dat de opgegeven lijst met e-mailadressen alle bestaande e-mailadressen vervangt (niet inclusief het primaire SMTP-adres). Ingesteld op onwaar als u wilt dat de opgegeven lijst met e-mailadressen wordt toegevoegd aan bestaande adressen.

E-mailadressen die moeten worden verwijderd
EmailAddressesToRemoveList array of string

Een lijst met extra (niet-primaire) e-mailadressen die uit het postvak moeten worden verwijderd (als ze aanwezig zijn). Dit heeft alleen een doel als 'E-mailadressen vervangen' is ingesteld op onwaar of als u geen e-mailadressen toevoegt.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
E-mailadressen van postvak
MailboxEmailAddresses array of string

De e-mailadressen van het postvak nadat de wijzigingsactie is uitgevoerd. Het primaire SMTP-e-mailadres wordt weergegeven als SMTP:emailaddress, secundaire (proxy) SMTP-e-mailadressen worden weergegeven als smtp:emailaddress, X.400 e-mailadressen worden weergegeven als x400:address en Exchange Unified Messaging -adressen (EUM) als eum:address.

E-mailadressen van een Microsoft Exchange-postvak ophalen

Hiermee wordt een lijst opgehaald met alle e-mailadressen die zijn toegewezen aan een Microsoft Exchange-postvak. Dit omvat het primaire SMTP-adres, proxy-e-mailadressen, X.400-adressen en EUM-adressen (Exchange Unified Messaging).

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
E-mailadressen van postvak
MailboxEmailAddresses array of string

Het e-mailadres van het postvak. Het primaire SMTP-e-mailadres wordt weergegeven als SMTP:emailaddress, secundaire (proxy) SMTP-e-mailadressen worden weergegeven als smtp:emailaddress, X.400 e-mailadressen worden weergegeven als x400:address en Exchange Unified Messaging -adressen (EUM) als eum:address.

E-mailadressen van een Microsoft Exchange-postvak wijzigen

Wijzig de e-mailadressen in een Microsoft Exchange-postvak. U kunt primaire en alias-e-mailadressen toevoegen, verwijderen en vervangen.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen. Laat leeg als u de huidige waarde niet wilt wijzigen.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias (en het beleid maakt het primaire SMTP-adres van de alias) of schakelt het e-mailadresbeleid uit. Laat leeg als u de huidige waarde niet wilt wijzigen.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

E-mailadressen die moeten worden toegevoegd
EmailAddressesToAddList array of string

Een lijst met extra (niet-primaire) e-mailadressen die aan het postvak moeten worden toegewezen.

E-mailadressen vervangen
ReplaceEmailAddresses boolean

Stel in op True als u wilt dat de opgegeven lijst met e-mailadressen alle bestaande e-mailadressen vervangt (niet inclusief het primaire SMTP-adres). Ingesteld op onwaar als u wilt dat de opgegeven lijst met e-mailadressen wordt toegevoegd aan bestaande adressen.

E-mailadressen die moeten worden verwijderd
EmailAddressesToRemoveList array of string

Een lijst met extra (niet-primaire) e-mailadressen die uit het postvak moeten worden verwijderd (als ze aanwezig zijn). Dit heeft alleen een doel als 'E-mailadressen vervangen' is ingesteld op onwaar of als u geen e-mailadressen toevoegt.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
E-mailadressen van postvak
MailboxEmailAddresses array of string

De e-mailadressen van het postvak nadat de wijzigingsactie is uitgevoerd. Het primaire SMTP-e-mailadres wordt weergegeven als SMTP:emailaddress, secundaire (proxy) SMTP-e-mailadressen worden weergegeven als smtp:emailaddress, X.400 e-mailadressen worden weergegeven als x400:address en Exchange Unified Messaging -adressen (EUM) als eum:address.

Een gedeeld Office 365-postvak en gebruikersaccount maken

Maak een gedeeld postvak in Microsoft Exchange Online en een gebruikersaccount in Azure Active Directory/Entra-id. Gebruik deze actie alleen als de gebruiker nog niet bestaat in Azure Active Directory/Entra-id. Het SMTP-adres van het gedeelde postvak is gebaseerd op de naam, alias of het primaire SMTP-adres (afhankelijk van de invoer).

Parameters

Name Sleutel Vereist Type Description
Naam
Name True string

De unieke naam van het postvak. Dit is een interne waarde die niet extern zichtbaar is (tenzij u geen alias of primair SMTP-adres instelt, in dat geval wordt deze gebruikt als het naamonderdeel van het SMTP-e-mailadres van het postvak). U wordt aangeraden deze in te stellen op dezelfde waarde als de alias, tenzij u een alternatieve procedure hebt of een goede reden hebt om een andere waarde te gebruiken.

Voornaam
FirstName string

De voornaam van de postvakgebruiker.

Achternaam
LastName string

De achternaam/achternaam van de postvakgebruiker.

Initialen
Initials string

De middelste initialen van de postvakgebruiker.

Weergavenaam
DisplayName string

De weergavenaam van het optionele postvak.

Alias
Alias string

De postvakalias (ook wel e-mailnaam genoemd) voor de gebruiker. Deze waarde wordt gebruikt om het naamonderdeel van het SMTP-e-mailadres van het postvak te genereren (bijvoorbeeld een alias van alias zou resulteren in alias@mydomain.com). Als dit verschilt van het primaire SMTP-adres, leidt dit ertoe dat het postvak meerdere SMTP-adressen heeft. Als deze waarde niet is opgegeven, worden er geen postvakaliassen ingesteld en heeft het postvak alleen een primair SMTP-adres.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire SMTP-e-mailadres dat wordt gebruikt voor de geadresseerde. Als dit verschilt van de postvakalias, resulteert dit in het postvak met meerdere SMTP-adressen. Als deze waarde niet wordt opgegeven, wordt het primaire SMTP-adres automatisch berekend op basis van de alias of naam en het organisatiebeleid (dat doorgaans wordt gebaseerd op het standaarddomein dat is ingesteld in het Office 365-beheercentrum).

Archiefpostvak maken
Archive boolean

Stel deze optie in op Waar als u ook een archiefpostvak wilt maken in Microsoft Exchange Online of Office 365.

Postvakregio
MailboxRegion string

De optionele geografische regio waarin het postvak moet worden gemaakt, in een omgeving met meerdere geografische gebieden.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de nieuwe postvakactie, in JSON-indeling.

Nieuwe gebruikers-id voor Microsoft Online-services
NewUserMicrosoftOnlineServicesID string

De Microsoft Online-services-id van het zojuist gemaakte postvakgebruikersaccount. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties.

Nieuwe postvak-GUID
NewMailboxGUID string

De GUID van het zojuist gemaakte postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties.

Nieuw primaire SMTP-adres voor postvak
NewMailboxPrimarySmtpAddress string

Het primaire SMTP-adres van het zojuist gemaakte postvak.

Een Microsoft Exchange Online-postvak maken voor een gebruiker

Hiermee maakt u een Microsoft Exchange Online- of Office 365-postvak (extern) of archiefpostvak voor een bestaande gebruiker in on-premises Active Directory die nog geen postvak heeft. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie. U kunt deze actie ook gebruiken om een bestaand extern postvak te archiveren.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van de bestaande gebruiker waarvoor u een postvak wilt maken. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen.

Weergavenaam
DisplayName string

De weergavenaam van het postvak. Dit is zichtbaar in adreslijsten.

Adres voor externe routering
RemoteRoutingAddress string

Het SMTP-adres van het postvak in Microsoft Exchange Online of Office 365 waaraan deze gebruiker is gekoppeld.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias of schakel het e-mailadresbeleid uit.

Archiefpostvak maken
Archive boolean

Stel deze optie in op Waar als u ook een archiefpostvak wilt maken in Microsoft Exchange Online of Office 365.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie Extern postvak inschakelen, in JSON-indeling.

Nieuw postvak-DN
NewMailboxDN string

De DN (Distinguished Name) van het zojuist gemaakte (ingeschakelde) postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Nieuwe postvak-GUID
NewMailboxGUID string

De GUID van het zojuist gemaakte (ingeschakelde) postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Een Microsoft Exchange-postvak voor een gebruiker maken

Hiermee maakt u een Microsoft Exchange-postvak voor een bestaande gebruiker die nog geen postvak heeft.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van de bestaande gebruiker waarvoor u een postvak wilt maken. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen.

Weergavenaam
DisplayName string

De weergavenaam van het postvak. Dit is zichtbaar in adreslijsten.

Gekoppelde domeincontroller
LinkedDomainController string

Als u een gekoppeld postvak maakt, kunt u hiermee de domeincontroller opgeven in het forest waarin het gebruikersaccount zich bevindt. Gebruik de FQDN (Fully Qualified Domain Name) van de domeincontroller.

Gekoppeld hoofdaccount
LinkedMasterAccount string

Als u een gekoppeld postvak maakt, kunt u hiermee het account opgeven waaraan het postvak is gekoppeld. U kunt het account opgeven op DN-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), GUID of Naam (bijvoorbeeld 'Gebruiker1').

gegevensbank
Database string

De Exchange-database die de nieuwe database bevat. U kunt de database opgeven op basis van DN-naam, GUID of Naam.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias (en het beleid maakt het primaire SMTP-adres van de alias) of schakelt het e-mailadresbeleid uit.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie Postvak inschakelen, in JSON-indeling.

Nieuw postvak-DN
NewMailboxDN string

De DN (Distinguished Name) van het zojuist gemaakte (ingeschakelde) postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Nieuwe postvak-GUID
NewMailboxGUID string

De GUID van het zojuist gemaakte (ingeschakelde) postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Een nieuwe Azure AD-beveiligingsgroep maken

Hiermee maakt u een nieuwe Azure Active Directory-beveiligingsgroep. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Weergavenaam
DisplayName True string

De weergavenaam van de groep.

Description
Description string

De groepsbeschrijving.

Controleer of de groep bestaat
CheckGroupExists boolean

Als deze optie is ingesteld op waar, controleert IA-Connect of de groep bestaat en, als deze bestaat, IA-Connect gewoon succes voor die groep rapporteren zonder dat u iets hoeft te doen. Als deze optie is ingesteld op onwaar, maakt IA-Connect de groep zonder controle, wat kan leiden tot een dubbele groepsnaam.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie distributiegroep maken, in JSON-indeling. Dit bevat doorgaans de details van de gemaakte groep.

Groep bestaat al
GroupAlreadyExists boolean

Als de groep al bestaat, wordt deze ingesteld op true om u te laten weten dat de groep bestaat en daarom IA-Connect geen acties hoeft uit te voeren.

Groepsobject-id gemaakt
CreatedGroupObjectId string

De object-id van de gemaakte groep (of de bestaande groep).

Een nieuwe Azure AD Microsoft 365-groep maken

Hiermee maakt u een nieuwe Azure Active Directory Microsoft 365-groep. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Weergavenaam
DisplayName True string

De weergavenaam van de groep.

Description
Description string

De groepsbeschrijving.

Bijnaam van e-mail
MailNickname string

De e-mailnaam, die wordt gebruikt om het groeps-e-mailadres te vormen.

Zichtbaarheid van groepen
GroupVisibility string

Als deze optie is ingesteld op openbaar (de standaardinstelling), kan iedereen de inhoud van de groep bekijken en iedereen kan deelnemen aan de groep. Als deze optie is ingesteld op privé, kunnen alleen leden de inhoud van de groep bekijken en kunnen alleen eigenaren nieuwe leden toevoegen aan de groep of deelnameaanvragen goedkeuren.

Controleer of de groep bestaat
CheckGroupExists boolean

Als deze optie is ingesteld op waar, controleert IA-Connect of de groep bestaat en, als deze bestaat, IA-Connect gewoon succes voor die groep rapporteren zonder dat u iets hoeft te doen. Als deze optie is ingesteld op onwaar, maakt IA-Connect de groep zonder controle, wat kan leiden tot een dubbele groepsnaam.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie distributiegroep maken, in JSON-indeling. Dit bevat doorgaans de details van de gemaakte groep.

Groep bestaat al
GroupAlreadyExists boolean

Als de groep al bestaat, wordt deze ingesteld op true om u te laten weten dat de groep bestaat en daarom IA-Connect geen acties hoeft uit te voeren.

Groepsobject-id gemaakt
CreatedGroupObjectId string

De object-id van de gemaakte groep (of de bestaande groep).

Een nieuwe Microsoft Exchange-distributiegroep maken

Hiermee maakt u een nieuwe Microsoft Exchange-distributiegroep of beveiligingsgroep met e-mail.

Parameters

Name Sleutel Vereist Type Description
Groepsnaam
Name True string

De unieke naam voor de nieuwe groep.

Alias
Alias string

De alias (ook wel e-mailnaam genoemd) voor de nieuwe groep. Als u geen SMTP-adres opgeeft, wordt de alias gebruikt om het naamonderdeel van het e-mailadres te genereren (bijvoorbeeld alias@mydomain.com).

Weergavenaam
DisplayName string

De weergavenaam van de groep. Dit is zichtbaar in adreslijsten.

Opmerkingen
Notes string

Optionele opmerkingen over het object.

Beheerd door
ManagedBy string

De eigenaar van de groep. Als u geen eigenaar opgeeft, wordt de gebruiker die de groep heeft gemaakt de eigenaar. De eigenaar kan een postvak, e-mailgebruiker of beveiligingsgroep met e-mail zijn. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Members
Members string

Een door komma's gescheiden lijst met leden die aan de nieuwe groep moeten worden toegevoegd. U kunt leden opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=Mijn groepen,DC=mydomain,DC=lokaal), e-mailadres of GUID.

Organisatie-eenheid
OrganizationalUnit string

De organisatie-eenheid (OE) in Active Directory waarin de groep moet worden opgeslagen. U kunt een OE opgeven in DN-naamindeling (bijvoorbeeld OU=Doel-OE,OU=Londen,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld MyGroups\Londen). Als dit leeg blijft, wordt de groep gemaakt in de organisatie-eenheid Gebruikers.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de nieuwe groep.

Beperking voor vertrek van lid
MemberDepartRestriction string

Hiermee kunt u beperkingen opgeven voor een lid dat een distributiegroep verlaat. 'Openen' is de standaardinstelling en stelt leden in staat om de groep zonder goedkeuring te verlaten. Met Gesloten kunnen leden de groep niet verlaten. Deze optie wordt genegeerd voor beveiligingsgroepen, omdat gebruikers zichzelf niet uit beveiligingsgroepen kunnen verwijderen.

Beperking voor liddeelname
MemberJoinRestriction string

Hiermee kunt u beperkingen opgeven voor leden die lid worden van een distributiegroep nadat deze is gemaakt. Met 'Openen' kunnen leden zonder goedkeuring deelnemen aan de groep, 'Gesloten' (de standaardinstelling) beperken dat leden lid worden van de groep. 'ApprovalRequired' staat een lid toe om lid te worden van de groep en ze worden toegevoegd als een groepseigenaar de aanvraag accepteert. Deze optie wordt genegeerd voor beveiligingsgroepen, omdat gebruikers zichzelf niet kunnen toevoegen aan beveiligingsgroepen.

Verificatie van afzender vereisen
RequireSenderAuthenticationEnabled boolean

Ingesteld op waar om op te geven dat de groep alleen berichten van geverifieerde (interne) afzenders accepteert. Ingesteld op Onwaar om berichten van alle afzenders te accepteren.

Groepstype
Type string

Geef het type groep op dat moet worden gemaakt. 'Distributie' is de standaardinstelling en maakt een distributiegroep. 'Beveiliging' wordt gebruikt om een beveiligingsgroep met e-mail te maken.

Uitzondering als de groep al bestaat
ErrorIfGroupAlreadyExists boolean

Moet er een uitzondering optreden als de groep al bestaat? Ingesteld op onwaar om niets te doen als de groep al bestaat (bijvoorbeeld als deze al is gemaakt). Ingesteld op waar als de groep al bestaat een fout is (dat wil bijvoorbeeld niet verwachten dat deze bestaat).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie distributiegroep maken, in JSON-indeling. Dit bevat doorgaans de details van de gemaakte groep.

Groep bestaat al
GroupAlreadyExists boolean

Als de groep al bestaat (en 'Uitzondering als de groep al bestaat' is ingesteld op onwaar), wordt deze ingesteld op waar om u te laten weten dat de groep niet daadwerkelijk is gemaakt omdat deze al bestaat.

Nieuwe groep-DN
NewGroupDN string

De DN (Distinguished Name) van de zojuist gemaakte groep. Dit is een unieke id voor de groep die kan worden gebruikt in verdere acties voor deze groep.

Nieuwe groeps-GUID
NewGroupGUID string

De GUID van de zojuist gemaakte (ingeschakelde) groep. Dit is een unieke id voor de groep die kan worden gebruikt in verdere acties voor deze groep.

Een nieuwe Office 365-distributiegroep maken

Hiermee maakt u een nieuwe Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Parameters

Name Sleutel Vereist Type Description
Groepsnaam
Name True string

De unieke naam voor de nieuwe groep.

Alias
Alias string

De alias (ook wel e-mailnaam genoemd) voor de nieuwe groep. Als u geen SMTP-adres opgeeft, wordt de alias gebruikt om het naamonderdeel van het e-mailadres te genereren (bijvoorbeeld alias@mydomain.com).

Weergavenaam
DisplayName string

De weergavenaam van de groep. Dit is zichtbaar in adreslijsten.

Opmerkingen
Notes string

Optionele opmerkingen over het object.

Beheerd door
ManagedBy string

De eigenaar van de groep. Als u geen eigenaar opgeeft, wordt de gebruiker die de groep heeft gemaakt de eigenaar. De eigenaar kan een postvak, e-mailgebruiker of beveiligingsgroep met e-mail zijn. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Members
Members string

Een door komma's gescheiden lijst met leden die aan de nieuwe groep moeten worden toegevoegd. U kunt leden opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=Mijn groepen,DC=mydomain,DC=lokaal), e-mailadres of GUID.

Organisatie-eenheid
OrganizationalUnit string

De organisatie-eenheid (OE) in Azure Active Directory waarin de groep moet worden opgeslagen. U kunt een OE opgeven in DN-naamindeling (bijvoorbeeld OU=Doel-OE,OU=Londen,DC=mydomain,DC=local) of GUID-indeling.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de nieuwe groep.

Beperking voor vertrek van lid
MemberDepartRestriction string

Hiermee kunt u beperkingen opgeven voor een lid dat de groep verlaat. 'Openen' is de standaardinstelling en stelt leden in staat om de groep zonder goedkeuring te verlaten. Met Gesloten kunnen leden de groep niet verlaten.

Beperking voor liddeelname
MemberJoinRestriction string

Hiermee kunt u beperkingen opgeven voor een lid dat lid wordt van de groep nadat deze is gemaakt. Met 'Openen' kunnen leden zonder goedkeuring deelnemen aan de groep, 'Gesloten' (de standaardinstelling) beperken dat leden lid worden van de groep. 'ApprovalRequired' staat een lid toe om lid te worden van de groep en ze worden toegevoegd als een groepseigenaar de aanvraag accepteert.

Verificatie van afzender vereisen
RequireSenderAuthenticationEnabled boolean

Ingesteld op waar om op te geven dat de groep alleen berichten van geverifieerde (interne) afzenders accepteert. Ingesteld op Onwaar om berichten van alle afzenders te accepteren.

Groepstype
Type string

Geef het type groep op dat moet worden gemaakt. 'Distributie' is de standaardinstelling en maakt een distributiegroep. 'Beveiliging' wordt gebruikt om een beveiligingsgroep met e-mail te maken.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie distributiegroep maken, in JSON-indeling. Dit bevat doorgaans de details van de gemaakte groep.

Groep bestaat al
GroupAlreadyExists boolean

Als de groep al bestaat, wordt deze ingesteld op true om u te laten weten dat de groep niet daadwerkelijk is gemaakt.

DN van groep gemaakt
CreatedGroupDN string

De DN (Distinguished Name) van de gemaakte groep (of de bestaande groep).

Groeps-GUID gemaakt
CreatedGroupGUID string

De GUID van de gemaakte groep (of de bestaande groep).

Groepsidentiteit gemaakt
CreatedGroupIdentity string

De identiteit van de gemaakte groep (of de bestaande groep).

Eigenschappen van Active Directory-gebruikerstekenreeksen wijzigen

Wijzig de afzonderlijke tekenreekseigenschap(en) van een Active Directory-gebruiker. Hiermee kunt u zeer specifieke gebruikersinstellingen wijzigen, inclusief aangepaste eigenschappen. U kunt ook afzonderlijke gebruikerseigenschappen instellen op leeg.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Vastgoed
Property string
Waarde
Value string
AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Waarde vervangen
ReplaceValue boolean

Ingesteld op waar om de waarden te vervangen. Ingesteld op onwaar om de waarde toe te voegen. Toevoegen werkt niet als de waarde al bestaat (dit heeft alleen gevolgen voor aangepaste eigenschappen), terwijl vervangen kan worden gebruikt om een nieuwe waarde te maken of een bestaande waarde te vervangen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryModifyADUserStringPropertyByIdentityResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Exchange instellen om het hele Active Directory-forest weer te geven

Geef op of het hele Active Directory-forest (inclusief subdomeinen) wordt doorzocht/bekeken bij het uitvoeren van Exchange-acties. Mogelijk moet u deze actie gebruiken als u meerdere gekoppelde domeinen hebt.

Parameters

Name Sleutel Vereist Type Description
Hele forest weergeven
ViewEntireForest True boolean

Stel in op true als u het hele Active Directory-forest wilt doorzoeken, onwaar als u alleen het huidige Active Directory-domein wilt doorzoeken.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeSetADServerToViewEntireForestResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Exchange-postvak verzenden instellen namens

Geef op wie namens dit bestaande postvak mag worden verzonden.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Verzenden namens
GrantSendOnBehalfTo True string

De identificatie van een gebruiker, groep of postvak die e-mailberichten namens dit postvak kan verzenden. U kunt een gebruiker opgeven op Naam, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName of User Principal Name (UPN).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeSetMailboxSendOnBehalfOfPermissionResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Exchange PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Exchange-runspace in de sessie waarop de IA-Connect Agent wordt uitgevoerd, waarbij de inhoud van het script wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Exchange PowerShell-code. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread.

Parameters

Name Sleutel Vereist Type Description
Inhoud van PowerShell-script
PowerShellScriptContents string

De inhoud van het PowerShell-script dat moet worden uitgevoerd in de Exchange-runspace. IA-Connect voert dit script as-is uit door rechtstreeks door te geven aan de PowerShell-automatiseringsengine. Er wordt geen PowerShell-script op schijf gemaakt. U kunt ook een bestaand PowerShell-script op schijf uitvoeren door het volgende in te voeren: return & 'scriptpath'. Bijvoorbeeld: return &c:\scripts\ExchangeTestScript.ps1'.

Treedt er geen fout op
IsNoResultAnError boolean

Als er geen gegevens worden geretourneerd door de PowerShell-opdracht, wordt er dan een fout voorgesteld?

Complexe typen retourneren
ReturnComplexTypes boolean

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met de invoer 'Eigenschappen die als verzameling moeten worden geretourneerd', 'Eigenschapsnamen om te serialiseren' en 'Eigenschapstypen die moeten worden geserialiseerd' kunt u opgeven welke 'complexe' eigenschappen moeten worden geretourneerd en de methode die wordt gebruikt om de gegevens op te maken (kies op basis van eigenschap per eigenschap het beste). Met deze invoer kunt u opgeven wat er moet worden gedaan met eventuele resterende eigenschappen (dat wil bijvoorbeeld eigenschappen die 'complex' zijn en niet expliciet worden genoemd). Als deze optie is ingesteld op true, probeert IA-Connect een tekenreeksweergave van de gegevens te retourneren met behulp van ToString(). Als deze optie is ingesteld op false (de standaardinstelling), retourneert IA-Connect de eigenschap niet.

Booleaanse waarde retourneren als booleaanse waarde
ReturnBooleanAsBoolean boolean

Moeten Booleaanse eigenschappen worden geretourneerd als booleaanse waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Numeriek als decimaal retourneren
ReturnNumericAsDecimal boolean

Moeten numerieke eigenschappen worden geretourneerd als numerieke waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Retourdatum als datum
ReturnDateAsDate boolean

Moeten datumeigenschappen worden geretourneerd als datums? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Eigenschappen die moeten worden geretourneerd als verzameling
PropertiesToReturnAsCollectionJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect moet proberen terug te keren als een verzameling. Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschapsnamen te serialiseren' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Deze invoer kan worden ingevoerd in JSON- of CSV-indeling. Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf-matrix wilt retourneren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Script uitvoeren als thread
RunScriptAsThread boolean

Als deze optie is ingesteld op onwaar (de standaardinstelling), wordt het PowerShell-script direct uitgevoerd door de IA-Connect Agent en worden de resultaten geretourneerd naar de directeur wanneer het script is voltooid. Als u een lang of complex PowerShell-script uitvoert, kan er een time-out optreden voor deze actie. Als dit is ingesteld op true, voert de IA-Connect Agent het PowerShell-script uit als agentthread en kan de IA-Connect Director (of Orchestrator, PowerShell-module, Blue Prism) de status van deze agentthread controleren, waarna deze is voltooid. Hierdoor kunnen lange of complexe PowerShell-scripts zonder time-outs worden uitgevoerd. IA-Connect Agents 9.3 en eerder kunnen PowerShell-scripts niet als agentthread worden uitgevoerd.

Uitvoergegevens ophalen voor thread-id
RetrieveOutputDataFromThreadId integer

Als u eerder een PowerShell-script als agentthread hebt uitgevoerd en 'Seconden om te wachten op thread' hebt ingesteld op 0, geeft u de agentthread-id op om de resultaten op te halen. Deze agentthread-id is verstrekt door de eerdere aanroep van deze actie. Ingesteld op 0 (de standaardinstelling) als u gewoon een PowerShell-script uitvoert (en daarom de resultaten van een vorige PowerShell-scriptuitvoering als agentthread niet ophalen).

Seconden om te wachten op thread
SecondsToWaitForThread integer

Als 'Script uitvoeren als thread' is ingesteld op waar, hoeveel seconden er moet worden gewacht totdat de agentthread is voltooid. Als de agentthread met het PowerShell-script op dit moment niet is voltooid, wordt er een uitzondering gegenereerd. Ingesteld op 0 om de wachttijd te omzeilen: de agent blijft het PowerShell-script uitvoeren, maar is ook beschikbaar voor de volgende actie. Vervolgens kunt u de scriptresultaten op een later tijdstip ophalen met behulp van de actie 'Wachten tot agentthread is voltooid' om te wachten totdat de agentthread is voltooid en voer vervolgens deze actie PowerShell-script uitvoeren opnieuw uit met de invoer Uitvoergegevens ophalen voor thread-id ingesteld op de agentthread-id.

Script bevat opgeslagen wachtwoord
ScriptContainsStoredPassword boolean

Ingesteld op true als het script een IA-Connect opgeslagen wachtwoord-id bevat, in de indeling {IAConnectPassword:StoredPasswordIdentifier} of een IA-Connect Orchestrator generic credential, in de indeling {OrchestratorCredential:FriendlyName}. De woordgroep { } wordt vervangen door het opgegeven wachtwoord, ontsnapt en tussen enkele aanhalingstekens geplaatst (tenzij deze al tussen aanhalingstekens in het script staat).

Uitgebreide uitvoer van logboek
LogVerboseOutput boolean

Ingesteld op waar om uitgebreide PowerShell-uitvoer in de IA-Connect-logboeken te registreren. Dit kan handig zijn voor foutopsporing. Als u uitgebreid wilt registreren in uw script, gebruikt u de volgende PowerShell: Write-Verbose 'Mijn bericht' -Uitgebreid.

Eigenschapsnamen die moeten worden geserialiseerd
PropertyNamesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf wilt serialiseren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Eigenschapstypen die moeten worden geserialiseerd
PropertyTypesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (per type) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapsnamen om te serialiseren' te gebruiken (kies een). Deze invoer is een verzameling met één eigenschapstypeveld. Bijvoorbeeld: Als u een eigenschap van het type Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] wilt serialiseren, voer [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (JSON-tabelindeling), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-matrixindeling) of Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServiceInfoPlan[] (CSV-indeling) in.

Naam
Name string

De naam van de PowerShell-invoerparameter. Dit moet voldoen aan de naamgevingsindelingen van PowerShell-variabelen (dat wil gezegd worden aanbevolen om spaties of speciale symbolen te voorkomen). Namen van PowerShell-variabelen zijn niet hoofdlettergevoelig. Bijvoorbeeld: MyVariable resulteert in een variabele $MyVariable wordt gemaakt.

Tekenreekswaarde
StringValue string

De tekenreekswaarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een Booleaanse of numerieke waarde invoert.

Integerwaarde
IntValue integer

De waarde voor een geheel getal (geheel getal) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Booleaanse waarde
BooleanValue boolean

De booleaanse waarde (waar of onwaar) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks of numerieke waarde invoert.

Decimale waarde
DecimalValue double

De decimale waarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks, booleaanse waarde of een geheel getal invoert.

Objectwaarde
ObjectValue object

De objectwaarde die moet worden toegewezen aan de PowerShell-invoerparameter. Dit wordt een met JSON geserialiseerde tekenreeksvariabele in het PowerShell-script, dus deserialiseren naar een object met behulp van ConvertFrom-Json. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
PowerShell-uitvoer-JSON
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

Thread-id
ThreadId integer

Als het PowerShell-script wordt uitgevoerd als een agentthread, bevat deze uitvoer de agentthread-id die kan worden gebruikt om de uitvoering van het PowerShell-script te bewaken en de Resultaten van het PowerShell-script op te halen wanneer het script is voltooid.

Groepslidmaatschap van Microsoft Exchange-postvakdistributie ophalen

Haal op van welke distributiegroepen een postvak lid is.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met Microsoft Exchange-distributiegroepen waarvan het postvak lid is, in JSON-indeling.

Aantal gevonden distributiegroepen
CountOfDistributionGroupsFound integer

Het aantal Microsoft Exchange-distributiegroepen waarvan het postvak lid is.

Heeft het Office 365-postvak een archief

Rapporteert of een bestaand postvak in Microsoft Exchange Online een archiefpostvak heeft. Als het postvak niet bestaat, wordt er een uitzondering gegenereerd.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Postvak heeft een archief
MailboxHasAnArchive boolean

Ingesteld op Waar als het postvak een archief heeft.

Het Microsoft Exchange Online-postvak voor een gebruiker uitschakelen

Schakel een bestaand Postvak in Microsoft Exchange Online of Office 365 (extern) uit. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het postvak van Microsoft Exchange Online of Office 365 (extern). U kunt een Microsoft Exchange Online- of Office 365-postvak (extern) opgeven op basis van de Object-id van Active Directory, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, e-mailadres, GUID of User Principal Name (UPN).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie Postvak uitschakelen, in JSON-indeling.

Het Microsoft Exchange-postvak voor een gebruiker uitschakelen

Schakel een bestaand Microsoft Exchange-postvak uit.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de actie Postvak uitschakelen, in JSON-indeling.

Is Azure AD-gebruiker toegewezen aan de beheerdersrol

Hiermee wordt geretourneerd of een Azure Active Directory-gebruiker is toegewezen aan een Azure Active Directory-beheerdersrol. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
UserObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Id of weergavenaam van rolobject
RoleObjectId True string

De id of weergavenaam van een Azure Active Directory-beheerdersrol. U kunt een AAD-beheerdersrol opgeven op weergavenaam (bijvoorbeeld 'Toepassingsontwikkelaar') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Gebruiker is toegewezen aan rol
UserIsAssignedToRole boolean

Of de gebruiker is toegewezen aan de beheerdersrol van Azure Active Directory.

Is de Azure AD PowerShell-module geïnstalleerd

Rapporteert of de PowerShell-modules die vereist zijn voor Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD) zijn geïnstalleerd op de computer waarop de IA-Connect Agent wordt uitgevoerd. Met deze actie wordt gecontroleerd op de PowerShell-modules van Azure AD v2 en Microsoft Graph Users.

Parameters

Name Sleutel Vereist Type Description
Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Azure AD v2 PowerShell-module is geïnstalleerd
AzureADv2PowerShellModuleInstalled boolean

Ingesteld op true als de Azure AD v2 PowerShell-module (AzureAD) is geïnstalleerd.

Microsoft Graph Users PowerShell-module is geïnstalleerd
MSGraphUsersPowerShellModuleInstalled boolean

Ingesteld op waar als de PowerShell-modules van Microsoft Graph Users (Microsoft.Graph.Users en Microsoft.Graph.Authentication) zijn geïnstalleerd.

Is gebruiker in Azure AD-gebruikersgroep

Hiermee wordt geretourneerd of een gebruiker lid is van een Azure Active Directory-groep. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Groepsobject-id of weergavenaam
GroupObjectId True string

De id of weergavenaam van een Azure Active Directory-groep. U kunt een groep opgeven op weergavenaam (bijvoorbeeld 'Financiële gebruikers') of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Gebruiker bevindt zich in groep
UserIsInGroup boolean

Of de gebruiker lid is van de Azure AD-groep.

Is verbonden met Active Directory

Rapporteert of IA-Connect is verbonden met Active Directory. Standaard wordt IA-Connect automatisch verbonden met het domein waarvan de computer waarop de IA-Connect Agent wordt uitgevoerd lid is, met behulp van het account waarop de IA-Connect Agent wordt uitgevoerd. Gebruik de actie Verbinding maken met Active Directory met referenties om verbinding te maken met behulp van alternatieve referenties of een alternatief domein.

Parameters

Name Sleutel Vereist Type Description
Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Verbonden met Active Directory
ActiveDirectoryRunspaceOpen boolean

Ingesteld op true als IA-Connect is verbonden met Active Directory. Dit moet altijd waar retourneren omdat IA-Connect automatisch is verbonden met het domein waarvan de computer waarop de agent wordt uitgevoerd lid is.

Lokale passthrough-verbinding
ActiveDirectoryLocalPassthroughRunspace boolean

Ingesteld op true als IA-Connect is verbonden met het domein waarvan de computer waarop de IA-Connect Agent wordt uitgevoerd lid is, met behulp van het account waarop de IA-Connect Agent wordt uitgevoerd.

Active Directory-server
ActiveDirectoryServer string

De Active Directory-server die is verbonden met. Als dit leeg is, gebruikt IA-Connect de standaard Active Directory-domeincontroller voor de computer waarop de agent wordt uitgevoerd, op basis van de ad-site-instellingen.

Dns-domein van Active Directory
ActiveDirectoryDNSDomain string

Het Active Directory DNS-domein voor het domein IA-Connect is verbonden. Als dit leeg is, gebruikt IA-Connect het standaard Active Directory-domein voor de computer waarop de agent wordt uitgevoerd. Bijvoorbeeld: mydomain.local.

DN van Active Directory-domein
ActiveDirectoryDomainDN string

De DN van het Active Directory-domein voor het domein IA-Connect is verbonden met. Als dit leeg is, gebruikt IA-Connect het standaard Active Directory-domein voor de computer waarop de agent wordt uitgevoerd. Bijvoorbeeld: DC=mydomain, DC=local.

Geverifieerde gebruikersnaam
AuthenticatedUsername string

De geverifieerde gebruikersnaam IA-Connect gebruikt voor de verbinding met Active Directory. Als dit leeg is, gebruikt IA-Connect het account waarop de IA-Connect Agent wordt uitgevoerd.

Is verbonden met Azure AD

Rapporteert of IA-Connect is verbonden met Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). Gebruik een van de acties Verbinding maken met Azure AD om verbinding te maken.

Parameters

Name Sleutel Vereist Type Description
PowerShell-runspace-proces-id ophalen
RetrievePowerShellRunSpacePID boolean

Als deze optie is ingesteld op true: de IA-Connect-agent haalt informatie op met betrekking tot de proces-id van het proces dat als host fungeert voor de PowerShell-runspace. Deze informatie wordt opgegeven in de uitvoer 'PowerShell runspace process Id' en 'Is Agent hosting PowerShell runspace'.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Azure AD PowerShell-runspace is geopend
AzureADv2RunspaceOpen boolean

Ingesteld op true als IA-Connect is verbonden met Azure AD. Dit kan de PowerShell-modules azure AD v2 of Microsoft Graph Users gebruiken.

Azure AD-API
AzureADAPI string

De naam van de Azure AD-API die wordt gebruikt. Dit is ingesteld op AzureADv2 als u de PowerShell-module van Azure AD v2 of MSGraphUsersPS gebruikt als u de PowerShell-module Microsoft Graph Users gebruikt.

PowerShell-runspace-proces-id
PowerShellRunspacePID integer

De PowerShell-runspace-proces-id (PID). Als de IA-Connect-agent als host fungeert voor de PowerShell-runspace, is deze waarde de PID van de IA-Connect-agent. Als de PowerShell-runspace is geïsoleerd, is deze waarde de PID van het isolatieproces.

Is agent die als host fungeert voor PowerShell-runspace
IsAgentHostingPowerShellRunSpace boolean

Retourneert true, als de IA-Connect Agent als host fungeert voor de PowerShell-runspace (dat wil bijvoorbeeld als de 'PowerShell-runspace-proces-id' de agent-PID is).

Is verbonden met Microsoft Exchange

Rapporteert of IA-Connect is verbonden met een Microsoft Exchange-server. Gebruik de actie Verbinding maken met Microsoft Exchange om verbinding te maken.

Parameters

Name Sleutel Vereist Type Description
Communicatie testen
TestCommunications boolean

Als deze optie is ingesteld op onwaar: IA-Connect geeft geen testopdracht uit om te bevestigen dat de Exchange-serververbinding functioneel is en afhankelijk is van de laatst bekende status. Als deze optie is ingesteld op true (de standaardinstelling): IA-Connect geeft een testopdracht uit om te bevestigen dat de Exchange-serververbinding functioneel is.

PowerShell-runspace-proces-id ophalen
RetrievePowerShellRunSpacePID boolean

Als deze optie is ingesteld op true: de IA-Connect-agent haalt informatie op met betrekking tot de proces-id van het proces dat als host fungeert voor de PowerShell-runspace. Deze informatie wordt opgegeven in de uitvoer 'PowerShell runspace process Id' en 'Is Agent hosting PowerShell runspace'.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Verbonden met Microsoft Exchange
ExchangeRunspaceOpen boolean

Ingesteld op true als IA-Connect is verbonden met Microsoft Exchange.

Exchange-verbindingsmethode
ExchangeConnectionMethod string

Bevat de huidige Exchange-verbindingsmethode: Lokaal of Extern.

PowerShell-runspace-proces-id
PowerShellRunspacePID integer

De PowerShell-runspace-proces-id (PID). Als de IA-Connect-agent als host fungeert voor de PowerShell-runspace, is deze waarde de PID van de IA-Connect-agent. Als de PowerShell-runspace is geïsoleerd, is deze waarde de PID van het isolatieproces.

Is agent die als host fungeert voor PowerShell-runspace
IsAgentHostingPowerShellRunSpace boolean

Retourneert true, als de IA-Connect Agent als host fungeert voor de PowerShell-runspace (dat wil bijvoorbeeld als de 'PowerShell-runspace-proces-id' de agent-PID is).

Is verbonden met Office 365

Rapporteert of IA-Connect is verbonden met Office 365 met behulp van de Office 365 PowerShell-modules. Gebruik de actie Verbinding maken met Office 365 om verbinding te maken.

Parameters

Name Sleutel Vereist Type Description
Communicatie testen
TestCommunications boolean

Als deze optie is ingesteld op onwaar: IA-Connect geeft geen testopdracht uit om te bevestigen dat de Office 365 Exchange Online-verbinding functioneel is en afhankelijk is van de laatst bekende status. Als deze optie is ingesteld op true (de standaardinstelling): IA-Connect geeft een testopdracht uit om te bevestigen dat de Office 365 Exchange Online-verbinding functioneel is.

PowerShell-runspace-proces-id ophalen
RetrievePowerShellRunSpacePID boolean

Als deze optie is ingesteld op true: de IA-Connect-agent haalt informatie op met betrekking tot de proces-id van het proces dat als host fungeert voor de PowerShell-runspace. Deze informatie wordt opgegeven in de uitvoer 'PowerShell runspace process Id' en 'Is Agent hosting PowerShell runspace'.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Verbonden met Office 365
O365RunspaceOpen boolean

Ingesteld op true als IA-Connect is verbonden met Office 365 met behulp van de Office 365 PowerShell-modules.

Verbindingsmethode voor Office 365
Office365ConnectionMethod string

Bevat de huidige verbindingsmethode voor Office 365: EXOV1 of EXOV2.

PowerShell-runspace-proces-id
PowerShellRunspacePID integer

De PowerShell-runspace-proces-id (PID). Als de IA-Connect-agent als host fungeert voor de PowerShell-runspace, is deze waarde de PID van de IA-Connect-agent. Als de PowerShell-runspace is geïsoleerd, is deze waarde de PID van het isolatieproces.

Is agent die als host fungeert voor PowerShell-runspace
IsAgentHostingPowerShellRunSpace boolean

Retourneert true, als de IA-Connect Agent als host fungeert voor de PowerShell-runspace (dat wil bijvoorbeeld als de 'PowerShell-runspace-proces-id' de agent-PID is).

Leden van De Office 365-distributiegroep ophalen

Haal een lijst op van de leden van een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
GroupIdentity True string

De identiteit van de distributiegroep die moet worden gezocht. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Eigenschappen die moeten worden opgehaald
PropertiesToRetrieveJSON string

Een lijst met lideigenschappen die moeten worden opgehaald, in JSON- of CSV-indeling. Bijvoorbeeld: ["Identity", "DistinguishedName"] (JSON-matrixindeling) of "Identity","DistinguishedName" (CSV-indeling). Veelvoorkomende lideigenschappen zijn: Alias, DisplayName, DistinguishedName, Identity, Name, PrimarySMTPAddress, RecipientType en SamAccountName. Als u dit veld leeg laat, wordt een standaardset eigenschappen opgehaald.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Leden van distributiegroep
O365DistributionGroupMembersJSON string

Een lijst met leden van de Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail in JSON-indeling.

Aantal leden van distributiegroepen
O365CountOfDistributionGroupsMembers integer

Het aantal leden van de Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Leden van Microsoft Exchange-distributiegroep ophalen

Haal een lijst op met de leden van een Microsoft Exchange-distributiegroep.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity True string

De identiteit van de distributiegroep die moet worden gezocht. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Leden van distributiegroep
DistributionGroupMembersJSON string

Een lijst met leden van de Exchange-distributiegroep, in JSON-indeling.

Aantal leden van distributiegroepen
CountOfDistributionGroupsMembers integer

Het aantal leden van de Microsoft Exchange-distributiegroep.

Lidmaatschap van Active Directory-gebruikersgroep klonen

Voegt de doel-Active Directory-gebruiker toe aan dezelfde Active Directory-groepen waarvan de eerste gebruiker lid is, minus de primaire groep (meestal 'Domeingebruikers') omdat het technisch geen lidmaatschap is.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit van bron
SourceUserIdentity True string

De identiteit van de Active Directory-brongebruiker (de gebruiker waaruit groepen moeten worden gekopieerd). U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Doelgebruikersidentiteit
DestinationUserIdentity True string

De identiteit van de doel-Active Directory-gebruiker (de gebruiker waaraan de groepen moeten worden toegevoegd). U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD-groepen zijn toegevoegd
ADGroupsAddedSuccessfully integer

Het aantal AD-groepen waaraan de doelgebruiker is toegevoegd.

AD-groepen kunnen niet worden toegevoegd
ADGroupsFailedToAdd integer

Het aantal AD-groepen waaraan de doelgebruiker niet kan toevoegen.

Foutbericht AD-groepen toevoegen
AddADGroupsMasterErrorMessage string

Als de doelgebruiker niet kan worden toegevoegd aan een aantal AD-groepen, bevat dit foutbericht details van het probleem.

Lidmaatschap van Active Directory-gebruikersgroep ophalen

Retourneert een lijst met Active Directory-groepen waarvan de opgegeven gebruiker lid is, minus de primaire groep (meestal 'Domeingebruikers') omdat het technisch geen lidmaatschap is. Deze actie werkt alleen met gebruikersaccounts. U kunt deze actie niet gebruiken om een query uit te voeren op groepslidmaatschap van groepen of computers.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De gebruiker die een query uitvoert op groepslidmaatschap. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON voor groepslidmaatschap
GroupMembershipJSON string

De lijst met AD-groepen waarvan de gebruiker lid is, heeft de JSON-indeling.

Aantal gevonden groepen
CountOfGroupsFound integer

Het aantal AD-groepen waarvan de gebruiker lid is, minus de primaire groep (meestal 'Domeingebruikers') die niet wordt geteld.

Lidmaatschap van Azure AD-gebruikersgroep ophalen

Retourneert een lijst met Azure Active Directory-groepen waarvan de opgegeven gebruiker lid is. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Eigenschappen die moeten worden geretourneerd
PropertiesToReturn string

Een door komma's gescheiden lijst (CSV) van alle groepseigenschappen die moeten worden geretourneerd (ophalen). Als deze optie leeg is (de standaardinstelling), retourneert IA-Connect alle groepseigenschappen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON voor groepslidmaatschap
PowerShellJSONOutput string

De lijst met Azure AD-groepen waarvan de gebruiker lid is, in JSON-indeling.

Aantal gevonden groepen
CountOfGroupsFound integer

Het aantal Azure AD-groepen waarvan de gebruiker lid is.

Lidmaatschap van office 365-postvakdistributiegroep ophalen

Haal op van welke distributiegroepen of beveiligingsgroepen met e-mail een Office 365- of Exchange Online-postvak lid is.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
MailboxIdentity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Eigenschappen die moeten worden opgehaald
PropertiesToRetrieveJSON string

Een lijst met lideigenschappen die moeten worden opgehaald, in JSON- of CSV-indeling. Bijvoorbeeld: ["Identity", "DistinguishedName"] (JSON-matrixindeling) of "Identity","DistinguishedName" (CSV-indeling). Algemene groepseigenschappen zijn: Alias, DisplayName, DistinguishedName, GroupType, Identity, Name, PrimarySmtpAddress en SamAcountName. Als u dit veld leeg laat, wordt een standaardset eigenschappen opgehaald.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met Office 365- of Exchange Online-distributiegroepen of beveiligingsgroepen met e-mail waarvoor het postvak lid is, heeft de JSON-indeling.

Aantal gevonden distributiegroepen
CountOfDistributionGroupsFound integer

Het aantal Office 365- of Exchange Online-distributiegroepen of beveiligingsgroepen met e-mail waarvan het postvak lid is.

Meerdere Active Directory-groepsleden toevoegen

Voeg een of meer Active Directory-objecten (meestal gebruikers, groepen of computers) toe aan een bestaande Active Directory-groep. IA-Connect zo veel mogelijk leden aan de groep toevoegt en rapporteert over het resultaat. Als groep en groepslid zich in verschillende domeinen bevinden, moet u de DN (Distinguished Name) opgeven voor zowel groep als leden. Als sommige objecten al lid zijn van de groep, wordt dit geteld als een succes.

Parameters

Name Sleutel Vereist Type Description
Groepsidentiteit
GroupIdentity string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Groepsleden
GroupMembersJSON string

Een lijst met leden (meestal gebruikers, groepen of computers) die moeten worden toegevoegd aan de AD-groep, in JSON- of CSV-indeling. Bijvoorbeeld: [{"MemberName": "User 1"}, {"MemberName": "User 2"}] (JSON table format), ["User 1", "User 2"] (JSON array format) of User 1, User 2 (CSV-indeling). U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

Uitzondering als leden niet kunnen toevoegen
ExceptionIfAnyMembersFailToAdd boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als er geen enkele leden kunnen worden toegevoegd (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel leden zijn toegevoegd en hoeveel leden niet kunnen worden toegevoegd.

Uitzondering als alle leden niet kunnen toevoegen
ExceptionIfAllMembersFailToAdd boolean

Als deze optie is ingesteld op true: er wordt alleen een uitzondering (fout) gegenereerd als alle leden niet kunnen worden toegevoegd (dus geen successen en sommige fouten). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel leden zijn toegevoegd en hoeveel leden niet kunnen worden toegevoegd.

Alle leden toevoegen in één aanroep
AddAllMembersInASingleCall boolean

Als deze optie is ingesteld op true, worden alle leden in één actie aan de groep toegevoegd. Dit gaat sneller, maar als één lid niet bestaat of niet kan worden toegevoegd, worden er geen leden toegevoegd en wordt er een uitzondering gegenereerd, ongeacht de invoeropties 'Uitzondering'. Als deze optie is ingesteld op false (de standaardinstelling), wordt elk lid afzonderlijk toegevoegd en telt de IA-Connect Agent hoeveel is toegevoegd en hoeveel niet is toegevoegd. Als u leden toevoegt aan groepen tussen domeinen, wordt u aangeraden deze invoer in te stellen op onwaar.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD-groepsleden zijn toegevoegd
ADGroupMembersAddedSuccessfully integer

Het aantal leden dat is toegevoegd aan de AD-groep.

Ad-groepsleden kunnen niet toevoegen
ADGroupMembersFailedToAdd integer

Het aantal leden dat niet kan worden toegevoegd aan de AD-groep.

Foutbericht AD-groepsleden toevoegen
AddADGroupMembersMasterErrorMessage string

Als sommige leden niet aan de AD-groep kunnen toevoegen en er geen uitzondering is gegenereerd, bevat dit foutbericht details van het probleem.

Meerdere Active Directory-groepsleden verwijderen

Verwijder een of meer Active Directory-objecten (meestal gebruikers, groepen of computers) uit een bestaande Active Directory-groep. IA-Connect verwijdert zoveel mogelijk leden uit de groep en rapporteert het resultaat. Als groep en groepslid zich in verschillende domeinen bevinden, moet u de DN (Distinguished Name) opgeven voor zowel groep als leden. Als sommige objecten geen lid van de groep zijn, wordt dit geteld als een succes.

Parameters

Name Sleutel Vereist Type Description
Groepsidentiteit
GroupIdentity string

De identiteit van de Active Directory-groep. U kunt een groep opgeven op Distinguished Name (bijvoorbeeld CN=Group1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'Group1'). U kunt geen weergavenaam of groepsnaam gebruiken (hoewel de groepsnaam vaak hetzelfde is als de voor-2K-naam die kan worden gebruikt).

Groepsleden
GroupMembersJSON string

Een lijst met leden (meestal gebruikers, groepen of computers) die u wilt verwijderen uit de AD-groep, in JSON- of CSV-indeling. Bijvoorbeeld: [{"MemberName": "User 1"}, {"MemberName": "User 2"}] (JSON table format), ["User 1", "User 2"] (JSON array format) of User 1, User 2 (CSV-indeling). U kunt een gebruiker of groep opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Groups,DC=mydomain,DC=local), GUID, SID of SAMAccountName /pre-2K name (bijvoorbeeld 'User1'). U kunt een computer opgeven op DN-naam of computernaam (pre-2K), gevolgd door een $ (bijvoorbeeld VM01$).

Uitzondering als leden niet kunnen worden verwijderd
ExceptionIfAnyMembersFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als er geen enkele leden kunnen worden verwijderd (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel leden zijn verwijderd en hoeveel leden niet kunnen worden verwijderd.

Uitzondering als alle leden niet kunnen worden verwijderd
ExceptionIfAllMembersFailToRemove boolean

Als deze optie is ingesteld op true: er wordt alleen een uitzondering (fout) gegenereerd als alle leden niet kunnen worden verwijderd (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel leden zijn verwijderd en hoeveel leden niet kunnen worden verwijderd.

Alle leden in één oproep verwijderen
RemoveAllMembersInASingleCall boolean

Als deze optie is ingesteld op true, worden alle leden in één actie uit de groep verwijderd. Dit gaat sneller, maar als één lid niet bestaat of niet kan worden verwijderd, worden er geen leden verwijderd en wordt er een uitzondering gegenereerd, ongeacht de invoeropties 'Uitzondering'. Als dit is ingesteld op onwaar (de standaardinstelling), wordt elk lid afzonderlijk verwijderd en telt de IA-Connect Agent hoeveel verwijderd is en hoeveel niet kan worden verwijderd. Als u leden uit groepen tussen domeinen verwijdert, wordt u aangeraden deze invoer in te stellen op false.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
AD-groepsleden zijn verwijderd
ADGroupMembersRemovedSuccessfully integer

Het aantal leden is verwijderd uit de AD-groep.

AD-groepsleden kunnen niet worden verwijderd
ADGroupMembersFailedToRemove integer

Het aantal leden dat niet kan worden verwijderd uit de AD-groep.

Foutbericht ad-groepsleden verwijderen
RemoveADGroupMembersMasterErrorMessage string

Als sommige leden niet uit de AD-groep konden worden verwijderd en er geen uitzondering is gegenereerd, geeft dit foutbericht details van het probleem.

Microsoft Exchange-distributiegroep verwijderen

Een Microsoft Exchange-distributiegroep verwijderen.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity True string

De identiteit van de distributiegroep. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Controle van beveiligingsgroepbeheer overslaan
BypassSecurityGroupManagerCheck boolean

Als het IA-Connect Automation-account van de agent standaard geen eigenaar van de distributiegroep is, kan de distributiegroep niet worden verwijderd. U kunt deze optie ook instellen op waar en hiermee wordt de controle verwijderd, maar het automation-account moet zich in de rollengroep Organisatiebeheer van Exchange bevinden of de rol Rolbeheer hebben toegewezen. Dit is één rol om u machtigingen te geven om een Exchange-distributiegroep te wijzigen in plaats van eigenaar te zijn van alle distributiegroepen die u moet wijzigen.

Uitzondering als de groep niet bestaat
ErrorIfGroupDoesNotExist boolean

Moet er een uitzondering optreden als de groep niet bestaat? Ingesteld op onwaar om niets te doen als de groep niet bestaat (bijvoorbeeld dat de groep al is verwijderd). Ingesteld op waar als de groep die niet bestaat een fout is (dat wil bijvoorbeeld dat deze bestaat).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeRemoveDistributionGroupResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Microsoft Exchange-lid toevoegen aan distributiegroep

Voeg een lid (bijvoorbeeld een gebruiker) toe aan een Exchange-distributiegroep. Als het lid zich al in de groep bevindt, wordt er geen actie ondernomen.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity True string

De identiteit van de distributiegroep waaraan moet worden toegevoegd. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Lid dat moet worden toegevoegd
Member True string

De identiteit van het lid dat moet worden toegevoegd aan de distributiegroep. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeAddDistributionGroupMemberResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Microsoft Exchange-lid verwijderen uit distributiegroep

Een lid (bijvoorbeeld een gebruiker) verwijderen uit een Exchange-distributiegroep. Als het lid zich niet in de groep bevindt, wordt er geen actie ondernomen.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity True string

De identiteit van de distributiegroep waaraan moet worden toegevoegd. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Lid dat moet worden verwijderd
Member True string

De identiteit van het lid dat moet worden verwijderd uit de distributiegroep. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Controle van beveiligingsgroepbeheer overslaan
BypassSecurityGroupManagerCheck boolean

Als het IA-Connect Automation-account van de agent standaard geen eigenaar van de distributiegroep is, kan de distributiegroep niet worden gewijzigd. U kunt deze optie ook instellen op waar en hiermee wordt de controle verwijderd, maar het automation-account moet zich in de rollengroep Organisatiebeheer van Exchange bevinden of de rol Rolbeheer hebben toegewezen. Dit is één rol om u machtigingen te geven om een Exchange-distributiegroep te wijzigen in plaats van eigenaar te zijn van alle distributiegroepen die u moet wijzigen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeRemoveDistributionGroupMemberResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Microsoft Exchange Online-postvak en gebruikersaccount maken

Maak een gebruiker met e-mail in on-premises Active Directory en maak een gekoppeld extern postvak in Microsoft Exchange Online of Office 365. Gebruik deze actie alleen als de gebruiker niet bestaat in on-premises Active Directory. Als de gebruiker al bestaat, gebruikt u de actie 'Microsoft Exchange Online-postvak voor een gebruiker maken'. De aanvraag wordt verzonden via uw on-premises Microsoft Exchange-server die moet worden ingesteld voor een hybride implementatie.

Parameters

Name Sleutel Vereist Type Description
Voornaam
FirstName string

De voornaam van de gebruiker.

Achternaam
LastName string

De achternaam/achternaam van de gebruiker.

Organisatie-eenheid
OnPremisesOrganizationalUnit string

De Organisatie-Eenheid (OE) waarin de gebruiker moet worden opgeslagen in de indeling Distinguished Name (bijvoorbeeld OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld MyUsers\London). Als dit leeg blijft, wordt de gebruiker gemaakt in de organisatie-eenheid Gebruikers.

Naam
Name True string

De naam van de Active Directory-gebruiker. Dit wordt weergegeven in de kolom 'Naam' in AD-gebruikers en -computers en boven aan het tabblad Gebruiker 'Algemeen'. Dit is niet de aanmeldingsnaam van de gebruiker.

Weergavenaam
DisplayName string

De optionele weergavenaam van de gebruiker.

Adres voor externe routering
RemoteRoutingAddress string

Stel dit in om het SMTP-adres van het postvak in Microsoft Exchange Online of Office 365 te overschrijven waaraan deze gebruiker is gekoppeld. Als u dit veld leeg laat (de standaardinstelling), wordt het adres voor externe routering automatisch berekend op basis van de adreslijstsynchronisatie tussen on-premises en Microsoft Exchange Online.

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias (en het beleid maakt het primaire SMTP-adres van de alias) of schakelt het e-mailadresbeleid uit.

Hoofdgebruikersnaam
UserPrincipalName True string

De aanmeldingsnaam van de gebruiker in Active Directory. Dit moet over het algemeen de notatie 'name@domainFQDN' hebben (bijvoorbeeld 'TestUser1@domain.local'). De gebruiker kan zich aanmelden met behulp van deze indeling: name@domainFQDN.

SAM-accountnaam
SamAccountName string

De aanmeldingsnaam van de gebruiker (pre-Windows 2000) in Active Directory. Dit heeft de notatie 'name' (bijvoorbeeld 'TestUser1'). De gebruiker kan zich aanmelden met behulp van deze indeling: DOMAIN\name.

Accountwachtwoord
Password password

Het gebruikerswachtwoord. Dit moet worden opgegeven en voldoen aan de regels voor wachtwoordcomplexiteit van Active Directory. Als dit een opgeslagen wachtwoord is, voert u de notatie {IAConnectPassword:StoredPasswordIdentifier} in en stelt u de invoer 'opgeslagen wachtwoord' in op waar. Als dit een algemene Orchestrator-referentie is, voert u de indeling {OrchestratorCredential:FriendlyName} in en stelt u de invoer voor het 'opgeslagen wachtwoord' in op true.

Wachtwoord voor account is opgeslagen
AccountPasswordIsStoredPassword boolean

Ingesteld op waar als het wachtwoord een IA-Connect opgeslagen wachtwoord-id is (bijvoorbeeld: gegenereerd door de actie Wachtwoord genereren) of een IA-Connect Algemene Orchestrator-referentie (bijvoorbeeld: Als u IA-Connect gebruikt met een PA-stroom).

De gebruiker moet het wachtwoord bij de volgende aanmelding wijzigen
ResetPasswordOnNextLogon boolean

Ingesteld op Waar als u wilt afdwingen dat de gebruiker het wachtwoord wijzigt wanneer hij of zij zich aanmeldt (het nieuwe wachtwoord dat hier wordt ingesteld, is een eenmalig wachtwoord om de gebruiker aan te melden). Ingesteld op onwaar als dit het wachtwoord is dat de gebruiker zal gebruiken totdat deze handmatig wordt gewijzigd.

Is gedeeld postvak
SharedMailbox boolean

Ingesteld op Waar als het postvak dat wordt gemaakt een gedeeld postvak moet zijn.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

Archiefpostvak maken
Archive boolean

Stel deze optie in op Waar als u ook een archiefpostvak wilt maken in Microsoft Exchange Online of Office 365.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de nieuwe actie extern postvak, in JSON-indeling.

Nieuw postvak-DN
NewMailboxDN string

De DN (Distinguished Name) van het zojuist gemaakte postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Nieuwe postvak-GUID
NewMailboxGUID string

De GUID van het zojuist gemaakte postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Microsoft Exchange-postvak en gebruikersaccount maken

Maak een gebruiker met e-mail in on-premises Active Directory en maak een gekoppeld postvak in Microsoft Exchange. Gebruik deze actie alleen als de gebruiker niet bestaat in on-premises Active Directory. Als de gebruiker al bestaat, gebruikt u de actie 'Een Microsoft Exchange-postvak voor een gebruiker maken'.

Parameters

Name Sleutel Vereist Type Description
Voornaam
FirstName string

De voornaam van de gebruiker.

Achternaam
LastName string

De achternaam/achternaam van de gebruiker.

Organisatie-eenheid
OrganizationalUnit string

De Organisatie-Eenheid (OE) waarin de gebruiker moet worden opgeslagen in de indeling Distinguished Name (bijvoorbeeld OU=Target OU,OU=London,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld MyUsers\London). Als dit leeg blijft, wordt de gebruiker gemaakt in de organisatie-eenheid Gebruikers.

Naam
Name True string

De naam van de Active Directory-gebruiker. Dit wordt weergegeven in de kolom 'Naam' in AD-gebruikers en -computers en boven aan het tabblad Gebruiker 'Algemeen'. Dit is niet de aanmeldingsnaam van de gebruiker.

Weergavenaam
DisplayName string

De optionele weergavenaam van de gebruiker.

Alias
Alias string

De Exchange-alias (ook wel e-mailnaam genoemd) voor de gebruiker. Als het e-mailadresbeleid is ingeschakeld, wordt dit gebruikt om het naamonderdeel van het primaire SMTP-e-mailadres te genereren (bijvoorbeeld alias@mydomain.com). Als het e-mailadresbeleid niet is ingeschakeld, kunt u het primaire SMTP-adres instellen.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire retour-e-mailadres dat wordt gebruikt voor de geadresseerde. U kunt dit waarschijnlijk niet instellen als het beleid voor e-mailadressen is ingeschakeld, dus gebruik in plaats daarvan Alias (en het beleid maakt het primaire SMTP-adres van de alias) of schakelt het e-mailadresbeleid uit.

Hoofdgebruikersnaam
UserPrincipalName True string

De aanmeldingsnaam van de gebruiker in Active Directory. Dit moet over het algemeen de notatie 'name@domainFQDN' hebben (bijvoorbeeld 'TestUser1@domain.local'). De gebruiker kan zich aanmelden met behulp van deze indeling: name@domainFQDN.

SAM-accountnaam
SamAccountName string

De aanmeldingsnaam van de gebruiker (pre-Windows 2000) in Active Directory. Dit heeft de notatie 'name' (bijvoorbeeld 'TestUser1'). De gebruiker kan zich aanmelden met behulp van deze indeling: DOMAIN\name.

Accountwachtwoord
Password password

Het gebruikerswachtwoord. Dit moet worden opgegeven en voldoen aan de regels voor wachtwoordcomplexiteit van Active Directory. Als dit een opgeslagen wachtwoord is, voert u de notatie {IAConnectPassword:StoredPasswordIdentifier} in en stelt u de invoer 'opgeslagen wachtwoord' in op waar. Als dit een algemene Orchestrator-referentie is, voert u de indeling {OrchestratorCredential:FriendlyName} in en stelt u de invoer voor het 'opgeslagen wachtwoord' in op true.

Wachtwoord voor account is opgeslagen
AccountPasswordIsStoredPassword boolean

Ingesteld op waar als het wachtwoord een IA-Connect opgeslagen wachtwoord-id is (bijvoorbeeld: gegenereerd door de actie Wachtwoord genereren) of een IA-Connect Algemene Orchestrator-referentie (bijvoorbeeld: Als u IA-Connect gebruikt met een PA-stroom).

De gebruiker moet het wachtwoord bij de volgende aanmelding wijzigen
ResetPasswordOnNextLogon boolean

Ingesteld op Waar als u wilt afdwingen dat de gebruiker het wachtwoord wijzigt wanneer hij of zij zich aanmeldt (het nieuwe wachtwoord dat hier wordt ingesteld, is een eenmalig wachtwoord om de gebruiker aan te melden). Ingesteld op onwaar als dit het wachtwoord is dat de gebruiker zal gebruiken totdat deze handmatig wordt gewijzigd.

gegevensbank
Database string

De Exchange-database die de nieuwe database bevat. U kunt de database opgeven op basis van DN-naam, GUID of Naam.

Is gedeeld postvak
SharedMailbox boolean

Ingesteld op Waar als het postvak dat wordt gemaakt een gedeeld postvak moet zijn.

Beleid voor e-mailadressen ingeschakeld
EmailAddressPolicyEnabled boolean

Ingesteld op waar als u e-mailadressen automatisch wilt bijwerken op basis van het beleid voor e-mailadressen dat is toegepast op deze geadresseerde. Als het e-mailadresbeleid is ingeschakeld, heeft dit meestal invloed op de mogelijkheid om het primaire SMTP-adres in te stellen. Ingesteld op onwaar om de functie uit te schakelen, zodat u volledig beheer hebt om e-mailadressen handmatig in te stellen. Laat niets staan als u deze optie niet wilt instellen (dat wil bijvoorbeeld laten staan op de bestaande of standaardwaarde).

Archiefpostvak maken
Archive boolean

Stel deze optie in op Waar als u ook een archiefpostvak wilt maken in Microsoft Exchange Online of Office 365.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de nieuwe postvakactie, in JSON-indeling.

Nieuw postvak-DN
NewMailboxDN string

De DN (Distinguished Name) van het zojuist gemaakte postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Nieuwe postvak-GUID
NewMailboxGUID string

De GUID van het zojuist gemaakte postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties voor dit postvak.

Microsoft Exchange-postvakmachtiging toevoegen

Wijs postvakmachtigingen toe aan een Active Directory-object (bijvoorbeeld gebruiker of groep).

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

Active Directory-object
User True string

Het Active Directory-object (bijvoorbeeld gebruiker of groep) waaraan de machtigingen moeten worden toegewezen. U kunt een gebruiker opgeven op Naam, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName of User Principal Name (UPN).

Toegangsrechten
AccessRights string

De toegangsrechten om toe te wijzen aan de machtigingen van de gebruiker voor het postvak. Beschikbare opties zijn 'AccessSystemSecurity', 'CreateChild', 'DeleteChild', 'ListChildren', 'Self', 'ReadProperty', 'WriteProperty', 'DeleteTree', 'ListObject', 'ExtendedRight', 'Delete', 'ReadControl', 'GenericExecute', 'GenericWrite', 'GenericRead', 'WriteDacl', 'WriteOwner', 'GenericAll' en 'Sync'.

Uitgebreide rechten
ExtendedRights string

Een optioneel uitgebreid recht om toe te wijzen aan de machtigingen van de gebruiker voor het postvak. Uitgebreide rechten omvatten 'Verzenden als'.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeAddADPermissionResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Microsoft Exchange-postvakmachtiging toevoegen aan gebruiker

Wijs postvakmachtigingen toe aan een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

User
User True string

De gebruiker die moet worden toegevoegd aan de postvakmachtigingen. U kunt een gebruiker opgeven op Naam, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName of User Principal Name (UPN).

Toegangsrechten
AccessRights True string

De toegangsrechten om toe te wijzen aan de machtigingen van de gebruiker voor het postvak. Beschikbare opties zijn 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' en 'ReadPermission'. Als u meerdere machtigingen wilt toewijzen, geeft u deze op als een door komma's gescheiden lijst.

Automatische toewijzing
AutoMapping boolean

Als deze optie is ingesteld op true, hebben het postvak en het gebruikersaccount een aantal extra eigenschappen ingesteld, waardoor het postvak automatisch wordt geopend wanneer deze gebruiker is aangemeld. Dit kan enkele minuten duren. Als deze optie is ingesteld op onwaar, worden de aanvullende eigenschappen niet ingesteld en wordt het postvak niet automatisch geopend.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeAddMailboxPermissionResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Microsoft Exchange-postvakmachtiging verwijderen van gebruiker

Verwijder postvakmachtigingen uit een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De identiteit van het Microsoft Exchange-postvak. U kunt een postvak opgeven op naam, alias, Dn-naam (bijvoorbeeld CN=Gebruiker1,OU=Mijn gebruikers,DC=mydomain,DC=lokaal), DOMEIN\gebruikersnaam, e-mailadres, GUID, SAMAccountName of UPN (User Principal Name).

User
User True string

De gebruiker die uit de postvakmachtigingen moet worden verwijderd. U kunt een gebruiker opgeven op Naam, Alias, Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), DOMAIN\username, Email address, GUID, SAMAccountName of User Principal Name (UPN).

Toegangsrechten
AccessRights True string

De toegangsrechten die moeten worden verwijderd uit de machtigingen van de gebruiker voor het postvak. Beschikbare opties zijn 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' en 'ReadPermission'. Als u meerdere machtigingen wilt verwijderen, geeft u deze op als een door komma's gescheiden lijst.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ExchangeRemoveMailboxPermissionResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Office 365-archiefpostvak maken voor bestaande gebruiker

Hiermee maakt u een gearchiveerd postvak in Microsoft Exchange Online voor een bestaande gebruiker in Azure Active Directory/Entra-id. De gebruiker moet al een postvak en een geschikte licentie hebben.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Controleren of archief bestaat
CheckIfArchiveExists boolean

Als deze optie is ingesteld op true (de standaardinstelling), controleert de IA-Connect Agent of het postvak al een archief heeft. Als er al een archief bestaat, hoeft u niets te doen (omdat u niet twee keer een archief kunt maken) en de agent slaagt. Als deze optie is ingesteld op false, controleert de IA-Connect Agent niet of het postvak al een archief heeft, wat resulteert in een uitzondering als deze al bestaat.

Archiefnaam
ArchiveName string

De optionele archiefnaam. Als dit niet is opgegeven, wordt deze standaard ingesteld op 'In-Place Archief - {Weergavenaam}'.

Automatisch uitbreiden van archief
AutoExpandingArchive boolean

Als deze optie is ingesteld op waar, wordt er automatisch extra opslagruimte toegevoegd aan het archiefpostvak wanneer deze de opslaglimiet nadert. Deze functie kan niet worden uitgeschakeld, nadat deze is ingeschakeld.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365EnableArchiveMailboxResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Office 365-distributiegroep ophalen

Retourneert de eigenschappen van de opgegeven Microsoft Exchange Online- of Office 365-distributiegroepen of beveiligingsgroepen met e-mail. U kunt zoeken op identiteit of met behulp van een filter. Een identiteitszoekopdracht moet 0 of 1 resultaten opleveren. Een filterzoekactie kan 0 of meer resultaten opleveren.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity string

De identiteit van de distributiegroep of beveiligingsgroep met e-mail. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op waarop u de distributiegroepen wilt filteren. Algemene eigenschapsnamen zijn: DisplayName, Name, GroupType, PrimarySMTPAddress. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de waarde van de filtereigenschap 'JohnDoe' zijn).

Is geen resultaat een uitzondering
NoResultIsAnException boolean

Stel in op True om een uitzondering te genereren als er geen distributiegroepen worden gevonden. Ingesteld op onwaar om een telling van 0 te melden als er geen distributiegroepen worden gevonden. Houd er rekening mee dat de optie 'onwaar' mogelijk niet werkt wanneer deze wordt gebruikt met identiteit in niet-Engelse talen, dus overweeg in plaats daarvan te zoeken met behulp van filters.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

Aantal gevonden groepen
CountOfGroupsFound integer

Het aantal distributiegroepen of beveiligingsgroepen met e-mail die overeenkomen met de zoekidentiteit. Meestal 1.

Office 365-distributiegroep verwijderen

Verwijder een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity True string

De identiteit van de distributiegroep of beveiligingsgroep met e-mail die moet worden verwijderd. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Controle van beveiligingsgroepbeheer overslaan
BypassSecurityGroupManagerCheck boolean

Als het IA-Connect Agent Automation-account geen eigenaar is van de distributiegroep of beveiligingsgroep met e-mail, kan de groep niet worden verwijderd. Als u deze optie instelt op true (de standaardinstelling), wordt de controle van de eigenaar overgeslagen, maar moet het automation-account zich in de rollengroep Organisatiebeheer van Exchange bevinden of de rol Rolbeheer hebben toegewezen. Dit is één rol om u machtigingen te geven om een Office 355 Exchange Online-groep te wijzigen in plaats van een eigenaar te zijn van alle groepen die u moet wijzigen.

Uitzondering als de groep niet bestaat
ErrorIfGroupDoesNotExist boolean

Moet er een uitzondering optreden als de groep niet bestaat? Ingesteld op onwaar om niets te doen als de groep niet bestaat (bijvoorbeeld dat de groep al is verwijderd). Ingesteld op waar als de groep die niet bestaat een fout is (dat wil bijvoorbeeld dat deze bestaat).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365RemoveDistributionGroupResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Office 365-lid toevoegen aan distributiegroep

Voeg een lid toe aan een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
Identity True string

De identiteit van de distributiegroep of beveiligingsgroep met e-mail waaraan moet worden toegevoegd. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Lid dat moet worden toegevoegd
Member True string

De identiteit van het lid dat moet worden toegevoegd aan de distributiegroep of beveiligingsgroep met e-mail. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Controle van beveiligingsgroepbeheer overslaan
BypassSecurityGroupManagerCheck boolean

Als het IA-Connect Agent Automation-account geen eigenaar is van de distributiegroep of beveiligingsgroep met e-mail, kan de groep niet worden verwijderd. Als u deze optie instelt op waar, wordt de controle van de eigenaar overgeslagen, maar moet het automation-account zich in de rollengroep Organisatiebeheer van Exchange bevinden of de rol Rolbeheer hebben toegewezen. Dit is één rol om u machtigingen te geven om een Office 355 Exchange Online-groep te wijzigen in plaats van eigenaar te zijn van alle groepen die u moet wijzigen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365AddDistributionGroupMemberResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Office 365-lid verwijderen uit distributiegroep

Een lid verwijderen uit een Microsoft Exchange Online- of Office 365-distributiegroep of beveiligingsgroep met e-mail.

Parameters

Name Sleutel Vereist Type Description
Identiteit van distributiegroep
GroupIdentity True string

De identiteit van de distributiegroep of beveiligingsgroep met e-mail waaruit moet worden verwijderd. U kunt een distributiegroep opgeven op naam, alias, DN-naam (bijvoorbeeld CN=MyGroup,OU=My Groups,DC=mydomain,DC=local), e-mailadres of GUID.

Lid dat moet worden verwijderd
Member True string

De identiteit van het lid dat moet worden verwijderd uit de distributiegroep of beveiligingsgroep met e-mail. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Controle van beveiligingsgroepbeheer overslaan
BypassSecurityGroupManagerCheck boolean

Als het IA-Connect Agent Automation-account geen eigenaar is van de distributiegroep of beveiligingsgroep met e-mail, kan het geen lid uit de groep verwijderen. Als u deze optie instelt op true (de standaardinstelling), wordt de controle van de eigenaar overgeslagen, maar moet het automation-account zich in de rollengroep Organisatiebeheer van Exchange bevinden of de rol Rolbeheer hebben toegewezen. Dit is één rol om u machtigingen te geven om een Office 355 Exchange Online-groep te wijzigen in plaats van een eigenaar te zijn van alle groepen die u moet wijzigen.

Uitzondering als lid niet in groep
ExceptionIfMemberNotInGroup boolean

Moet er een uitzondering optreden als het lid zich niet in de groep bevindt? Ingesteld op onwaar (de standaardinstelling) om niets te doen als het lid zich niet in de groep bevindt (bijvoorbeeld dat het al is verwijderd of nooit in de groep was). Ingesteld op True als het lid dat zich niet in de groep bevindt een fout is (dat wil bijvoorbeeld dat het lid in de groep staat).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365RemoveDistributionGroupMemberResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Office 365-postvak en gebruikersaccount maken

Maak een postvak in Microsoft Exchange Online en een gebruikersaccount in Azure Active Directory/Entra-id. Gebruik deze actie alleen als de gebruiker nog niet bestaat in Azure Active Directory/Entra-id. Als de gebruiker al bestaat, wijst u in plaats daarvan een geschikte licentie toe aan het gebruikersaccount.

Parameters

Name Sleutel Vereist Type Description
Microsoft Online-services-id
MicrosoftOnlineServicesID True string

De unieke id van de gebruiker. Dit heeft meestal de notatie 'name@xxx.onmicrosoft.com'.

Naam
Name True string

De unieke naam van het postvak. Dit is een interne waarde die niet extern zichtbaar is. Het wordt aanbevolen deze in te stellen op dezelfde waarde als het naamonderdeel van de Microsoft Online-services-id (bijvoorbeeld 'gebruiker1'), tenzij u een alternatieve procedure hebt of een goede reden om een andere waarde te gebruiken.

Voornaam
FirstName string

De voornaam van de gebruiker.

Achternaam
LastName string

De achternaam/achternaam van de gebruiker.

Initialen
Initials string

De middelste initialen van de gebruiker.

Weergavenaam
DisplayName string

De optionele weergavenaam van de gebruiker.

Alias
Alias string

De postvakalias (ook wel e-mailnaam genoemd) voor de gebruiker. Deze waarde wordt gebruikt om het naamonderdeel van het SMTP-e-mailadres van de gebruiker te genereren (bijvoorbeeld een alias van alias zou resulteren in alias@mydomain.com). Als dit verschilt van het primaire SMTP-adres, leidt dit ertoe dat de gebruiker meerdere SMTP-adressen heeft. Als deze waarde niet is opgegeven, worden er geen gebruikersaliassen ingesteld en heeft de gebruiker alleen een primair SMTP-adres.

Primair SMTP-adres
PrimarySmtpAddress string

Het primaire SMTP-e-mailadres dat wordt gebruikt voor de geadresseerde. Als dit verschilt van de gebruikersalias, leidt dit ertoe dat de gebruiker meerdere SMTP-adressen heeft. Als deze waarde niet wordt opgegeven, wordt het primaire SMTP-adres automatisch berekend op basis van het organisatiebeleid (meestal gebaseerd op het standaarddomein dat is ingesteld in het Office 365-beheercentrum).

Accountwachtwoord
Password password

Het gebruikerswachtwoord. Dit moet worden opgegeven en voldoen aan de regels voor wachtwoordcomplexiteit van Azure Active Directory. Als dit een opgeslagen wachtwoord is, voert u de notatie {IAConnectPassword:StoredPasswordIdentifier} in en stelt u de invoer 'opgeslagen wachtwoord' in op waar. Als dit een algemene Orchestrator-referentie is, voert u de indeling {OrchestratorCredential:FriendlyName} in en stelt u de invoer voor het 'opgeslagen wachtwoord' in op true.

Wachtwoord voor account is opgeslagen
AccountPasswordIsStoredPassword boolean

Ingesteld op waar als het wachtwoord een IA-Connect opgeslagen wachtwoord-id is (bijvoorbeeld: gegenereerd door de actie Wachtwoord genereren) of een IA-Connect Algemene Orchestrator-referentie (bijvoorbeeld: Als u IA-Connect gebruikt met een PA-stroom).

De gebruiker moet het wachtwoord bij de volgende aanmelding wijzigen
ResetPasswordOnNextLogon boolean

Ingesteld op Waar als u wilt afdwingen dat de gebruiker het wachtwoord wijzigt wanneer hij of zij zich aanmeldt (het nieuwe wachtwoord dat hier wordt ingesteld, is een eenmalig wachtwoord om de gebruiker aan te melden). Ingesteld op onwaar als dit het wachtwoord is dat de gebruiker zal gebruiken totdat deze handmatig wordt gewijzigd.

Archiefpostvak maken
Archive boolean

Stel deze optie in op Waar als u ook een archiefpostvak wilt maken in Microsoft Exchange Online of Office 365.

Postvakplan
MailboxPlan string

Het optionele postvakplan dat moet worden toegepast op het postvak. Een postvakplan geeft de machtigingen en functies op die beschikbaar zijn voor een postvak. U kunt de beschikbare postvakplannen zien door het script 'Get-MailboxPlan' uit te voeren in de PowerShell-runspace 'Office 365' in de IA-Connect Inspector.

Postvakregio
MailboxRegion string

De optionele geografische regio waarin het postvak moet worden gemaakt, in een omgeving met meerdere geografische gebieden.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met actieresultaat
PowerShellJSONOutput string

De uitvoer van de nieuwe postvakactie, in JSON-indeling.

Nieuwe gebruikers-id voor Microsoft Online-services
NewUserMicrosoftOnlineServicesID string

De Microsoft Online-services-id van het zojuist gemaakte gebruikersaccount. Dit is een unieke id voor de gebruiker die kan worden gebruikt in verdere acties.

Nieuwe postvak-GUID
NewMailboxGUID string

De GUID van het zojuist gemaakte postvak. Dit is een unieke id voor het postvak dat kan worden gebruikt in verdere acties.

Nieuw primaire SMTP-adres voor postvak
NewMailboxPrimarySmtpAddress string

Het primaire SMTP-adres van het zojuist gemaakte postvak.

Office 365-postvak ophalen

Retourneert de eigenschappen van het opgegeven Microsoft Exchange Online- of Office 365-postvak.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Naam van filtereigenschap
FilterPropertyName string

Als alternatief voor zoeken op identiteit geeft u de naam van de eigenschap op om de postvakken te filteren. Algemene eigenschapsnamen zijn: Naam, Alias, PrimarySMTPAddress, DisplayName, SamAccountName. Als u een filter gebruikt, moet u ook de velden 'Vergelijking van filtereigenschappen' en 'Eigenschapswaarde filteren' invullen.

Vergelijking van filtereigenschappen
FilterPropertyComparison string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier het type vergelijking in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de vergelijking gelijk zijn aan of 'like'). Als u een onbewerkt filter (in OPATH-indeling) wilt invoeren, kiest u een vergelijkingstype Onbewerkt: Voer het filter handmatig in en voert u het volledige filter in het veld Eigenschapswaarde filteren in.

Eigenschapswaarde filteren
FilterPropertyValue string

Als u zoekt op filter als alternatief voor zoeken op identiteit, voert u hier de waarde van de filtereigenschap in (bijvoorbeeld: Als de naam van de filtereigenschap 'Alias' is, kan de waarde van de filtereigenschap 'JohnDoe' zijn).

Details van geadresseerdetype
RecipientTypeDetails string

Het type postvak dat moet worden gezocht. Als dit veld leeg blijft, worden alle typen postvakken opgenomen in de zoekopdracht.

Is geen resultaat een uitzondering
NoResultIsAnException boolean

Stel in op True om een uitzondering te genereren als er geen postvakken worden gevonden. Ingesteld op Onwaar om een telling van 0 te rapporteren als er geen postvakken worden gevonden. Houd er rekening mee dat de optie 'onwaar' mogelijk niet werkt wanneer deze wordt gebruikt met identiteit in niet-Engelse talen, dus overweeg in plaats daarvan te zoeken met behulp van filters.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

Een lijst met postvakken (en hun eigenschappen) die overeenkomen met de zoekidentiteit, in JSON-indeling.

Aantal gevonden postvakken
CountOfMailboxesFound integer

Het aantal postvakken dat overeenkomt met de zoekidentiteit. Meestal 1.

Office 365-postvak verwijderen uit alle distributiegroepen

Verwijder een postvak uit alle Microsoft Exchange Online- of Office 365-distributiegroepen of beveiligingsgroepen met e-mail waarvan het lid is.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
MailboxIdentity string

De identiteit van het postvak dat moet worden verwijderd uit alle distributiegroepen of beveiligingsgroepen waarvoor e-mail is ingeschakeld, is lid van het postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Controle van beveiligingsgroepbeheer overslaan
BypassSecurityGroupManagerCheck boolean

Als het IA-Connect Agent Automation-account geen eigenaar is van een distributiegroep of beveiligingsgroep met e-mail, kan het geen lid uit die groep verwijderen. Als u deze optie instelt op true (de standaardinstelling), wordt de controle van de eigenaar overgeslagen, maar moet het automation-account zich in de rollengroep Organisatiebeheer van Exchange bevinden of de rol Rolbeheer hebben toegewezen. Dit is één rol om u machtigingen te geven om een Office 355 Exchange Online-groep te wijzigen in plaats van een eigenaar te zijn van alle groepen die u moet wijzigen.

Uitzondering als groepen niet kunnen worden verwijderd
ExceptionIfAnyGroupsFailToRemove boolean

Als deze optie is ingesteld op true: er wordt een uitzondering (fout) gegenereerd als het postvak niet kan worden verwijderd uit een afzonderlijke groep (dat wil bijvoorbeeld 100% geslaagd is). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

Uitzondering als alle groepen niet kunnen worden verwijderd
ExceptionIfAllGroupsFailToRemove boolean

Als deze optie is ingesteld op true (de standaardinstelling): er wordt een uitzondering (fout) gegenereerd als het postvak niet kan worden verwijderd uit alle groepen (dat wil bijvoorbeeld geen successen en enkele fouten veroorzaken). Als er geen uitzondering wordt gegenereerd, wordt met deze actie gemeld hoeveel groepen zijn verwijderd en hoeveel groepen niet kunnen worden verwijderd.

Groep-DN's die moeten worden uitgesloten
GroupDNsToExcludeJSON string

Een lijst met DN's (Group Distinguished Names) die moeten worden uitgesloten van verwijdering, in JSON- of CSV-indeling. Bijvoorbeeld: [{"GroupDN": "Group DN 1"}, {"GroupName": "Group DN 2"}] (JSON table format), ["Group DN 1", "Group DN 2"] (JSON array format) of "Group DN 1","Group DN 2" (CSV-indeling).

Uitvoeren als thread
RunAsThread boolean

Als deze optie is ingesteld op onwaar, wordt de actie door de IA-Connect-agent onmiddellijk uitgevoerd en worden de resultaten geretourneerd wanneer de actie is voltooid, maar mislukt het als het langer duurt dan de time-out van de werkrol/RPA-opdracht. Als deze optie is ingesteld op true, voert de IA-Connect Agent deze actie uit als agentthread en controleert deze totdat deze is voltooid. Hierdoor kan de actie langer worden uitgevoerd dan de time-out van de werkrol/RPA-opdracht.

Uitvoergegevens ophalen voor thread-id
RetrieveOutputDataFromThreadId integer

Als u deze actie eerder hebt uitgevoerd als agentthread en 'Seconden om te wachten op thread' hebt ingesteld op 0, geeft u de agentthread-id op om de resultaten op te halen. Deze agentthread-id is verstrekt door de eerdere aanroep van deze actie. Ingesteld op 0 (de standaardinstelling) als u deze actie gewoon uitvoert (en daarom de resultaten van een eerder exemplaar van deze actie niet als agentthread ophalen).

Seconden om te wachten op thread
SecondsToWaitForThread integer

Als 'Uitvoeren als-thread' is ingesteld op waar, hoeveel seconden moet worden gewacht totdat de agentthread is voltooid. Als de agentthread waarop deze actie wordt uitgevoerd, deze keer niet is voltooid, wordt er een uitzondering gegenereerd. Ingesteld op 0 om de wachttijd te omzeilen: de agent blijft de actie uitvoeren, maar is ook beschikbaar voor de volgende actie. Vervolgens kunt u de actieresultaten op een later tijdstip ophalen met behulp van de actie Wachten tot agentthread is voltooid om te wachten totdat de agentthread is voltooid. Voer vervolgens de actie Office 365-postvak verwijderen uit alle distributiegroepen opnieuw uit, waarbij de invoer Uitvoergegevens voor thread-id ophalen is ingesteld op de thread-id van de agent.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
O365-groepen zijn verwijderd
O365GroupsRemovedSuccessfully integer

Het aantal O365-groepen waaruit het postvak is verwijderd.

Verwijderen van O365-groepen is mislukt
O365GroupsFailedToRemove integer

Het aantal O365-groepen waarvan het postvak niet kan worden verwijderd.

O365-groepen uitgesloten van verwijdering
O365GroupsExcludedFromRemoval integer

Het aantal O365-groepen dat is uitgesloten van verwijdering (d.w. komt overeen met een van de opgegeven groep-DN's die moeten worden uitgesloten).

Foutbericht O365-groepshoofd verwijderen
RemoveO365GroupsErrorMessage string

Als het postvak niet kan worden verwijderd uit sommige O365-groepen en er geen uitzondering is opgetreden, bevat dit foutbericht details van het probleem.

Thread-id
ThreadId integer

Als deze actie wordt uitgevoerd als een agentthread, bevat deze uitvoer de agentthread-id die kan worden gebruikt om de uitvoering van de actie te bewaken en de resultaten op te halen wanneer de actie is voltooid.

Office 365-postvakmachtiging toevoegen aan gebruiker

Wijs microsoft Exchange Online- of Office 365-postvakmachtigingen toe aan een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

User
User True string

De beveiligingsgroep postvakgebruiker, gebruiker of e-mail voor het ontvangen van de postvakmachtigingen. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Toegangsrechten
AccessRights True string

De toegangsrechten om toe te wijzen aan de machtigingen van de gebruiker voor het postvak. Beschikbare opties zijn 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' en 'ReadPermission'. Als u meerdere machtigingen wilt toewijzen, geeft u deze op als een door komma's gescheiden lijst.

Automatische toewijzing
AutoMapping boolean

Als deze optie is ingesteld op true, hebben het postvak en het gebruikersaccount een aantal extra eigenschappen ingesteld, waardoor het postvak automatisch wordt geopend wanneer deze gebruiker is aangemeld. Dit kan enkele minuten duren. Als deze optie is ingesteld op onwaar, worden de aanvullende eigenschappen niet ingesteld en wordt het postvak niet automatisch geopend.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365AddMailboxPermissionResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Office 365-postvakmachtiging verwijderen van gebruiker

Verwijder microsoft Exchange Online- of Office 365-postvakmachtigingen van een opgegeven postvakgebruiker, gebruiker of beveiligingsgroep.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

User
User True string

De beveiligingsgroep postvakgebruiker, gebruiker of e-mail die uit de postvakmachtigingen moet worden verwijderd. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Toegangsrechten
AccessRights True string

De toegangsrechten die moeten worden verwijderd uit de machtigingen van de gebruiker voor het postvak. Beschikbare opties zijn 'ChangeOwner', 'ChangePermission', 'DeleteItem', 'ExternalAccount', 'FullAccess' en 'ReadPermission'. Als u meerdere machtigingen wilt verwijderen, geeft u deze op als een door komma's gescheiden lijst.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
O365RemoveMailboxPermissionResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Office 365 PowerShell-script uitvoeren

Voert een PowerShell-script uit in de Office 365-runspace in de sessie waarop de IA-Connect Agent wordt uitgevoerd, waarbij de scriptinhoud wordt doorgegeven aan de IA-Connect Agent als onderdeel van de opdracht. Dit is de aanbevolen actie voor het uitvoeren van uw eigen aangepaste Office 365 Exchange Online PowerShell-code. Deze actie kan ook worden gebruikt om de resultaten op te halen van een eerdere uitvoering van een PowerShell-script, uitgevoerd als agentthread.

Parameters

Name Sleutel Vereist Type Description
Inhoud van PowerShell-script
PowerShellScriptContents string

De inhoud van het PowerShell-script dat moet worden uitgevoerd in de Office 365-runspace. IA-Connect voert dit script as-is uit door rechtstreeks door te geven aan de PowerShell-automatiseringsengine. Er wordt geen PowerShell-script op schijf gemaakt. U kunt ook een bestaand PowerShell-script op schijf uitvoeren door het volgende in te voeren: return & 'scriptpath'. Bijvoorbeeld: return &c:\scripts\O365TestScript.ps1'.

Treedt er geen fout op
IsNoResultAnError boolean

Als er geen gegevens worden geretourneerd door de PowerShell-opdracht, wordt er dan een fout voorgesteld?

Complexe typen retourneren
ReturnComplexTypes boolean

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met de invoer 'Eigenschappen die als verzameling moeten worden geretourneerd', 'Eigenschapsnamen om te serialiseren' en 'Eigenschapstypen die moeten worden geserialiseerd' kunt u opgeven welke 'complexe' eigenschappen moeten worden geretourneerd en de methode die wordt gebruikt om de gegevens op te maken (kies op basis van eigenschap per eigenschap het beste). Met deze invoer kunt u opgeven wat er moet worden gedaan met eventuele resterende eigenschappen (dat wil bijvoorbeeld eigenschappen die 'complex' zijn en niet expliciet worden genoemd). Als deze optie is ingesteld op true, probeert IA-Connect een tekenreeksweergave van de gegevens te retourneren met behulp van ToString(). Als deze optie is ingesteld op false (de standaardinstelling), retourneert IA-Connect de eigenschap niet.

Booleaanse waarde retourneren als booleaanse waarde
ReturnBooleanAsBoolean boolean

Moeten Booleaanse eigenschappen worden geretourneerd als booleaanse waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Numeriek als decimaal retourneren
ReturnNumericAsDecimal boolean

Moeten numerieke eigenschappen worden geretourneerd als numerieke waarden? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Retourdatum als datum
ReturnDateAsDate boolean

Moeten datumeigenschappen worden geretourneerd als datums? Als dit onwaar is, worden deze geretourneerd als tekenreeksen.

Eigenschappen die moeten worden geretourneerd als verzameling
PropertiesToReturnAsCollectionJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect moet proberen terug te keren als een verzameling. Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschapsnamen te serialiseren' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Deze invoer kan worden ingevoerd in JSON- of CSV-indeling. Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf-matrix wilt retourneren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Lokaal PowerShell-bereik
LocalScope boolean

Als de onderliggende Office 365 PowerShell-opdracht moet worden uitgevoerd in het lokale bereik. Dit is standaard niet ingesteld en daarom valt PowerShell terug op de standaardinstellingen.

Script uitvoeren als thread
RunScriptAsThread boolean

Als deze optie is ingesteld op onwaar (de standaardinstelling), wordt het PowerShell-script direct uitgevoerd door de IA-Connect Agent en worden de resultaten geretourneerd naar de directeur wanneer het script is voltooid. Als u een lang of complex PowerShell-script uitvoert, kan er een time-out optreden voor deze actie. Als dit is ingesteld op true, voert de IA-Connect Agent het PowerShell-script uit als agentthread en kan de IA-Connect Director (of Orchestrator, PowerShell-module, Blue Prism) de status van deze agentthread controleren, waarna deze is voltooid. Hierdoor kunnen lange of complexe PowerShell-scripts zonder time-outs worden uitgevoerd. IA-Connect Agents 9.3 en eerder kunnen PowerShell-scripts niet als agentthread worden uitgevoerd.

Uitvoergegevens ophalen voor thread-id
RetrieveOutputDataFromThreadId integer

Als u eerder een PowerShell-script als agentthread hebt uitgevoerd en 'Seconden om te wachten op thread' hebt ingesteld op 0, geeft u de agentthread-id op om de resultaten op te halen. Deze agentthread-id is verstrekt door de eerdere aanroep van deze actie. Ingesteld op 0 (de standaardinstelling) als u gewoon een PowerShell-script uitvoert (en daarom de resultaten van een vorige PowerShell-scriptuitvoering als agentthread niet ophalen).

Seconden om te wachten op thread
SecondsToWaitForThread integer

Als 'Script uitvoeren als thread' is ingesteld op waar, hoeveel seconden er moet worden gewacht totdat de agentthread is voltooid. Als de agentthread met het PowerShell-script op dit moment niet is voltooid, wordt er een uitzondering gegenereerd. Ingesteld op 0 om de wachttijd te omzeilen: de agent blijft het PowerShell-script uitvoeren, maar is ook beschikbaar voor de volgende actie. Vervolgens kunt u de scriptresultaten op een later tijdstip ophalen met behulp van de actie 'Wachten tot agentthread is voltooid' om te wachten totdat de agentthread is voltooid en voer vervolgens deze actie PowerShell-script uitvoeren opnieuw uit met de invoer Uitvoergegevens ophalen voor thread-id ingesteld op de agentthread-id.

Script bevat opgeslagen wachtwoord
ScriptContainsStoredPassword boolean

Ingesteld op true als het script een IA-Connect opgeslagen wachtwoord-id bevat, in de indeling {IAConnectPassword:StoredPasswordIdentifier} of een IA-Connect Orchestrator generic credential, in de indeling {OrchestratorCredential:FriendlyName}. De woordgroep { } wordt vervangen door het opgegeven wachtwoord, ontsnapt en tussen enkele aanhalingstekens geplaatst (tenzij deze al tussen aanhalingstekens in het script staat).

Uitgebreide uitvoer van logboek
LogVerboseOutput boolean

Ingesteld op waar om uitgebreide PowerShell-uitvoer in de IA-Connect-logboeken te registreren. Dit kan handig zijn voor foutopsporing. Als u uitgebreid wilt registreren in uw script, gebruikt u de volgende PowerShell: Write-Verbose 'Mijn bericht' -Uitgebreid.

Eigenschapsnamen die moeten worden geserialiseerd
PropertyNamesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (op naam) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapstypen om te serialiseren' te gebruiken (kies een). Als u bijvoorbeeld de eigenschappen EmailAddresses en MemberOf wilt serialiseren, voert u [{"PropertyName": "EmailAddresses"}, {"PropertyName": "MemberOf"}] (JSON-tabelindeling), ["EmailAddresses", "MemberOf"] (JSON-matrixindeling) of EmailAddresses, MemberOf (CSV-indeling) in.

Eigenschapstypen die moeten worden geserialiseerd
PropertyTypesToSerializeJSON string

Als de PowerShell-retourgegevens complexe eigenschappen bevatten (bijvoorbeeld verzamelingen waarden, matrices, tabellen of klassen), worden deze eigenschappen standaard niet geretourneerd in het IA-Connect PowerShell-antwoord. Met deze optie kunt u opgeven welke 'complexe' eigenschappen (per type) IA-Connect als JSON moeten serialiseren, zodat ze worden geretourneerd als een tekenreekstype (dat u kunt deserialiseren, eenmaal ontvangen). Afhankelijk van de eigenschap, het type en de waarden, moet u ook overwegen de alternatieve invoer 'Eigenschappen te retourneren als verzameling' en 'Eigenschapsnamen om te serialiseren' te gebruiken (kies een). Deze invoer is een verzameling met één eigenschapstypeveld. Bijvoorbeeld: Als u een eigenschap van het type Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] wilt serialiseren, voer [{"PropertyType": "Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"}] (JSON-tabelindeling), ["Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]"] (JSON-matrixindeling) of Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServiceInfoPlan[] (CSV-indeling) in.

Naam
Name string

De naam van de PowerShell-invoerparameter. Dit moet voldoen aan de naamgevingsindelingen van PowerShell-variabelen (dat wil gezegd worden aanbevolen om spaties of speciale symbolen te voorkomen). Namen van PowerShell-variabelen zijn niet hoofdlettergevoelig. Bijvoorbeeld: MyVariable resulteert in een variabele $MyVariable wordt gemaakt.

Tekenreekswaarde
StringValue string

De tekenreekswaarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een Booleaanse of numerieke waarde invoert.

Integerwaarde
IntValue integer

De waarde voor een geheel getal (geheel getal) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Booleaanse waarde
BooleanValue boolean

De booleaanse waarde (waar of onwaar) die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks of numerieke waarde invoert.

Decimale waarde
DecimalValue double

De decimale waarde die moet worden toegewezen aan de PowerShell-invoerparameter. U kunt ook gebruikmaken van de andere waardeinvoer als u een tekenreeks, booleaanse waarde of een geheel getal invoert.

Objectwaarde
ObjectValue object

De objectwaarde die moet worden toegewezen aan de PowerShell-invoerparameter. Dit wordt een met JSON geserialiseerde tekenreeksvariabele in het PowerShell-script, dus deserialiseren naar een object met behulp van ConvertFrom-Json. U kunt ook de andere waardeinvoer gebruiken als u een tekenreeks, booleaanse waarde of numerieke waarde invoert.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
PowerShell-uitvoer-JSON
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

Thread-id
ThreadId integer

Als het PowerShell-script wordt uitgevoerd als een agentthread, bevat deze uitvoer de agentthread-id die kan worden gebruikt om de uitvoering van het PowerShell-script te bewaken en de Resultaten van het PowerShell-script op te halen wanneer het script is voltooid.

Organisatie-eenheid van Active Directory toevoegen

Hiermee maakt u een nieuwe Organisatie-eenheid (OE) van Active Directory.

Parameters

Name Sleutel Vereist Type Description
Naam
Name True string

De naam van de Organisatie-eenheid van Active Directory. Dit wordt weergegeven in de structuur van de organisatie-eenheid in AD-gebruikers en -computers en boven aan het tabblad Algemeen (in de titel).

Path
Path string

De organisatie-eenheid (OE) waarin de nieuwe organisatie-eenheid moet worden opgeslagen in DN-naamindeling (bijvoorbeeld OE=Bovenliggende OE,OU=Londen,DC=lokaal), GUID-indeling of als pad (bijvoorbeeld Londen\Bovenliggende OE). Als dit leeg blijft, wordt de OE gemaakt in de hoofdmap van de structuur.

Description
Description string

De optionele OE-beschrijving.

Weergavenaam
DisplayName string

De optionele weergavenaam van de organisatie-eenheid. In tegenstelling tot gebruikersaccounts wordt een OE-weergavenaam niet weergegeven in AD-gebruikers en -computers.

Beheerd door
ManagedBy string

Hiermee geeft u de gebruiker of groep op die deze organisatie-eenheid beheert. U kunt deze invoer opgeven in DN-naamindeling (bijvoorbeeld CN=MrBig,OU=Londen,DC=mydomain,DC=local), GUID-indeling, SID of SAMAccountName (bijvoorbeeld 'MrBig').

Beveiligd tegen onbedoeld verwijderen
ProtectedFromAccidentalDeletion boolean

Ingesteld op true (standaard) om deze organisatie-eenheid te beschermen tegen onbedoeld verwijderen. Ingesteld op onwaar om de organisatie-eenheid onbeveiligd te laten tegen onbedoelde verwijdering.

Straatadres
StreetAddress string

De eigenschap 'Straat' van de organisatie-eenheid (op het tabblad Algemeen in AD-gebruikers en -computers).

City
City string

De eigenschap Plaats van de organisatie-eenheid (op het tabblad Algemeen in AD-gebruikers en -computers in de OE-eigenschappen).

Staat
State string

De eigenschap Staat/provincie van de organisatie-eenheid (op het tabblad Algemene eigenschappen in AD-gebruikers en -computers).

Postcode
PostalCode string

De eigenschap POSTCODE van de organisatie-eenheid (op het tabblad Algemeen in AD-gebruikers en -computers op het tabblad 'Algemeen').

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
PowerShell-uitvoer-JSON
PowerShellJSONOutput string

De uitvoer van het PowerShell-script, opgemaakt als JSON.

Gemaakte OE DN-naam
CreatedOUDistinguishedName string

De DN (Active Directory Distinguished Name) van de gemaakte organisatie-eenheid.

Organisatie-eenheid van Active Directory verwijderen

Hiermee verwijdert u een organisatie-eenheid (OE) uit Active Directory. De organisatie-eenheid kan niet worden verwijderd als er objecten zijn (bijvoorbeeld gebruikers, groepen of computers) in de organisatie-eenheid.

Parameters

Name Sleutel Vereist Type Description
OE-identiteit
OUIdentity True string

De identiteit van de Organisatie-eenheid van Active Directory. U kunt een OE opgeven op basis van DN-naam (bijvoorbeeld OU=Servers,OU=Londen,DC=mydomain,DC=local), GUID-indeling of als pad (bijvoorbeeld Londen\Servers).

Zelfs verwijderen als beveiligd
DeleteEvenIfProtected boolean

Ingesteld op True om de organisatie-eenheid te verwijderen, zelfs als deze is beveiligd tegen verwijdering. Ingesteld op onwaar om alleen de organisatie-eenheid te verwijderen als deze niet is beveiligd tegen verwijdering en een uitzondering te genereren als de organisatie-eenheid is beveiligd.

Uitzondering genereren als organisatie-eenheid niet bestaat
RaiseExceptionIfOUDoesNotExist boolean

Als deze optie is ingesteld op waar en de organisatie-eenheid niet bestaat, wordt er een uitzondering gegenereerd. Als deze optie is ingesteld op false en de organisatie-eenheid niet bestaat, rapporteert de actie geslaagd, maar de uitvoer rapporteert dat er geen OE's zijn verwijderd.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Aantal verwijderde OE's
NumberOfOUsDeleted integer

Deze uitvoer bevat het aantal AD OE's dat moet zijn verwijderd. Dit moet 0 of 1 zijn.

Roltoewijzingen voor Azure AD-gebruikersbeheerders ophalen

Retourneert een lijst met Azure Active Directory-beheerdersrollen waaraan de opgegeven gebruiker is toegewezen. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Namen van beheerdersrollen ophalen
RetrieveAdminRoleNames boolean

Als deze optie is ingesteld op true, haalt de IA-Connect Agent de namen van elke rol op naast de rol-id's. Dit duurt langer, maar biedt meer leesbare informatie. Als deze optie is ingesteld op false, haalt de IA-Connect-agent geen rolnamen op.

Toewijzings-id's retourneren
ReturnAssignmentIds boolean

Als deze optie is ingesteld op true, haalt de IA-Connect Agent de toewijzings-id's voor elke roltoewijzing op. Toewijzings-id's zijn alleen nodig als u een aantal aangepaste acties wilt uitvoeren op de roltoewijzing (in plaats van ingebouwde IA-Connect acties te gebruiken).

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON voor roltoewijzingen
PowerShellJSONOutput string

De lijst met Azure AD-beheerdersrollen waaraan de gebruiker is toegewezen, in JSON-indeling.

Aantal gevonden roltoewijzingen
CountOfRoleAssignmentsFound integer

Het aantal Azure AD-beheerdersrollen waaraan de gebruiker is toegewezen.

Serviceabonnementen voor Azure AD-gebruikerslicenties ophalen

Hiermee wordt een lijst opgehaald met licenties die zijn toegewezen aan een opgegeven Azure AD-gebruikerslicentie (SKU). Bijvoorbeeld: Als de gebruiker de FLOW_FREE licentie heeft toegewezen, kunt u hiermee bekijken welke serviceplannen ze hebben ingericht voor die licentie. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van welke is gebruikt om verbinding te maken met Azure.

Parameters

Name Sleutel Vereist Type Description
Gebruikersobject-id of UPN
ObjectId True string

De id van een Azure Active Directory-gebruiker. U kunt een gebruiker opgeven op basis van UPN (bijvoorbeeld user@mydomain.onmicrosoft.com) of ObjectId (bijvoorbeeld UUID/GUID-waarde).

Licentie-SKU-onderdeelnummer
LicenseSKUPartNumber True string

Het onderdeelnummer van de licentie-SKU. Bijvoorbeeld: FLOW_FREE of SPE_E3.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
SKU-serviceabonnementen voor gebruikerslicenties JSON
UserLicenseSKUServicePlansJSONOutput string

De lijst met serviceplannen die zijn toegewezen aan de opgegeven Azure AD-licentie-SKU die is toegewezen aan de gebruiker, in JSON-indeling.

Aantal serviceabonnementen voor licentie-SKU gevonden
CountOfUserLicenseSKUServicePlansFound integer

Het aantal Azure AD-serviceabonnementen dat is toegewezen aan de opgegeven licentie-SKU die aan de gebruiker is toegewezen.

Verbinding maken met Active Directory met referenties

Hiermee kunt u een alternatief account opgeven dat moet worden gebruikt bij het uitvoeren van Active Directory PowerShell-opdrachten. Dit is van invloed op alle Active Directory-opdrachten die na deze actie zijn uitgegeven. Als u deze actie niet gebruikt, worden alle Active Directory PowerShell-opdrachten uitgevoerd als het gebruikersaccount IA-Connect Agent wordt uitgevoerd zoals.

Parameters

Name Sleutel Vereist Type Description
Gebruikersnaam
Username True string

De gebruikersnaam van het account dat moet worden gebruikt bij het uitvoeren van Active Directory-opdrachten. U kunt een gebruikersnaam opgeven in de indeling DOMEIN\gebruikersnaam (bijvoorbeeld TESTDOMAIN\admin) of 'username@domainFQDN' (bijvoorbeeld admin@testdomain.local).

Wachtwoord
Password True password

Het wachtwoord van het account dat moet worden gebruikt bij het uitvoeren van Active Directory-opdrachten.

Externe computer
RemoteComputer string

De naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) of lidserver voor verificatie bij en voor alle Active Directory-acties die moeten worden doorgegeven aan. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen. Als er een lidserver is ingevoerd (in plaats van een domeincontroller), moet op die lidserver de Active Directory PowerShell-modules/RSAT zijn geïnstalleerd.

SSL gebruiken
UseSSL boolean

Ingesteld op true om verbinding te maken met het externe WSMan-eindpunt met behulp van SSL.

Alternatieve TCP-poort
AlternativeTCPPort integer

Ingesteld op een alternatieve TCP-poort als u de standaard-WSMan TCP/5985 (niet-SSL) of TCP/5986 (SSL) gebruikt.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
OpenActiveDirectoryPowerShellRunspaceWithCredentialsResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding maken met Azure AD met een certificaat

Verbindt IA-Connect met Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). Deze actie (of 'Verbinding maken met Azure AD met referenties') moet worden uitgegeven voordat u andere Azure AD-acties uitvoert. Voor deze actie moeten een Azure-service-principal en azure AD-app-registratie met certificaat worden ingesteld in Azure AD voordat deze werkt, maar heeft het voordeel dat MFA (2FA) niet vereist is. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph PowerShell-modules.

Parameters

Name Sleutel Vereist Type Description
Registratie-id van Azure AD-app
ApplicationId True string

De toepassings-id van de Azure AD-app-registratie die het certificaat bevat en de vereiste rollen in Azure AD heeft om de automatiseringsacties uit te voeren. Deze Azure AD-app-registratie moet eerder zijn ingesteld door een beheerder.

Vingerafdruk van certificaat
CertificateThumbprint True string

De vingerafdruk van het certificaat dat wordt gebruikt voor verificatie. Dit certificaat moet eerder zijn gemaakt en aanwezig zijn op zowel de computer waarop IA-Connect de automatiseringsacties uitvoert als in de registratie van de Azure AD-app.

Azure-tenant-id
TenantId True string

Azure Tenant-id waarmee u verbinding wilt maken. Dit moet worden opgegeven wanneer u certificaten gebruikt om te verifiëren.

API die moet worden gebruikt
APIToUse string

De API die moet worden gebruikt voor verbinding met Azure AD. Zodra deze is ingesteld, worden alle verdere Azure AD-opdrachten die zijn uitgegeven door IA-Connect deze API gebruikt. Als deze optie is ingesteld op automatisch (de standaardinstelling), worden de geïnstalleerde PowerShell-modules gescand en geselecteerd in de volgende volgorde: Microsoft Graph Users PowerShell-module, Azure AD v2 PowerShell-module. De PowerShell-module van Azure AD v2 is afgeschaft op 30 maart 2024 en wordt daarom aanbevolen om de PowerShell-module Microsoft Graph Users te gebruiken.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
OpenAzureADv2PowerShellRunspaceWithCertificateResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding maken met Azure AD met referenties

Verbindt IA-Connect met Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). Deze actie (of 'Verbinding maken met Azure AD met certificaat') moet worden uitgegeven voordat u andere Azure AD-acties uitvoert. Voor deze actie is een account vereist dat geen gebruik maakt van MFA (2FA) of dat u de UI-automatiseringsmodule moet gebruiken om het 2FA-onderdeel te automatiseren (bijvoorbeeld het pop-upvenster voor eenmalige wachtwoordverificatie). U kunt ook de actie Verbinding maken met Azure AD met een certificaat gebruiken. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules.

Parameters

Name Sleutel Vereist Type Description
Gebruikersnaam
Username True string

De gebruikersnaam van het account dat moet worden gebruikt bij het uitvoeren van Azure AD v2 PowerShell-opdrachten.

Wachtwoord
Password True password

Het wachtwoord van het account dat moet worden gebruikt bij het uitvoeren van PowerShell-opdrachten van Azure AD v2.

Azure-tenant-id
TenantId string

De optionele Azure-tenant-id waarmee u verbinding wilt maken. Als dit leeg blijft, wordt de standaardtenant gebruikt die is gekoppeld aan het opgegeven gebruikersaccount.

API die moet worden gebruikt
APIToUse string

De API die moet worden gebruikt voor verbinding met Azure AD. Zodra deze is ingesteld, worden alle verdere Azure AD-opdrachten die zijn uitgegeven door IA-Connect deze API gebruikt. Als deze optie is ingesteld op automatisch (de standaardinstelling), worden de geïnstalleerde PowerShell-modules gescand en geselecteerd in de volgende volgorde: Microsoft Graph Users PowerShell-module, Azure AD v2 PowerShell-module. De PowerShell-module van Azure AD v2 is afgeschaft op 30 maart 2024 en wordt daarom aanbevolen om de PowerShell-module Microsoft Graph Users te gebruiken.

Verificatiebereik
AuthenticationScope string

Het bereik van de vereiste machtigingen voor het uitvoeren van alle automatiseringstaken in deze Azure AD-aanmeldingssessie. Standaard vraagt IA-Connect een machtigingsbereik aan om het wijzigen van gebruikers, groepen en licentietoewijzingen toe te staan. Deze instelling wordt alleen gebruikt wanneer u verbinding maakt met behulp van de PowerShell-module microsoft Graph-gebruikers.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
OpenAzureADv2PowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding maken met het standaard Active Directory-domein

Hiermee wordt de IA-Connect-agent verbonden met het domein waarvan de computer waarop de IA-Connect Agent wordt uitgevoerd, lid is van het account waarvan de IA-Connect Agent wordt uitgevoerd (bijvoorbeeld het standaardgedrag).

Parameters

Name Sleutel Vereist Type Description
Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
OpenLocalPassthroughActiveDirectoryPowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding maken met JML-omgeving

Maak verbinding met een JML-omgeving waarin de details van die omgeving worden bewaard in de IA-Connect Orchestrator. Deze details kunnen referenties, adressen en andere connectiviteitsinstellingen bevatten. U kunt deze actie bijvoorbeeld gebruiken om verbinding te maken met Active Directory, Microsoft Exchange, Azure AD of Office 365 Exchange Online.

Parameters

Name Sleutel Vereist Type Description
Vriendelijke naam
FriendlyName string

Beschrijvende naam van de JML-omgeving in de IA-Connect Orchestrator.

Alleen verbinding maken als deze nog niet is verbonden
OnlyConnectIfNotAlreadyConnected boolean

Alleen van toepassing op Exchange en Office 365 Exchange Online. Als deze optie is ingesteld op onwaar: met deze actie wordt altijd verbinding gemaakt met Exchange of Office 365 Exchange Online, zelfs als IA-Connect al is verbonden. Als deze optie is ingesteld op true (de standaardinstelling): Als IA-Connect al is verbonden met Exchange of Office 365 Exchange Online met identieke instellingen en de Exchange-verbinding reageert, doet IA-Connect niets omdat de verbinding al tot stand is gebracht.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
JMLConnectToJMLEnvironmentResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding maken met Microsoft Exchange

Hiermee wordt IA-Connect verbonden met een Microsoft Exchange-server. Deze actie moet worden uitgegeven voordat andere Exchange-acties worden uitgevoerd. Als u een gebruikersnaam en wachtwoord opgeeft, worden alle volgende Exchange-acties uitgevoerd als dat account. Als u geen gebruikersnaam en wachtwoord opgeeft, worden alle volgende Exchange-acties uitgevoerd als het gebruikersaccount waarop de IA-Connect Agent wordt uitgevoerd.

Parameters

Name Sleutel Vereist Type Description
Gebruikersnaam
Username string

De gebruikersnaam van het account dat moet worden gebruikt bij het uitvoeren van Exchange PowerShell-opdrachten. U kunt een gebruikersnaam opgeven in de indeling DOMEIN\gebruikersnaam (bijvoorbeeld TESTDOMAIN\admin) of 'username@domainFQDN' (bijvoorbeeld admin@testdomain.local). Als u geen gebruikersnaam en wachtwoord opgeeft, worden alle volgende Exchange-acties uitgevoerd als het gebruikersaccount waarop de IA-Connect Agent wordt uitgevoerd.

Wachtwoord
Password password

Het wachtwoord van het account dat moet worden gebruikt bij het uitvoeren van Exchange PowerShell-opdrachten.

FQDN van Exchange-server
ExchangeServerFQDN True string

De FQDN (Fully Qualified Domain Name) of hostnaam van de Microsoft Exchange-server.

SSL gebruiken
UseSSL boolean

Ingesteld op waar als u verbinding wilt maken met de Microsoft Exchange-server met behulp van HTTPS/SSL. Hiermee wordt al het verkeer versleuteld, maar werkt alleen als de Exchange-server is ingesteld om PowerShell-opdrachten via SSL te accepteren.

Verbindingsmethode
ConnectionMethod string

Welke methode moet worden gebruikt om verbinding te maken met Microsoft Exchange. Lokaal importeert de externe Exchange-runspace lokaal en voert opdrachten lokaal uit. Remote wordt rechtstreeks uitgevoerd in de externe Exchange-runspace en kan mogelijk geen algemene PowerShell-scripts uitvoeren vanwege beveiligingsbeperkingen.

Authenticatiemechanisme
AuthenticationMechanism string

Het verificatiemechanisme dat moet worden gebruikt als u verbinding maakt met een externe computer of het script uitvoert als een alternatieve gebruiker. Ondersteunde waarden zijn 'Basic', 'Credssp', 'Default', 'Digest', 'Kerberos' en 'Negotiate'.

Alleen verbinding maken als deze nog niet is verbonden
OnlyConnectIfNotAlreadyConnected boolean

Als deze optie is ingesteld op false: met deze actie wordt altijd verbinding gemaakt met Exchange, zelfs als IA-Connect al is verbonden. Als deze optie is ingesteld op true (de standaardinstelling): Als IA-Connect al is verbonden met Exchange met identieke instellingen en de Exchange-verbinding reageert, doet IA-Connect niets omdat de verbinding al tot stand is gebracht.

Opdrachttypen om lokaal te importeren
CommandTypesToImportLocally string

Met de verbindingsmethode Lokaal importeert u Exchange PowerShell-opdrachten lokaal. Met deze optie kunt u kiezen welke PowerShell-opdrachten moeten worden geïmporteerd. Door deze lijst tot een minimum te beperken, vermindert u zowel het geheugengebruik als de tijd om verbinding te maken. Met 'All' (de standaardinstelling voor compatibiliteit met eerdere versies) worden alle PS-opdrachten geïmporteerd. 'alleenIA-Connect' (de aanbevolen optie) importeert alleen PS-opdrachten die worden gebruikt door IA-Connect (u kunt extra PS-opdrachten opgeven). Met 'Opgegeven' importeert u alleen PS-opdrachten die u opgeeft en kunnen sommige IA-Connect acties worden verbroken als ze afhankelijk zijn van PS-opdrachten die u niet hebt opgegeven.

Aanvullende opdrachten om lokaal te importeren
AdditionalCommandsToImportLocallyCSV string

Als u de verbindingsmethode 'Lokaal' gebruikt en als u ervoor hebt gekozen om 'IA-Connect alleen' of 'opgegeven' PS-opdrachten te importeren, kunt u een door komma's gescheiden lijst met extra PS-opdrachten opgeven die moeten worden geïmporteerd. Bijvoorbeeld: 'Get-Mailbox,New-Mailbox,New-DistributionGroup'.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
OpenExchangePowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding maken met Office 365 met een certificaat

Verbindt IA-Connect met Office 365 met behulp van de Office 365 PowerShell-modules. Deze actie (of 'Verbinding maken met Office 365 met referenties') moet worden uitgegeven voordat u andere Office 365-acties uitvoert. Voor deze actie is een Azure AD-app-registratie met certificaat vereist en moeten de juiste rollen worden ingesteld in Azure AD voordat deze werkt, maar heeft het voordeel dat MFA (2FA) niet vereist is.

Parameters

Name Sleutel Vereist Type Description
Toepassings-id voor azure AD-app-registratie
ApplicationId True string

De toepassings-id van de Azure AD-app-registratie die het certificaat bevat en de vereiste rollen in Azure AD heeft om de automatiseringsacties uit te voeren. Deze Azure AD-app-registratie moet eerder zijn ingesteld door een beheerder.

Vingerafdruk van certificaat
CertificateThumbprint True string

De vingerafdruk van het certificaat dat wordt gebruikt voor verificatie. Dit certificaat moet eerder zijn gemaakt en aanwezig zijn op zowel de computer waarop IA-Connect de automatiseringsacties uitvoert als in de registratie van de Azure AD-app.

Organisatie
Organization True string

De organisatie die voor verificatie moet worden gebruikt. Bijvoorbeeld: mytestenvironment.onmicrosoft.com.

Exchange-URL
ExchangeURL string

De optionele URL van de Microsoft Exchange Online-server waarmee u verbinding wilt maken. Gebruik dit alleen als u een aangepaste URL hebt.

Verbindingsmethode
ConnectionMethod string

Welke methode moet worden gebruikt om verbinding te maken met Microsoft Exchange. EXO V1 is de oorspronkelijke Microsoft Exchange Online PowerShell en biedt geen ondersteuning voor certificaten (en is daarom niet beschikbaar als optie). EXO V2 maakt gebruik van de nieuwere Microsoft Exchange Online PowerShell v2-module die wordt uitgevoerd op de computer waarop de IA-Connect Agent wordt uitgevoerd en vereist dat de PowerShell-module 'ExchangeOnlineManagement' v2 is geïnstalleerd.

Alleen verbinding maken als deze nog niet is verbonden
OnlyConnectIfNotAlreadyConnected boolean

Als deze optie is ingesteld op false: met deze actie wordt altijd verbinding gemaakt met Office 365 Exchange Online, zelfs als IA-Connect al is verbonden. Als deze optie is ingesteld op true (de standaardinstelling): als IA-Connect al is verbonden met Office 365 Exchange Online met identieke instellingen en de Office 365 Exchange Online-verbinding reageert, doet IA-Connect niets omdat de verbinding al tot stand is gebracht.

Opdrachttypen om lokaal te importeren
CommandTypesToImportLocally string

Met de 'EXO V2'-verbindingsmethode (vereist voor certificaatverificatie) worden Office 365- of Exchange Online PowerShell-opdrachten lokaal geïmporteerd. Met deze optie kunt u kiezen welke PowerShell-opdrachten moeten worden geïmporteerd. Door deze lijst tot een minimum te beperken, vermindert u zowel het geheugengebruik als de tijd om verbinding te maken. Met 'All' (de standaardinstelling voor compatibiliteit met eerdere versies) worden alle PS-opdrachten geïmporteerd. 'alleenIA-Connect' (de aanbevolen optie) importeert alleen PS-opdrachten die worden gebruikt door IA-Connect (u kunt extra PS-opdrachten opgeven). Met 'Opgegeven' importeert u alleen PS-opdrachten die u opgeeft en kunnen sommige IA-Connect acties worden verbroken als ze afhankelijk zijn van PS-opdrachten die u niet hebt opgegeven.

Aanvullende opdrachten om lokaal te importeren
AdditionalCommandsToImportLocallyCSV string

Als u ervoor hebt gekozen om 'alleenIA-Connect' of 'Opgegeven' PS-opdrachten te importeren, kunt u een door komma's gescheiden lijst met extra PS-opdrachten opgeven die moeten worden geïmporteerd. Bijvoorbeeld: 'Get-Mailbox,New-Mailbox,New-DistributionGroup'.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
OpenO365PowerShellRunspaceWithCertificateResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding maken met Office 365 met referenties

Verbindt IA-Connect met Office 365 met behulp van de Office 365 PowerShell-modules. Deze actie (of 'Verbinding maken met Office 365 met certificaat') moet worden uitgegeven voordat andere Office 365-acties worden uitgevoerd. Voor deze actie is een account vereist waarvoor MFA (2FA) niet is vereist, of u moet de UI-automatiseringsmodule gebruiken om het 2FA-onderdeel te automatiseren (bijvoorbeeld het pop-upvenster voor eenmalige wachtwoordverificatie). U kunt ook de actie Verbinding maken met Office 365 met een certificaat gebruiken.

Parameters

Name Sleutel Vereist Type Description
Gebruikersnaam
Office365Username True string

De gebruikersnaam van het account dat moet worden gebruikt bij het uitvoeren van Office 365 PowerShell-opdrachten.

Wachtwoord
Office365Password True password

Het wachtwoord van het account dat moet worden gebruikt bij het uitvoeren van Office 365 PowerShell-opdrachten.

Exchange-URL
ExchangeURL string

De optionele URL van de Microsoft Exchange Online-server waarmee u verbinding wilt maken. Gebruik dit alleen als u een aangepaste URL hebt.

Verbindingsmethode
ConnectionMethod string

Welke methode moet worden gebruikt om verbinding te maken met Microsoft Exchange. Zowel 'EXO V1 local' als 'EXO V1 remote' gebruiken de oorspronkelijke Microsoft Exchange Online PowerShell, die wordt uitgevoerd op de computer waarop de IA-Connect Agent wordt uitgevoerd en geen extra PowerShell-modules nodig heeft, maar uiteindelijk wordt afgeschaft. Exo V1 lokaal importeert de externe Exchange-runspace lokaal en voert opdrachten lokaal uit. Exo V1 remote wordt rechtstreeks uitgevoerd in de externe Exchange-runspace en kan geen algemene PowerShell-scripts uitvoeren vanwege beveiligingsbeperkingen. EXO V2 maakt gebruik van de nieuwere Microsoft Exchange Online PowerShell v2-module die wordt uitgevoerd op de computer waarop de IA-Connect Agent wordt uitgevoerd en vereist dat de PowerShell-module 'ExchangeOnlineManagement' v2 is geïnstalleerd.

Alleen verbinding maken als deze nog niet is verbonden
OnlyConnectIfNotAlreadyConnected boolean

Als deze optie is ingesteld op false: met deze actie wordt altijd verbinding gemaakt met Office 365 Exchange Online, zelfs als IA-Connect al is verbonden. Als deze optie is ingesteld op true (de standaardinstelling): als IA-Connect al is verbonden met Office 365 Exchange Online met identieke instellingen en de Office 365 Exchange Online-verbinding reageert, doet IA-Connect niets omdat de verbinding al tot stand is gebracht.

Opdrachttypen om lokaal te importeren
CommandTypesToImportLocally string

Met de verbindingsmethoden EXO v1 en EXO V2 worden Office 365- of Exchange Online PowerShell-opdrachten lokaal geïmporteerd. Met deze optie kunt u kiezen welke PowerShell-opdrachten moeten worden geïmporteerd. Door deze lijst tot een minimum te beperken, vermindert u zowel het geheugengebruik als de tijd om verbinding te maken. Met 'All' (de standaardinstelling voor compatibiliteit met eerdere versies) worden alle PS-opdrachten geïmporteerd. 'alleenIA-Connect' (de aanbevolen optie) importeert alleen PS-opdrachten die worden gebruikt door IA-Connect (u kunt extra PS-opdrachten opgeven). Met 'Opgegeven' importeert u alleen PS-opdrachten die u opgeeft en kunnen sommige IA-Connect acties worden verbroken als ze afhankelijk zijn van PS-opdrachten die u niet hebt opgegeven.

Aanvullende opdrachten om lokaal te importeren
AdditionalCommandsToImportLocallyCSV string

Als u de verbindingsmethoden EXO v1 local of EXO V2 gebruikt en als u ervoor hebt gekozen om alleenIA-Connect of opgegeven PS-opdrachten te importeren, kunt u een door komma's gescheiden lijst met extra PS-opdrachten opgeven die moeten worden geïmporteerd. Bijvoorbeeld: 'Get-Mailbox,New-Mailbox,New-DistributionGroup'.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
OpenO365PowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding met Active Directory verbreken

Als u de actie Active Directory PowerShell-runspace openen met referenties hebt gebruikt om Active Directory PowerShell-opdrachten uit te voeren als een alternatief gebruikersaccount of een alternatief domein, retourneert deze actie de IA-Connect-agent naar het standaardgedrag van het uitvoeren van Active Directory-acties als het gebruikersaccount waarop de IA-Connect Agent wordt uitgevoerd.

Parameters

Name Sleutel Vereist Type Description
Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
CloseActiveDirectoryPowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding met Azure AD verbreken

Verbreekt IA-Connect van Azure Active Directory (ook wel Bekend als Microsoft Entra ID, Azure AD of AAD). U kunt azure AD-acties pas opnieuw uitgeven nadat u opnieuw verbinding hebt gemaakt. Deze actie maakt gebruik van Azure AD v2- of Microsoft Graph Users PowerShell-modules, afhankelijk van wat oorspronkelijk is gebruikt om verbinding te maken.

Parameters

Name Sleutel Vereist Type Description
Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
CloseAzureADv2PowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding met Microsoft Exchange verbreken

Hiermee wordt IA-Connect van een Microsoft Exchange-server verbroken (verbonden met behulp van de actie Verbinding maken met Microsoft Exchange). U kunt microsoft Exchange PowerShell-acties pas opnieuw uitgeven nadat u opnieuw verbinding hebt gemaakt.

Parameters

Name Sleutel Vereist Type Description
Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
CloseExchangePowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verbinding verbreken met Office 365

Hiermee wordt IA-Connect van Office 365 verbroken met behulp van de Office 365 PowerShell-modules (verbonden met de actie Verbinding maken met Office 365). U kunt office 365 PowerShell-acties pas opnieuw uitgeven nadat u opnieuw verbinding hebt gemaakt.

Parameters

Name Sleutel Vereist Type Description
Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
CloseO365PowerShellRunspaceResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Verlooptijd van Active Directory-gebruikersaccount wissen

Hiermee wist u de vervaldatum voor een Active Directory-account.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectoryClearADUserAccountExpirationResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Vervaldatum van Active Directory-gebruikersaccount instellen

Hiermee stelt u de vervaldatum van het account in voor een Active Directory-gebruikersaccount. Dit is de laatste volledige dag waarin het account bruikbaar is, dus technisch verloopt het account aan het begin van de volgende dag. De IA-Connect-agent is hiervan op de hoogte en voegt automatisch 1 dag toe aan de opgegeven invoerdatum bij het opslaan van de datum in Active Directory.

Parameters

Name Sleutel Vereist Type Description
Gebruikersidentiteit
UserIdentity True string

De identiteit van de Active Directory-gebruiker. U kunt een gebruiker opgeven op Distinguished Name (bijvoorbeeld CN=User1,OU=My Users,DC=mydomain,DC=local), GUID, SID, SAMAccountName /pre-2K name (bijvoorbeeld 'Gebruiker1') of Naam (bijvoorbeeld 'Gebruiker1').

Jaar
Year True integer

Het jaar dat het account moet verlopen. Bijvoorbeeld: 2023.

Maand
Month True integer

Het nummer van de maand dat het account moet verlopen. Januari = 1, december = 12. Bijvoorbeeld: 6.

Day
Day True integer

Het nummer van de dag waarop het account moet verlopen. Eerste dag van de maand = 1. Bijvoorbeeld: 19.

AD-server
ADServer string

De optionele naam of FQDN (Fully Qualified Domain Name) van een Active Directory-domeincontroller (DC) om contact op te nemen om de aangevraagde actie uit te voeren. Als dit veld leeg blijft, wordt de Active Directory-domeincontroller (DC) automatisch bepaald met behulp van site-instellingen.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
Opdrachtresultaat
ActiveDirectorySetADUserAccountExpirationEndOfDateResult boolean

Het resultaat van de opdracht (geslaagd of mislukt).

Foutmelding
ErrorMessage string

Als de opdracht niet is geslaagd, bevat dit het foutbericht dat is geretourneerd.

Wachten op een Office 365-postvak

Wacht tot een opgegeven Microsoft Exchange Online- of Office 365-postvak bestaat. Dit is gebruikelijk als u wacht totdat een AD-synchronisatie of licentie-instelling van kracht wordt. Als het postvak al bestaat, wordt de actie onmiddellijk geretourneerd.

Parameters

Name Sleutel Vereist Type Description
Postvakidentiteit
Identity True string

De id van een Microsoft Exchange Online- of Office 365-postvak. U kunt een postvak opgeven op naam, alias, object-id (bijvoorbeeld UUID/GUID-waarde), e-mailadres, GUID, SAMAccountName (zelfs gebruikers in niet-Active Directory-verbonden omgevingen hebben een SAMAccountName) of UPN (User Principal Name).

Details van geadresseerdetype
RecipientTypeDetails string

Het type postvak dat moet worden gezocht. Als dit veld leeg blijft, worden alle typen postvakken opgenomen in de zoekopdracht.

Aantal keren dat moet worden gecontroleerd
NumberOfTimesToCheck True integer

Het aantal keren dat moet worden gecontroleerd of het postvak bestaat. Elke controle wordt gescheiden door een configureerbare hoeveelheid tijd.

Seconden tussen pogingen
SecondsBetweenTries True integer

Hoeveel seconden er moet worden gewacht tussen elke controle.

Werkproces
Workflow True string

Voeg hier de volgende expressie toe: workflow()

Retouren

Name Pad Type Description
JSON met zoekresultaten
PowerShellJSONOutput string

De eigenschappen van het gevonden postvak als het al bestond of bestond na het wachten, in JSON-indeling.

Aantal gevonden postvakken
CountOfMailboxesFound integer

Het aantal postvakken dat overeenkomt met de zoekidentiteit. 1 vertegenwoordigt een geslaagde wachttijd (of het postvak bestaat al). 0 vertegenwoordigt het postvak dat niet bestaat, zelfs na het wachten.