New-AzADUser

Nieuwe entiteit toevoegen aan gebruikers

Syntax

New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   -Password <SecureString>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   [-ForceChangePasswordNextLogin]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   -PasswordProfile <IMicrosoftGraphPasswordProfile>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Nieuwe entiteit toevoegen aan gebruikers

Voorbeelden

Voorbeeld 1: Gebruiker maken met wachtwoordprofiel

$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Gebruiker maken met wachtwoordprofiel

Voorbeeld 2: Gebruiker maken met wachtwoord

$password = "xxxxxxxxxx"
$password = ConvertTo-SecureString -AsPlainText -Force $password
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Gebruiker maken met wachtwoord

Parameters

-AboutMe

Een invoerveld voor vrije vorm voor de gebruiker om zichzelf te beschrijven. Alleen geretourneerd op $select.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountEnabled

waar voor het inschakelen van het account; anders, onwaar.

Type:Boolean
Aliases:EnableAccount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AgeGroup

Hiermee stelt u de leeftijdsgroep van de gebruiker in. Toegestane waarden: null, minor, notAdult en volwassenen. Raadpleeg de definities van eigenschappen voor juridische leeftijdsgroepen voor meer informatie. Ondersteunt $filter (eq, ne, NOT en in).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Birthday

De verjaardag van de gebruiker. Het tijdstempeltype vertegenwoordigt datum- en tijdgegevens met iso 8601-indeling en bevindt zich altijd in UTC-tijd. Bijvoorbeeld: middernacht UTC op 1 januari 2014 is 2014-01-01T00:00:00Z alleen geretourneerd op $select.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-City

De plaats waarin de gebruiker zich bevindt. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

De bedrijfsnaam waaraan de gebruiker is gekoppeld. Deze eigenschap kan handig zijn voor het beschrijven van het bedrijf waaruit een externe gebruiker afkomstig is. De maximale lengte van de bedrijfsnaam is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsentProvidedForMinor

Hiermee stelt u in of er toestemming is verkregen voor minderjarigen. Toegestane waarden: null, verleend, geweigerd en notRequired. Raadpleeg de definities van eigenschappen voor juridische leeftijdsgroepen voor meer informatie. Ondersteunt $filter (eq, ne, NOT en in).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Het land/de regio waarin de gebruiker zich bevindt; Bijvoorbeeld VS of VK. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:PSObject
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeletedDateTime

.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

De naam voor de afdeling waarin de gebruiker werkt. De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le en in operators).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceEnrollmentLimit

De limiet voor het maximum aantal apparaten dat de gebruiker mag inschrijven. Toegestane waarden zijn 5 of 1000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

De naam die wordt weergegeven in het adresboek voor de gebruiker. Deze waarde is meestal de combinatie van de voornaam, de eerste en achternaam van de gebruiker. Deze eigenschap is vereist wanneer een gebruiker wordt gemaakt en deze niet kan worden gewist tijdens updates. De maximale lengte is 256 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy en $search.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-EmployeeHireDate

De datum en tijd waarop de gebruiker is ingehuurd of zal aan het werk gaan in het geval van een toekomstige inhuur. Ondersteunt $filter (eq, ne, NOT, ge, le, in).

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EmployeeId

De werknemer-id die door de organisatie aan de gebruiker is toegewezen. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EmployeeType

Legt het ondernemingswerkroltype vast. Bijvoorbeeld werknemer, aannemer, consultant of leverancier. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExternalUserState

Voor een externe gebruiker die is uitgenodigd voor de tenant met behulp van de uitnodigings-API, vertegenwoordigt deze eigenschap de status van de uitnodiging van de uitgenodigde gebruiker. Voor uitgenodigde gebruikers kan de status PendingAcceptance of Accepted of null zijn voor alle andere gebruikers. Ondersteunt $filter (eq, ne, NOT , in).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExternalUserStateChangeDateTime

Geeft de tijdstempel weer voor de meest recente wijziging in de eigenschap externalUserState. Ondersteunt $filter (eq, ne, NOT , in).

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FaxNumber

Het faxnummer van de gebruiker. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceChangePasswordNextLogin

Deze moet worden opgegeven als de gebruiker het wachtwoord moet wijzigen bij de volgende geslaagde aanmelding (waar). Standaardgedrag is (onwaar) om het wachtwoord niet te wijzigen bij de volgende geslaagde aanmelding.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

