New-MsolUser
Tworzy użytkownika w usłudze Azure Active Directory.
Składnia
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>] Opis
Polecenie cmdlet New-MsolUser tworzy użytkownika w usłudze Azure Active Directory. Aby przyznać użytkownikowi dostęp do usług, przypisz licencję przy użyciu parametru LicenseAssignment .
Przykłady
Przykład 1. Tworzenie użytkownika
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"To polecenie tworzy użytkownika. Użytkownik nie ma przypisanych żadnych licencji. Dla użytkownika jest generowane losowe hasło.
Przykład 2. Tworzenie użytkownika i przypisywanie licencji
Uwaga
Parametr -LicenseAssignment jest przestarzały. Dowiedz się , jak przypisywać licencje za pomocą programu Microsoft Graph PowerShell. Aby uzyskać więcej informacji, zobacz Przypisywanie licencji interfejsu API programu Microsoft Graph.
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"To polecenie tworzy nowego użytkownika i przypisuje licencję.
Przykład 3. Tworzenie użytkownika i preferowanej lokalizacji danych
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"To polecenie tworzy użytkownika, którego główna nazwa użytkownika to jdavidchew@contoso.onmicrosoft.com, nazwa wyświetlana to David, a preferowana lokalizacja danych to EUR.
Parametry
-AlternateEmailAddresses
Określa alternatywne adresy e-mail użytkownika.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-AlternateMobilePhones
Określa alternatywne numery telefonów komórkowych dla użytkownika.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-BlockCredential
Określa, czy użytkownik nie może zalogować się przy użyciu identyfikatora użytkownika.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | $false |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-City
Określa miasto użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Country
Określa kraj lub region użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Department
Określa dział użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisplayName
Określa nazwę wyświetlaną użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Fax
Określa numer faksu użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-FirstName
Określa imię użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ForceChangePassword
Wskazuje, że użytkownik musi zmienić swoje hasło przy następnym logowaniu.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | $true |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ImmutableId
Określa niezmienny identyfikator tożsamości federacyjnej użytkownika. Powinno to zostać pominięte dla użytkowników ze standardowymi tożsamościami.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-LastName
Określa nazwisko użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-LastPasswordChangeTimestamp
Określa godzinę ostatniej zmiany hasła.
| Typ: | DateTime |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-LicenseAssignment
Określa tablicę licencji, aby przypisać użytkownika.
Uwaga
Parametr -LicenseAssignment jest przestarzały. Dowiedz się , jak przypisywać licencje za pomocą programu Microsoft Graph PowerShell. Aby uzyskać więcej informacji, zobacz Przypisywanie licencji interfejsu API programu Microsoft Graph.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-LicenseOptions
Określa opcje przypisywania licencji. Służy do selektywnego wyłączania poszczególnych planów usług w ramach jednostki SKU.
| Typ: | LicenseOption[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-MobilePhone
Określa numer telefonu komórkowego użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Office
Określa biuro użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Password
Określa nowe hasło użytkownika. Jeśli użytkownik jest ustawiony tak, aby wymagał silnego hasła, muszą zostać spełnione wszystkie następujące reguły:
- Hasło musi zawierać co najmniej jedną małą literę
- Hasło musi zawierać co najmniej jedną wielką literę
- Hasło musi zawierać co najmniej jeden znak inny niż alfanumeryczny
- Hasło nie może zawierać spacji, kart ani podziałów wierszy
- Długość hasła musi wynosić od 8 do 16 znaków
- Nazwa użytkownika nie może być zawarta w haśle
Jeśli ta wartość zostanie pominięta, do użytkownika zostanie przypisane losowe hasło.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PasswordNeverExpires
Określa, czy hasło użytkownika wygasa okresowo.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | $false |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PhoneNumber
Określa numer telefonu użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PostalCode
Określa kod pocztowy użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PreferredDataLocation
Określa preferowaną lokalizację danych dla użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-PreferredLanguage
Określa preferowany język użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-SoftDeletionTimestamp
Określa czas usuwania nietrwałego.
| Typ: | DateTime |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-State
Określa stan lub prowincję, w której znajduje się użytkownik.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-StreetAddress
Określa adres ulicy użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-StrongAuthenticationMethods
Określa tablicę metod silnego uwierzytelniania.
| Typ: | StrongAuthenticationMethod[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-StrongAuthenticationRequirements
Określa tablicę wymagań dotyczących silnego uwierzytelniania.
| Typ: | StrongAuthenticationRequirement[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-StrongPasswordRequired
Określa, czy należy wymagać silnego hasła dla użytkownika.
| Typ: | Boolean |
| Position: | Named |
| Domyślna wartość: | $true |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-StsRefreshTokensValidFrom
Określa wartość StsRefreshTokensValidFrom.
| Typ: | DateTime |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-TenantId
Określa unikatowy identyfikator dzierżawy, w której ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr ma zastosowanie tylko do użytkowników partnerów.
| Typ: | Guid |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Title
Określa tytuł użytkownika.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-UsageLocation
Określa lokalizację użytkownika, w którym są używane usługi. Określ dwuliterowy kod kraju lub regionu.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-UserPrincipalName
Określa identyfikator użytkownika dla tego użytkownika. Jest to wymagane.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-UserType
Określa typ użytkownika.
| Typ: | UserType |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
Microsoft.Online.Administration.User
To polecenie cmdlet zwraca szczegółowe informacje o nowym użytkowniku, który został utworzony, w tym o jego tymczasowym haśle.