New-AzADUser

Kullanıcılara yeni varlık ekler

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

Kullanıcılara yeni varlık ekler

Örnekler

Örnek 1: Parola profiliyle kullanıcı oluşturma

$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

Parola profiliyle kullanıcı oluşturma

Örnek 2: Parola ile kullanıcı oluşturma

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

Parolayla kullanıcı oluşturma

Parametreler

-AboutMe

Kullanıcının kendisini tanımlaması için serbest biçimli bir metin girişi alanı. Yalnızca $select döndürülür.

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

-AccountEnabled

hesabı etkinleştirmek için true; aksi takdirde false.

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

-AgeGroup

Kullanıcının yaş grubunu ayarlar. İzin verilen değerler: null, minor, notAdult ve adult. Daha fazla bilgi için yasal yaş grubu özellik tanımlarına bakın. $filter (eq, ne, NOT ve in) destekler.

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

-Birthday

Kullanıcının doğum günü. Zaman damgası türü, ISO 8601 biçimini kullanan tarih ve saat bilgilerini temsil eder ve her zaman UTC saatindedir. Örneğin, 1 Ocak 2014'te utc gece yarısı 2014-01-01T00:00:00Z yalnızca $select tarihinde döndürülür.

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

-City

Kullanıcının bulunduğu şehir. Uzunluk üst sınırı 128 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-CompanyName

Kullanıcının ilişkili olduğu şirket adı. Bu özellik, bir dış kullanıcının geldiği şirketi tanımlamak için yararlı olabilir. Şirket adının uzunluğu üst sınırı 64 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-ConsentProvidedForMinor

Reşit olmayanlar için onay alınıp alınmayacağını ayarlar. İzin verilen değerler: null, verildi, reddedildi ve notRequired. Daha fazla bilgi için yasal yaş grubu özellik tanımlarına bakın. $filter (eq, ne, NOT ve in) destekler.

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

-Country

Kullanıcının bulunduğu ülke/bölge; örneğin, ABD veya Birleşik Krallık. Uzunluk üst sınırı 128 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

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

Kullanıcının çalıştığı bölümün adı. Uzunluk üst sınırı 64 karakterdir. $filter (eq, ne, NOT, ge, le ve in işleçleri) destekler.

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

-DeviceEnrollmentLimit

Kullanıcının kaydetmesine izin verilen en fazla cihaz sayısı sınırı. İzin verilen değerler 5 veya 1000'tir.

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

-DisplayName

Kullanıcının adres defterinde görüntülenen ad. Bu değer genellikle kullanıcının adı, ikinci adı ve soyadının birleşimidir. Bu özellik, bir kullanıcı oluşturulduğunda gereklidir ve güncelleştirmeler sırasında temizlenemez. Uzunluk üst sınırı 256 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy ve $search destekler.

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

-EmployeeHireDate

Kullanıcının işe alındığı veya gelecekteki bir işe alım durumunda çalışmaya başlayacağı tarih ve saat. $filter (eq, ne, NOT, ge, le, in) destekler.

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

-EmployeeId

Kuruluş tarafından kullanıcıya atanan çalışan tanımlayıcısı. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-EmployeeType

Kurumsal çalışan türünü yakalar. Örneğin, Çalışan, Yüklenici, Danışman veya Satıcı. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-ExternalUserState

Davet API'sini kullanarak kiracıya davet edilen dış kullanıcı için bu özellik davet edilen kullanıcının davet durumunu temsil eder. Davet edilen kullanıcılar için durum PendingAcceptance veya Accepted veya diğer tüm kullanıcılar için null olabilir. $filter (eq, ne, NOT , in) destekler.

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

-ExternalUserStateChangeDateTime

externalUserState özelliğinde yapılan en son değişikliğin zaman damgasını gösterir. $filter (eq, ne, NOT , in) destekler.

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

-FaxNumber

Kullanıcının faks numarası. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-ForceChangePasswordNextLogin

Kullanıcının sonraki başarılı oturum açma işleminde (true) parolayı değiştirmesi gerekiyorsa belirtilmelidir. Bir sonraki başarılı oturum açma işleminde parolayı değiştirmemek için varsayılan davranış (false) olur.

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

-GivenName

Kullanıcının verilen adı (ad). Uzunluk üst sınırı 64 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-HireDate

