Connect-AipService

Syntax

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

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

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

Description

A Connect-AipService parancsmag csatlakozik az Azure Information Protectionhez, hogy aztán rendszergazdai parancsokat futtasson a bérlő védelmi szolgáltatásához. Ezt a parancsmagot a bérlőt kezelő partnervállalat is használhatja.

A modul többi parancsmagjának futtatása előtt futtatnia kell ezt a parancsmagot.

Az Azure Information Protectionhez való csatlakozáshoz használjon egy fiókot, amely az alábbiak egyike:

• Az Office 365-bérlő globális rendszergazdája.
• Az Azure AD-bérlő globális rendszergazdája. Ez a fiók azonban nem lehet Microsoft-fiók (MSA) vagy egy másik Azure-bérlő.
• A bérlőtől származó felhasználói fiók, amely rendszergazdai jogokat kapott az Azure Information Protectionhez az Add-AipServiceRoleBasedAdministrator parancsmag használatával.
• Az Azure Information Protection-rendszergazda, a megfelelőségi rendszergazda vagy a megfelelőségi adatadminisztrátor Azure AD-rendszergazdai szerepköre.

Példák

1. példa: Csatlakozzon az Azure Information Protectionhez, és kérje meg a felhasználónevet és az egyéb hitelesítő adatokat

PS C:\> Connect-AipService

Ez a parancs az Azure Information Protection védelmi szolgáltatásához csatlakozik. Ez a legegyszerűbb módja a szolgáltatáshoz való csatlakozásnak úgy, hogy a parancsmagot paraméterek nélkül futtatja.

A rendszer kéri a felhasználónevet és a jelszót. Ha a fiókja többtényezős hitelesítés használatára van konfigurálva, a rendszer kérni fogja az alternatív hitelesítési módszert, majd csatlakozik a szolgáltatáshoz.

Ha a fiókja többtényezős hitelesítés használatára van konfigurálva, ezt a módszert kell használnia az Azure Information Protectionhez való csatlakozáshoz.

2. példa: Csatlakozás az Azure Information Protectionhez tárolt hitelesítő adatokkal

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

Az első parancs létrehoz egy PSCredential objektumot, és a megadott felhasználónevet és jelszót a $AdminCredentials változóban tárolja. A parancs futtatásakor a rendszer kéri a megadott felhasználónév jelszavát.

A második parancs a $AdminCredentialstárolt hitelesítő adatokkal csatlakozik az Azure Information Protectionhez. Ha leválasztja a szolgáltatást, és újracsatlakozik, amíg a változó még használatban van, egyszerűen futtassa újra a második parancsot.

3. példa: Csatlakozás az Azure Information Protectionhez jogkivonattal

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

Ez a példa bemutatja, hogyan csatlakozhat az Azure Information Protectionhez az AccessToken paraméterrel, amely lehetővé teszi a hitelesítést kérés nélkül. Ez a kapcsolati módszer megköveteli a 90f610bf-206d-4950-b61d-37fa6fd1b224 és az erőforrás-azonosító megadását. A kapcsolat megnyitása után futtathatja a szükséges felügyeleti parancsokat ebből a modulból.

Miután meggyőződött arról, hogy ezek a parancsok sikeresen csatlakoznak az Azure Information Protectionhez, nem interaktív módon futtathatja őket, például egy szkriptből.

Vegye figyelembe, hogy illusztrációs célokra ez a példa a admin@contoso.com felhasználónevet használja Passw0rd jelszavával! Éles környezetben, ha ezt a kapcsolati módszert nem interaktív módon használja, további módszerekkel biztonságossá teheti a jelszót, hogy az ne legyen tiszta szövegben tárolva. Használja például a ConvertTo-SecureString parancsot, vagy használja a Key Vaultot a jelszó titkos kulcsként való tárolásához.

4. példa: Csatlakozás az Azure Information Protectionhez ügyféltanúsítvánnyal szolgáltatásnév-hitelesítéssel

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

Ez a példa tanúsítványalapú szolgáltatásnév-hitelesítéssel csatlakozik egy Azure-fiókhoz. A hitelesítéshez használt szolgáltatásnevet a megadott tanúsítvánnyal kell létrehozni.

A példa előfeltételei:

• Az AIPService PowerShell-modult az 1.0.05-ös vagy újabb verzióra kell frissítenie.
• A szolgáltatásnév hitelesítésének engedélyezéséhez olvasási API-engedélyeket (Application.Read.All) kell hozzáadnia a szolgáltatásnévhez.

További információ: Szükséges API-engedélyek – Microsoft Information Protection SDK és Az Azure PowerShell használata szolgáltatásnév létrehozásához tanúsítvány.

5. példa: Csatlakozás az Azure Information Protectionhez ügyféltitkos szolgáltatásnév-hitelesítéssel

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

Ebben a példában:

• Az első parancssor kéri a szolgáltatásnév hitelesítő adatait, és azokat a $Credential változóban tárolja. Előléptetéskor adja meg az alkalmazásazonosítót a felhasználónév értékéhez és a szolgáltatásnév titkos kódjához jelszóként.
• A második parancs a megadott Azure-bérlőhöz csatlakozik a $Credential változóban tárolt szolgáltatásnév hitelesítő adataival. A ServicePrincipal kapcsolóparaméter azt jelzi, hogy a fiók szolgáltatásnévként hitelesít.

A szolgáltatásnév hitelesítésének engedélyezéséhez olvasási API-engedélyeket (Application.Read.All) kell hozzáadnia a szolgáltatásnévhez. További információ: Szükséges API-engedélyek – Microsoft Information Protection SDK.

Paraméterek

-AccessToken

-ApplicationID

-CertificateThumbprint

-Credential

-EnvironmentName

-ServicePrincipal

-TenantId

Kapcsolódó hivatkozások

• Get-Credential
• Disconnect-AipService