De opgegeven naam (voornaam) van de gebruiker. De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HireDate

De huurdatum van de gebruiker. Het tijdstempeltype vertegenwoordigt datum- en tijdgegevens met iso 8601-indeling en bevindt zich altijd in UTC-tijd. Bijvoorbeeld: middernacht UTC op 1 januari 2014 is 2014-01-01T00:00:00Z. Alleen geretourneerd op $select. Opmerking: deze eigenschap is specifiek voor SharePoint Online. We raden u aan de eigenschap native employeeHireDate te gebruiken om waarden voor huurdatums in te stellen en bij te werken met behulp van Microsoft Graph-API's.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImmutableId

Deze eigenschap wordt gebruikt om een on-premises Active Directory-gebruikersaccount te koppelen aan hun Azure AD-gebruikersobject. Deze eigenschap moet worden opgegeven bij het maken van een nieuw gebruikersaccount in Graph als u een federatief domein gebruikt voor de upn-eigenschap userPrincipalName (UPN). OPMERKING: de tekens $ en _ kunnen niet worden gebruikt bij het opgeven van deze eigenschap. Alleen geretourneerd op $select. Ondersteunt $filter (eq, ne, NOT, ge, le, in)..

Type:String
Aliases:OnPremisesImmutableId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Interest

Een lijst voor de gebruiker om hun interesses te beschrijven. Alleen geretourneerd op $select.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsResourceAccount

Niet gebruiken - gereserveerd voor toekomstig gebruik.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

De functie van de gebruiker. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mail

Het SMTP-adres voor de gebruiker, bijvoorbeeld admin@contoso.com. Wijzigingen in deze eigenschap werken ook de proxyAddresses-verzameling van de gebruiker bij om de waarde als SMTP-adres op te nemen. Hoewel deze eigenschap accenttekens kan bevatten, kan het gebruik ervan toegangsproblemen veroorzaken met andere Microsoft-toepassingen voor de gebruiker. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailNickname

De e-mailalias voor de gebruiker. Deze eigenschap moet worden opgegeven wanneer een gebruiker wordt gemaakt. De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MobilePhone

Het primaire mobiele telefoonnummer voor de gebruiker. Alleen-lezen voor gebruikers die zijn gesynchroniseerd vanuit een on-premises directory. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MySite

De URL voor de persoonlijke site van de gebruiker. Alleen geretourneerd op $select.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OfficeLocation

De kantoorlocatie in de bedrijfslocatie van de gebruiker. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OtherMail

Een lijst met extra e-mailadressen voor de gebruiker; bijvoorbeeld: ['bob@contoso.com', 'Robert@fabrikam.com']. OPMERKING: Hoewel deze eigenschap accenttekens kan bevatten, kunnen ze toegangsproblemen veroorzaken voor toepassingen van derden voor de gebruiker. Ondersteunt $filter (eq, NOT, ge, le, in, startsWith).

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

Het wachtwoord voor de gebruiker. Deze moet voldoen aan de vereisten voor wachtwoordcomplexiteit van de tenant. Het wordt aanbevolen om een sterk wachtwoord in te stellen.

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PasswordPolicy

Hiermee geeft u wachtwoordbeleid voor de gebruiker. Deze waarde is een opsomming met één mogelijke waarde die DisableStrongPassword is, waardoor zwakkere wachtwoorden kunnen worden opgegeven dan het standaardbeleid. DisablePasswordExpiration kan ook worden opgegeven. De twee kunnen samen worden opgegeven; bijvoorbeeld: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordProfile

passwordProfile Zie de sectie NOTES voor de eigenschappen PASSWORDPROFILE en maak een hash-tabel.

Type:IMicrosoftGraphPasswordProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

De postcode voor het postadres van de gebruiker. De postcode is specifiek voor het land/de regio van de gebruiker. In het Verenigde Staten van Amerika bevat dit kenmerk de postcode. De maximale lengte is 40 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

De voorkeurstaal voor de gebruiker. Moet de ISO 639-1-code volgen; bijvoorbeeld en-US. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredName

De voorkeursnaam voor de gebruiker. Alleen geretourneerd op $select.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Responsibility

Een lijst voor de gebruiker om hun verantwoordelijkheden op te sommen. Alleen geretourneerd op $select.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-School

