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

Makale
10/24/2023

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önetici istratörü 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ı 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

Test e-posta hesabınıza davet göndermek için aşağıdaki PowerShell komutunu çalıştırın ( "John Doe"john@contoso.com yerine test e-posta hesabınızın adı ve e-posta adresi yazın):
```
New-MgInvitation -InvitedUserDisplayName "John Doe" -InvitedUserEmailAddress John@contoso.com -InviteRedirectUrl "https://myapplications.microsoft.com" -SendInvitationMessage:$true
```
Komut, belirtilen e-posta adresine bir davet gönderir. Çıktıyı denetleyin ve aşağıdaki örneğe benzer görünmelidir:

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

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 john@contoso.com ):
```
Get-MgUser -Filter "Mail eq 'John@contoso.com'"
```
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, fabrikam.onmicrosoft.com davetleri gönderdiğiniz kuruluş olan john_contoso.com#EXT#@fabrikam.onmicrosoft.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 'john_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.