Hızlı Başlangıç: PowerShell ile konuk kullanıcı ekleme

Şunlar için geçerlidir: İş gücü kiracıları Dış kiracılar (daha fazla bilgi edinin)

Microsoft Entra B2B işbirliğiyle uygulamalarınıza ve hizmetlerinize dış iş ortaklarını davet etmenin birçok yolu vardır. Önceki hızlı başlangıçta, doğrudan Microsoft Entra yönetim merkezinde konuk kullanıcıların nasıl ekleneceğini gördünüz. Birer birer veya toplu olarak konuk kullanıcılar eklemek için de PowerShell’i kullanabilirsiniz. Bu hızlı başlangıçta, Microsoft Entra kiracınıza bir konuk kullanıcı eklemek için New-MgInvitation komutunu kullanacaksınız.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

Bu hızlı başlangıçtaki senaryoyu tamamlamak için şunları yapmanız gerekir:

• Kiracı dizininizde en az Konuk Davet Eden rolü veya Kullanıcı Yöneticisi gibi kullanıcılar oluşturmanıza olanak tanıyan bir rol.
• Microsoft Graph Kimlik Oturum Açma modülünü (Microsoft.Graph.Identity.SignIns) ve Microsoft Graph Kullanıcıları modülünü (Microsoft.Graph.Users) yükleyin. Gerekli PowerShell modülleri karşılanmadığı sürece betiğin çalıştırılmasını önlemek için deyimini kullanabilirsiniz #Requires .

#Requires -Modules Microsoft.Graph.Identity.SignIns, Microsoft.Graph.Users

• Bir test e-posta hesabı alın. Daveti gönderebileceğiniz bir test e-posta hesabı olması gerekir. Hesap, kuruluşunuzun dışından olmalıdır. Gmail.com veya outlook.com adresi gibi sosyal hesapları içeren herhangi bir hesap türü kullanabilirsiniz.

Kiracınızda oturum açma

Kiracı etki alanına bağlanmak için aşağıdaki komutu çalıştırın:

Connect-MgGraph -Scopes 'User.ReadWrite.All'

İstendiğinde, kimlik bilgilerinizi girin.

Davet gönderme

1. Test e-posta hesabınıza davet göndermek için aşağıdaki PowerShell komutunu çalıştırın ("Henry Ross" henry@contoso.com yerine test e-posta hesabınızın adını ve e-posta adresini yazın):

   New-MgInvitation -InvitedUserDisplayName "Henry Ross" -InvitedUserEmailAddress henry@contoso.com -InviteRedirectUrl "https://myapplications.microsoft.com" -SendInvitationMessage:$true
   

2. Komut, belirtilen e-posta adresine bir davet gönderir. Çıktıyı denetleyin ve aşağıdaki örneğe benzer görünmelidir:

   Id                                   InviteRedeemUrl                                                                                                   
   --                                   ---------------                                                                                                   
   00aa00aa-bb11-cc22-dd33-44ee44ee44ee https://login.microsoftonline.com/redeem?...
   

Kullanıcının dizinde var olduğunu doğrulama

1. Davet edilen kullanıcının Microsoft Entra Id'ye eklendiğini doğrulamak için aşağıdaki komutu çalıştırın (öğesini davet edilen e-postanızla değiştirin henry@contoso.com ):

   Get-MgUser -Filter "Mail eq 'henry@contoso.com'"
   

2. Kullanıcı asıl adı (UPN) emailaddress#EXT#@etkialanı biçiminde olacak şekilde, davet ettiğiniz kullanıcının listelendiğinden emin olmak için çıktıyı denetleyin. Örneğin, henry_contoso.com#EXT#@fabrikam.onmicrosoft.com, burada fabrikam.onmicrosoft.com davetleri gönderdiğiniz kuruluş olur.

   Id                                   DisplayName              Mail                           UserPrincipalName        
   --                                   -----------              ----                           -----------------               
   00aa00aa-bb11-cc22-dd33-44ee44ee44ee Henry Ross               henry@contoso.com              henry@contoso.com
   

Kaynakları temizleme

Artık gerekli değilse dizindeki test kullanıcı hesaplarını silebilirsiniz. Kullanıcı hesabını silmek için aşağıdaki komutu çalıştırın:

 Remove-MgUser -UserId '<String>'

Örneğin:

Remove-MgUser -UserId 'henry_contoso.com#EXT#@fabrikam.onmicrosoft.com'

veya

Remove-MgUser -UserId '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

Sonraki adımlar

Bu hızlı başlangıçta, PowerShell kullanarak dizininize tek bir konuk kullanıcıyı davet edip eklediniz. Microsoft Entra yönetim merkezini kullanarak konuk kullanıcıyı davet edebilirsiniz. Ayrıca PowerShell'i kullanarak konuk kullanıcıları toplu olarak davet edebilirsiniz.