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 Tilldela Licens 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.

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

-AlternateMobilePhones

Anger alternativa mobiltelefonnummer för användaren.

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

-BlockCredential

Anger om användaren inte kan logga in med sitt användar-ID.

Type:Boolean
Position:Named
Default value:$false
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-City

Anger användarens stad.

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

-Country

Anger användarens land eller region.

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

-Department

Anger användarens avdelning.

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

-DisplayName

Anger användarens visningsnamn.

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

-Fax

Anger användarens faxnummer.

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

-FirstName

Anger förnamnet på användaren.

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

-ForceChangePassword

Anger att användaren måste ändra sitt lösenord nästa gång de loggar in.

Type:Boolean
Position:Named
Default value:$true
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-LastName

Anger användarens efternamn.

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

-LastPasswordChangeTimestamp

Anger en tidpunkt då lösenordet senast ändrades.

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

-LicenseAssignment

Anger en matris med licenser som användaren ska tilldelas.

Anteckning

Parametern -LicenseAssignment är inaktuell. Lär dig hur du tilldelar licenser med Microsoft Graph PowerShell. Mer information finns i Tilldela Licens Microsoft Graph API.

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

-LicenseOptions

Anger alternativen för licenstilldelning. Används för att selektivt inaktivera enskilda tjänstplaner inom en SKU.

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

-MobilePhone

Anger användarens mobiltelefonnummer.

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

-Office

Anger användarens kontor.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 bokstav
  • Lösenordet måste innehålla minst en versal bokstav
  • 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.

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

-PasswordNeverExpires

Anger om användarlösenordet upphör att gälla regelbundet.

Type:Boolean
Position:Named
Default value:$false
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PhoneNumber

Anger användarens telefonnummer.

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

-PostalCode

Anger postnumret för användaren.

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

-PreferredDataLocation

Anger önskad dataplats för användaren.

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

-PreferredLanguage

Anger användarens önskade språk.

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

-SoftDeletionTimestamp

Anger en tid för mjuk borttagning.

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

-State

Anger den delstat eller provins där användaren finns.

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

-StreetAddress

Anger gatuadressen för användaren.

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

-StrongAuthenticationMethods

Anger en matris med starka autentiseringsmetoder.

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

-StrongAuthenticationRequirements

Anger en matris med starka autentiseringskrav.

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

-StrongPasswordRequired

Anger om du vill kräva ett starkt lösenord för användaren.

Type:Boolean
Position:Named
Default value:$true
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StsRefreshTokensValidFrom

Anger värdet StsRefreshTokensValidFrom.

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

-TenantId

Anger det unika ID för klientorganisationen 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.

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

-Title

Anger användarens rubrik.

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

-UsageLocation

Anger platsen för den användare där tjänster används. Ange en lands- eller regionkod med två bokstäver.

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

-UserPrincipalName

Anger användar-ID för den här användaren. Detta krävs.

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

-UserType

Anger användartypen.

Type:UserType
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.