New-MsolUser
Skapar en användare till Azure Active Directory.
Syntax
New-MsolUser
[-ImmutableId <String>]
[-UserPrincipalName <String>]
[-BlockCredential <Boolean>]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DisplayName <String>]
[-Fax <String>]
[-FirstName <String>]
[-LastName <String>]
[-LastPasswordChangeTimestamp <DateTime>]
[-MobilePhone <String>]
[-Office <String>]
[-PasswordNeverExpires <Boolean>]
[-PhoneNumber <String>]
[-PostalCode <String>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SoftDeletionTimestamp <DateTime>]
[-State <String>]
[-StreetAddress <String>]
[-StrongPasswordRequired <Boolean>]
[-Title <String>]
[-UsageLocation <String>]
[-AlternateEmailAddresses <String[]>]
[-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
[-AlternateMobilePhones <String[]>]
[-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
[-StsRefreshTokensValidFrom <DateTime>]
[-UserType <UserType>]
[-Password <String>]
[-LicenseOptions <LicenseOption[]>]
[-ForceChangePassword <Boolean>]
[-LicenseAssignment <String[]>]
[-TenantId <Guid>]
[<CommonParameters>] Description
Cmdleten New-MsolUser skapar en användare i Azure Active Directory. För att ge användaren åtkomst till tjänster tilldelar du en licens med hjälp av parametern LicenseAssignment .
Exempel
Exempel 1: Skapa en användare
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"Det här kommandot skapar en användare. Användaren har inga tilldelade licenser. Ett slumpmässigt lösenord genereras för användaren.
Exempel 2: Skapa en användare och tilldela en licens
Anteckning
Parametern -LicenseAssignment är inaktuell. Lär dig hur du tilldelar licenser med Microsoft Graph PowerShell. Mer information finns i Assign License Microsoft Graph API ( Tilldela licens för Microsoft Graph API).
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"Det här kommandot skapar en ny användare och tilldelar en licens.
Exempel 3: Skapa en användare och en önskad dataplats
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"Det här kommandot skapar en användare vars huvudnamn är jdavidchew@contoso.onmicrosoft.com, visningsnamnet är David och önskad dataplats är EUR.
Parametrar
-AlternateEmailAddresses
Anger alternativa e-postadresser för användaren.
| Typ: | String[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-AlternateMobilePhones
Anger alternativa mobiltelefonnummer för användaren.
| Typ: | String[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-BlockCredential
Anger om användaren inte kan logga in med sitt användar-ID.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | $false |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-City
Anger användarens stad.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Country
Anger användarens land eller region.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Department
Anger användarens avdelning.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-DisplayName
Anger användarens visningsnamn.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Fax
Anger användarens faxnummer.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-FirstName
Anger användarens förnamn.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ForceChangePassword
Anger att användaren måste ändra sitt lösenord nästa gång de loggar in.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | $true |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-ImmutableId
Anger det oföränderliga ID:t för användarens federerade identitet. Detta bör utelämnas för användare med standardidentiteter.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-LastName
Anger användarens efternamn.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-LastPasswordChangeTimestamp
Anger en tidpunkt då lösenordet senast ändrades.
| Typ: | DateTime |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-LicenseAssignment
Anger en matris med licenser för att tilldela användaren.
Anteckning
Parametern -LicenseAssignment är inaktuell. Lär dig hur du tilldelar licenser med Microsoft Graph PowerShell. Mer information finns i Assign License Microsoft Graph API ( Tilldela licens för Microsoft Graph API).
| Typ: | String[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-LicenseOptions
Anger alternativen för licenstilldelning. Används för att selektivt inaktivera enskilda tjänstplaner inom en SKU.
| Typ: | LicenseOption[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-MobilePhone
Anger användarens mobiltelefonnummer.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Office
Anger användarens kontor.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Password
Anger det nya lösenordet för användaren. Om användaren är inställd på att kräva ett starkt lösenord måste alla följande regler uppfyllas:
- Lösenordet måste innehålla minst en gemen
- Lösenordet måste innehålla minst en versal
- Lösenordet måste innehålla minst ett icke-alfanumeriskt tecken
- Lösenordet får inte innehålla blanksteg, flikar eller radbrytningar
- Lösenordets längd måste vara 8–16 tecken
- Användarnamnet kan inte finnas i lösenordet
Om det här värdet utelämnas tilldelas användaren ett slumpmässigt lösenord.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-PasswordNeverExpires
Anger om användarlösenordet upphör att gälla med jämna mellanrum.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | $false |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-PhoneNumber
Anger användarens telefonnummer.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-PostalCode
Anger användarens postnummer.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-PreferredDataLocation
Anger önskad dataplats för användaren.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-PreferredLanguage
Anger användarens föredragna språk.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-SoftDeletionTimestamp
Anger en tid för mjuk borttagning.
| Typ: | DateTime |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-State
Anger den delstat eller provins där användaren finns.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-StreetAddress
Anger användarens gatuadress.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-StrongAuthenticationMethods
Anger en matris med starka autentiseringsmetoder.
| Typ: | StrongAuthenticationMethod[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-StrongAuthenticationRequirements
Anger en matris med starka autentiseringskrav.
| Typ: | StrongAuthenticationRequirement[] |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-StrongPasswordRequired
Anger om du vill kräva ett starkt lösenord för användaren.
| Typ: | Boolean |
| Position: | Named |
| Standardvärde: | $true |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-StsRefreshTokensValidFrom
Anger ett StsRefreshTokensValidFrom-värde.
| Typ: | DateTime |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-TenantId
Anger det unika ID:t för den klientorganisation som åtgärden ska utföras på. Standardvärdet är den aktuella användarens klientorganisation. Den här parametern gäller endast för partneranvändare.
| Typ: | Guid |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-Title
Anger användarens rubrik.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-UsageLocation
Anger platsen för den användare där tjänsterna används. Ange en lands- eller regionkod med två bokstäver.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-UserPrincipalName
Anger användar-ID för den här användaren. Detta krävs.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-UserType
Anger användartypen.
| Typ: | UserType |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
Utdata
Microsoft.Online.Administration.User
Den här cmdleten returnerar information om den nya användaren som skapades, inklusive deras tillfälliga lösenord.