Connect-AipService

Sintaks

Connect-AipService
       [-Credential <PSCredential>]
       [-TenantId <Guid>]
       [<CommonParameters>]

Connect-AipService
       [-AccessToken <String>]
       [-TenantId <Guid>]
       [<CommonParameters>]

Connect-AipService
       [-EnvironmentName <AzureRmEnvironment>]
       [<CommonParameters>]

Deskripsi

cmdlet Connect-AipService menghubungkan Anda ke Perlindungan Informasi Azure sehingga Anda kemudian dapat menjalankan perintah administratif untuk layanan perlindungan untuk penyewa Anda. Cmdlet ini juga dapat digunakan oleh perusahaan mitra yang mengelola penyewa Anda.

Anda harus menjalankan cmdlet ini sebelum dapat menjalankan cmdlet lain dalam modul ini.

Untuk menyambungkan ke Perlindungan Informasi Azure, gunakan akun yang merupakan salah satu hal berikut ini:

• Admin global untuk penyewa Office 365 Anda.
• Administrator global untuk penyewa Azure ACTIVE Directory Anda. Namun, akun ini tidak dapat menjadi akun Microsoft (MSA) atau dari penyewa Azure lain.
• Akun pengguna dari penyewa Anda yang telah diberikan hak administratif untuk Perlindungan Informasi Azure dengan menggunakan cmdlet Add-AipServiceRoleBasedAdministrator.
• Peran admin Azure ACTIVE Directory dari administrator Perlindungan Informasi Azure, Administrator kepatuhan, atau administrator data Kepatuhan.

Contoh

Contoh 1: Sambungkan ke Perlindungan Informasi Azure dan dimintai nama pengguna Anda dan kredensial lainnya

PS C:\> Connect-AipService

Perintah ini tersambung ke layanan perlindungan dari Perlindungan Informasi Azure. Ini adalah cara paling sederhana untuk terhubung ke layanan, dengan menjalankan cmdlet tanpa parameter.

Anda dimintai nama pengguna dan kata sandi Anda. Jika akun Anda dikonfigurasi untuk menggunakan autentikasi multifaktor, Anda kemudian diminta untuk metode autentikasi alternatif Anda, lalu tersambung ke layanan.

Jika akun Anda dikonfigurasi untuk menggunakan autentikasi multifaktor, Anda harus menggunakan metode ini untuk menyambungkan ke Perlindungan Informasi Azure.

Contoh 2: Menyambungkan ke Perlindungan Informasi Azure dengan kredensial tersimpan

PS C:\>$AdminCredentials = Get-Credential "Admin@aadrm.contoso.com"
PS C:\> Connect-AipService -Credential $AdminCredentials

Perintah pertama membuat objek PSCredential dan menyimpan nama pengguna dan kata sandi yang Anda tentukan dalam variabel $AdminCredentials. Saat Menjalankan perintah ini, Anda akan dimintai kata sandi untuk nama pengguna yang Anda tentukan.

Perintah kedua tersambung ke Perlindungan Informasi Azure dengan menggunakan kredensial yang disimpan di $AdminCredentials. Jika Anda memutuskan sambungan dari layanan dan menyambungkan kembali saat variabel masih digunakan, cukup jalankan ulang perintah kedua.

Contoh 3: Menyambungkan ke Perlindungan Informasi Azure dengan token

PS C:\ > Add-Type -Path "C:\Program Files\WindowsPowerShell\Modules\AIPService\1.0.0.1\Microsoft.IdentityModel.Clients.ActiveDirectory.dll"
PS C:\ > $clientId='90f610bf-206d-4950-b61d-37fa6fd1b224';
PS C:\ > $resourceId = 'https://api.aadrm.com/';
PS C:\ > $userName='admin@contoso.com';
PS C:\ > $password='Passw0rd!';
PS C:\ > $authority = "https://login.microsoftonline.com/common";
PS C:\ > $authContext = New-Object Microsoft.IdentityModel.Clients.ActiveDirectory.AuthenticationContext($authority);
PS C:\ > $userCreds = New-Object Microsoft.IdentityModel.Clients.ActiveDirectory.UserPasswordCredential($userName, $password);
PS C:\ > $authResult = [Microsoft.IdentityModel.Clients.ActiveDirectory.AuthenticationContextIntegratedAuthExtensions]::AcquireTokenAsync($authContext, $resourceId, $clientId, $userCreds).Result;
PS C:\ > Import-Module AIPService
PS C:\> Connect-AipService -AccessToken $authResult.AccessToken