Een lijst voor de gebruiker om de scholen op te sommen die ze hebben bezocht. Alleen geretourneerd op $select.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

waar als de algemene adreslijst van Outlook deze gebruiker moet bevatten, anders onwaar. Als deze niet is ingesteld, wordt dit behandeld als waar. Voor gebruikers die zijn uitgenodigd via de uitnodigingsmanager, wordt deze eigenschap ingesteld op false. Ondersteunt $filter (eq, ne, NOT, in).

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Skill

Een lijst voor de gebruiker om hun vaardigheden te inventariseren. Alleen geretourneerd op $select.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

De staat of provincie in het adres van de gebruiker. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Het adres van de locatie van de gebruiker. De maximumlengte is 1024 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Surname

De achternaam van de gebruiker (familienaam of achternaam). De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Een landcode van twee letters (ISO-standaard 3166). Vereist voor gebruikers waaraan licenties worden toegewezen vanwege wettelijke vereisten om te controleren op beschikbaarheid van services in landen. Voorbeelden zijn: VS, JP en GB. Niet nullable. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

De UPN (user Principal name) van de gebruiker. De UPN is een aanmeldingsnaam in internetstijl voor de gebruiker op basis van de internetstandaard RFC 822. Dit moet standaard worden toegewezen aan de e-mailnaam van de gebruiker. De algemene indeling is alias@domain, waarbij het domein aanwezig moet zijn in de verzameling geverifieerde domeinen van de tenant. Deze eigenschap is vereist wanneer een gebruiker wordt gemaakt. De geverifieerde domeinen voor de tenant kunnen worden geopend vanuit de eigenschap verifiedDomains van de organisatie. OPMERKING: Hoewel deze eigenschap accenttekens kan bevatten, kunnen ze toegangsproblemen veroorzaken voor toepassingen van derden voor de gebruiker. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) en $orderBy.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserType

Een tekenreekswaarde die kan worden gebruikt om gebruikerstypen in uw directory te classificeren, zoals Lid en Gast. Ondersteunt $filter (eq, ne, NOT, in,).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Uitvoerwaarden

IMicrosoftGraphUser

Notities

ALIASSEN

EIGENSCHAPPEN VAN COMPLEXE PARAMETERS

Als u de hieronder beschreven parameters wilt maken, maakt u een hash-tabel met de juiste eigenschappen. Voer Get-Help-about_Hash_Tables uit voor informatie over hashtabellen.

PASSWORDPROFILE <IMicrosoftGraphPasswordProfile>: passwordProfile

  • [(Any) <Object>]: Hiermee wordt aangegeven dat een eigenschap aan dit object kan worden toegevoegd.
  • [ForceChangePasswordNextSignIn <Boolean?>]: waar als de gebruiker haar wachtwoord moet wijzigen bij de volgende aanmelding; anders onwaar. Als dit niet is ingesteld, is de standaardwaarde onwaar. OPMERKING: Voor Azure B2C-tenants stelt u deze in op onwaar en gebruikt u in plaats daarvan aangepaste beleidsregels en gebruikersstromen om het opnieuw instellen van wachtwoorden af te dwingen bij de eerste aanmelding. Zie Wachtwoord opnieuw instellen bij de eerste aanmelding afdwingen.
  • [ForceChangePasswordNextSignInWithMfa <Boolean?>]: Indien waar, moet de gebruiker bij de volgende aanmelding een meervoudige verificatie (MFA) uitvoeren voordat hij wordt gedwongen om het wachtwoord te wijzigen. Het gedrag is identiek aan forceChangePasswordNextSignIn, behalve dat de gebruiker eerst een meervoudige verificatie moet uitvoeren voordat het wachtwoord wordt gewijzigd. Na een wachtwoordwijziging wordt deze eigenschap automatisch opnieuw ingesteld op false. Als dit niet is ingesteld, is de standaardwaarde onwaar.
  • [Password <String>]: het wachtwoord voor de gebruiker. Deze eigenschap is vereist wanneer een gebruiker wordt gemaakt. Deze kan worden bijgewerkt, maar de gebruiker moet het wachtwoord wijzigen bij de volgende aanmelding. Het wachtwoord moet voldoen aan minimale vereisten zoals opgegeven door de eigenschap passwordPolicies van de gebruiker. Standaard is een sterk wachtwoord vereist.