Kullanıcının işe alma tarihi. Zaman damgası türü, ISO 8601 biçimini kullanan tarih ve saat bilgilerini temsil eder ve her zaman UTC saatindedir. Örneğin, 1 Ocak 2014'te utc gece yarısı 2014-01-01T00:00:00Z şeklindedir. Yalnızca $select döndürülür. Not: Bu özellik SharePoint Online'a özgüdür. Microsoft Graph API'lerini kullanarak işe alma tarihi değerlerini ayarlamak ve güncelleştirmek için yerel employeeHireDate özelliğini kullanmanızı öneririz.

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

-ImmutableId

Bu özellik, bir şirket içi Active Directory kullanıcı hesabını Microsoft Entra kullanıcı nesnesiyle ilişkilendirmek için kullanılır. Kullanıcının userPrincipalName (UPN) özelliği için federasyon etki alanı kullanıyorsanız Graph'te yeni bir kullanıcı hesabı oluşturulurken bu özellik belirtilmelidir. NOT: Bu özellik belirtilirken $ ve _ karakterleri kullanılamaz. Yalnızca $select döndürülür. $filter (eq, ne, NOT, ge, le, in) destekler.

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

-Interest

Kullanıcının ilgi alanlarını tanımlaması için bir liste. Yalnızca $select döndürülür.

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

-IsResourceAccount

Kullanmayın - gelecekte kullanmak üzere ayrılmıştır.

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

-JobTitle

Kullanıcının iş unvanı. Uzunluk üst sınırı 128 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-Mail

Kullanıcının SMTP adresi, örneğin, admin@contoso.com. Bu özellikte yapılan değişiklikler, kullanıcının proxyAddresses koleksiyonunu da değeri SMTP adresi olarak içerecek şekilde güncelleştirir. Bu özellik aksan karakterleri içeresine karşın, bunları kullanmak kullanıcı için diğer Microsoft uygulamalarıyla ilgili erişim sorunlarına neden olabilir. $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) destekler.

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

-MailNickname

Kullanıcının posta diğer adı. Bir kullanıcı oluşturulduğunda bu özellik belirtilmelidir. Uzunluk üst sınırı 64 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-MobilePhone

Kullanıcının birincil cep telefonu numarası. Şirket içi dizinden eşitlenen kullanıcılar için salt okunur. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-MySite

Kullanıcının kişisel sitesinin URL'si. Yalnızca $select döndürülür.

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

-OfficeLocation

Kullanıcının iş yerindeki ofis konumu. Uzunluk üst sınırı 128 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-OtherMail

Kullanıcı için ek e-posta adreslerinin listesi; örneğin: [''bob@contoso.com, 'Robert@fabrikam.com']. NOT: Bu özellik aksan karakterleri içeresine karşın, kullanıcı için birinci taraf uygulamalara erişim sorunlarına neden olabilir. $filter (eq, NOT, ge, le, in, startsWith) destekler.

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

-Password

Kullanıcının parolası. Kiracının parola karmaşıklığı gereksinimlerini karşılaması gerekir. Güçlü bir parola ayarlamanız önerilir.

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

-PasswordPolicy

Kullanıcı için parola ilkelerini belirtir. Bu değer, varsayılan ilkeden daha zayıf parolaların belirtilmesine izin veren DisableStrongPassword olası bir değere sahip bir numaralandırmadır. DisablePasswordExpiration da belirtilebilir. İkisi birlikte belirtilebilir; örneğin: 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 Oluşturmak için PASSWORDPROFILE özellikleri için NOTES bölümüne bakın ve karma tablo oluşturun.

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

-PostalCode

Kullanıcının posta adresinin posta kodu. Posta kodu kullanıcının ülkesine/bölgesine özgüdür. Amerika'nın Birleşik Devletler bu öznitelik posta kodunu içerir. Uzunluk üst sınırı 40 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-PreferredLanguage

Kullanıcı için tercih edilen dil. ISO 639-1 Koduna uygun olmalıdır; örneğin en-US. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-PreferredName

Kullanıcı için tercih edilen ad. Yalnızca $select döndürülür.

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

-Responsibility

Kullanıcının sorumluluklarını listelemesi için bir liste. Yalnızca $select döndürülür.

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

-School

Kullanıcının katıldığı okulları listelemesi için bir liste. Yalnızca $select döndürülür.

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

-ShowInAddressList