Contoh ini memperlihatkan bagaimana Anda dapat tersambung ke Perlindungan Informasi Azure dengan menggunakan parameter AccessToken , yang memungkinkan Anda mengautentikasi tanpa perintah. Metode koneksi ini mengharuskan Anda menentukan ID klien 90f610bf-206d-4950-b61d-37fa6fd1b224 dan ID sumber daya *https://api.aadrm.com/*. Setelah koneksi terbuka, Anda kemudian dapat menjalankan perintah administratif dari modul ini yang Anda butuhkan.

Setelah Anda mengonfirmasi bahwa perintah ini berhasil menyambungkan ke Perlindungan Informasi Azure, Anda dapat menjalankannya secara non-interaktif, misalnya, dari skrip.

Perhatikan bahwa untuk tujuan ilustrasi, contoh ini menggunakan nama pengguna admin@contoso.com dengan kata sandi Passw0rd! Di lingkungan produksi saat Anda menggunakan metode koneksi ini secara non-interaktif, gunakan metode tambahan untuk mengamankan kata sandi sehingga tidak disimpan dalam teks yang jelas. Misalnya, gunakan perintah ConvertTo-SecureString atau gunakan Key Vault untuk menyimpan kata sandi sebagai rahasia.

Contoh 4: Menyambungkan ke Perlindungan Informasi Azure dengan sertifikat klien melalui Autentikasi Perwakilan Layanan

PS C:\ > $Thumbprint = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
PS C:\ > $TenantId = 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy'
PS C:\ > $ApplicationId = '00000000-0000-0000-0000-00000000'
PS C:\> Connect-AipService -CertificateThumbprint $Thumbprint -ApplicationId $ApplicationId -TenantId $TenantId -ServicePrincipal

Contoh ini tersambung ke akun Azure menggunakan autentikasi perwakilan layanan berbasis sertifikat. Perwakilan layanan yang digunakan untuk autentikasi harus dibuat dengan sertifikat yang ditentukan.

Prasyarat untuk contoh ini:

• Anda harus memperbarui Modul PowerShell AIPService ke versi 1.0.05 atau yang lebih baru.
• Untuk mengaktifkan autentikasi Perwakilan Layanan, Anda harus menambahkan izin API baca (Application.Read.All) ke perwakilan layanan.

Untuk informasi selengkapnya, lihat Izin API yang Diperlukan - Microsoft Information Protection SDK dan Menggunakan Azure PowerShell untuk membuat perwakilan layanan dengan sertifikat.

Contoh 5: Menyambungkan ke Perlindungan Informasi Azure dengan rahasia klien melalui Autentikasi Perwakilan Layanan

PS C:\ > $TenantId = 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyy'
PS C:\ > $ApplicationId = '00000000-0000-0000-0000-00000000'
PS C:\ > $Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $ApplicationId, $SecuredPassword
PS C:\ > Connect-AipService -Credential $Credential -TenantId $TenantId -ServicePrincipal

Dalam contoh ini:

• Perintah pertama meminta kredensial perwakilan layanan dan menyimpannya dalam variabel $Credential. Saat dipromosikan, masukkan ID aplikasi Anda untuk nilai nama pengguna dan rahasia perwakilan layanan sebagai kata sandi.
• Perintah kedua tersambung ke penyewa Azure yang ditentukan menggunakan kredensial perwakilan layanan yang disimpan dalam variabel $Credential. Parameter sakelar ServicePrincipal menunjukkan bahwa akun mengautentikasi sebagai perwakilan layanan.

Untuk mengaktifkan autentikasi Perwakilan Layanan, Anda harus menambahkan izin API baca (Application.Read.All) ke perwakilan layanan. Untuk informasi selengkapnya, lihat Izin API yang Diperlukan - Microsoft Information Protection SDK.

Parameter

-AccessToken

-ApplicationID

-CertificateThumbprint

-Credential

-EnvironmentName

-ServicePrincipal

-TenantId

Link Terkait

• Get-Credential
• Disconnect-AipService