Outlook genel adres listesinin bu kullanıcıyı içermesi gerekiyorsa true, aksi takdirde false. Ayarlanmadıysa, bu true olarak değerlendirilir. Davet yöneticisi aracılığıyla davet edilen kullanıcılar için bu özellik false olarak ayarlanır. $filter (eq, ne, NOT, in) destekler.

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

-Skill

Kullanıcının becerilerini numaralandırması için bir liste. Yalnızca $select döndürülür.

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

-State

Kullanıcının adresindeki eyalet veya bölge. Uzunluk üst sınırı 128 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-StreetAddress

Kullanıcının iş yerinin sokak adresi. Uzunluk üst sınırı 1024 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-Surname

Kullanıcının soyadı (aile adı veya soyadı). Uzunluk üst sınırı 64 karakterdir. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-UsageLocation

İki harfli ülke kodu (ISO standardı 3166). Ülkelerde hizmetlerin kullanılabilirliğini denetlemek için yasal gereklilik nedeniyle lisans atanacak kullanıcılar için gereklidir. Örnekler şunlardır: US, JP ve GB. Boş değer atanamaz. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

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

-UserPrincipalName

Kullanıcının kullanıcı asıl adı (UPN). UPN, İnternet standardı RFC 822'yi temel alan kullanıcı için İnternet stili bir oturum açma adıdır. Kural gereği bu, kullanıcının e-posta adıyla eşlenmelidir. Genel biçim, etki alanının kiracının doğrulanmış etki alanları koleksiyonunda mevcut olması gereken alias@domain. Bu özellik, bir kullanıcı oluşturulduğunda gereklidir. Kiracı için doğrulanmış etki alanlarına kuruluşun verifiedDomains özelliğinden erişilebilir. NOT: Bu özellik aksan karakterleri içeresine karşın, kullanıcı için birinci taraf uygulamalara erişim sorunlarına neden olabilir. $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) ve $orderBy destekler.

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

-UserType

Dizininizdeki Üye ve Konuk gibi kullanıcı türlerini sınıflandırmak için kullanılabilecek bir dize değeri. $filter destekler (eq, ne, NOT, in,).

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Çıkışlar

IMicrosoftGraphUser

Notlar

TAKMA

KARMAŞıK PARAMETRE ÖZELLIKLERI

Aşağıda açıklanan parametreleri oluşturmak için uygun özellikleri içeren bir karma tablo oluşturun. Karma tablolar hakkında bilgi için Get-Help about_Hash_Tables komutunu çalıştırın.

PASSWORDPROFILE <IMicrosoftGraphPasswordProfile>: passwordProfile

  • [(Any) <Object>]: Bu, bu nesneye herhangi bir özelliğin eklenebileceğini gösterir.
  • [ForceChangePasswordNextSignIn <Boolean?>]: Kullanıcının bir sonraki oturum açmada parolasını değiştirmesi gerekiyorsa true; aksi takdirde false. Ayarlanmadıysa, varsayılan değer false olur. NOT: Azure B2C kiracıları için false olarak ayarlayın ve bunun yerine ilk oturum açmada parola sıfırlamayı zorlamak için özel ilkeler ve kullanıcı akışları kullanın. Bkz. İlk oturum açmada parola sıfırlamayı zorlama.
  • [ForceChangePasswordNextSignInWithMfa <Boolean?>]: Doğruysa, bir sonraki oturum açmada kullanıcının parolasını değiştirmeye zorlanmadan önce çok faktörlü kimlik doğrulaması (MFA) gerçekleştirmesi gerekir. Davranış forceChangePasswordNextSignIn ile aynıdır, ancak parola değişikliğinden önce kullanıcının çok faktörlü kimlik doğrulaması gerçekleştirmesi gerekir. Parola değişikliği yaptıktan sonra bu özellik otomatik olarak false olarak sıfırlanır. Ayarlanmadıysa, varsayılan değer false olur.
  • [Password <String>]: Kullanıcının parolası. Bu özellik, bir kullanıcı oluşturulduğunda gereklidir. Güncelleştirilebilir, ancak kullanıcının bir sonraki oturum açmada parolayı değiştirmesi gerekir. Parola, kullanıcının passwordPolicies özelliği tarafından belirtilen en düşük gereksinimleri karşılamalıdır. Varsayılan olarak güçlü bir parola gerekir.