Az AIPService PowerShell-modul telepítése

  • Cikk

Az alábbi információk segítségével telepítheti a Windows PowerShell modult a védelmi szolgáltatáshoz az Azure Information Protectionből. Ennek a modulnak a neve AIPService, és az AADRM nevű korábbi verziót váltja fel.

Ezzel a PowerShell-modullal felügyelheti a védelmi szolgáltatást (Azure Tartalomvédelmi szolgáltatások) a parancssorból bármely olyan Windows rendszerű számítógép használatával, amely internetkapcsolattal rendelkezik, és amely megfelel a következő szakaszban felsorolt előfeltételeknek. Az Azure Information Protectionhez készült Windows PowerShell támogatja az automatizálási szkriptelést, vagy speciális konfigurációs forgatókönyvekhez szükséges lehet. A modul által támogatott felügyeleti feladatokkal és konfigurációkkal kapcsolatos további információkért lásd: Rendszergazda Védelem regisztrálása az Azure Information Protectionből a PowerShell használatával.

Előfeltételek

Ez a táblázat az Azure Information Protection védelmi szolgáltatásához tartozó AIPService PowerShell-modul telepítésének és használatának előfeltételeit sorolja fel.

Követelmény További információ
A Windows PowerShell minimális verziója 3.0-s verzió

Egy PowerShell-munkamenetbe beírva $PSVersionTable ellenőrizheti a Windows PowerShell futtatott verzióját. Ha telepítenie kell a Windows PowerShell újabb verzióját, tekintse át a meglévő Windows PowerShell frissítését ismertető témakört.

Vegye figyelembe, hogy az AIPService PowerShell modul csak a Windows PowerShellt támogatja. A PowerShell 7 nem támogatott.
A Microsoft .NET-keretrendszer minimális verziója 4.8-es verzió

Megjegyzés: A Microsoft .NET-keretrendszer ezen verziója a későbbi operációs rendszerek részét képezi, ezért csak akkor kell manuálisan telepítenie, ha az ügyfél operációs rendszere kisebb, mint a Windows 8.0, vagy a kiszolgáló operációs rendszere kisebb, mint a Windows Server 2012.

Ha a Microsoft .NET-keretrendszer minimális verziója még nincs telepítve, letöltheti a Microsoft .NET-keretrendszer 4.8-at. A Microsoft .NET-keretrendszer ezen minimális verziója szükséges az AIPService modul által használt egyes osztályokhoz.
Szükséges licenc A funkció használatához terméklicencet kell használnia. További információkért tekintse meg a Microsoft 365 biztonsági és megfelelőségi licencelési útmutatóját – szolgáltatásleírásokat.

Ha telepítve van az AADRM modul

Az AIPService modul lecseréli a régebbi AADRM modult. Ha telepítve van a régebbi modul, távolítsa el, majd telepítse az AIPService modult.

Az újabb modul aliasokkal rendelkezik a régebbi modul parancsmagneveihez, így a meglévő szkriptek továbbra is működni fognak. Tervezze azonban, hogy frissíti ezeket a hivatkozásokat, mielőtt a régi modul kiesik a támogatásból. Az AADRM modul támogatása 2020. július 15-én megszűnik.

Ha az AADRM modult a PowerShell-galéria telepítette, távolítsa el, indítsa el a PowerShell-munkamenetet a Futtatás Rendszergazda istratorként beállítással, és írja be a következőt:

Uninstall-Module -Name AADRM

Ha az AADRM modult a Azure Tartalomvédelmi szolgáltatások Rendszergazda istration eszközzel telepítette, a Programok és szolgáltatások használatával távolítsa el a Windows Azure AD Rights Management Rendszergazda istration szolgáltatást.

Az AIPService modul telepítése

Az AIPService modul a PowerShell-galéria található, és nem érhető el a Microsoft letöltőközpontból.

Ha még nem ismerkedik a PowerShell-galéria, olvassa el a PowerShell-galéria használatának első lépéseit. Kövesse a katalógus követelményeire vonatkozó utasításokat, amelyek magukban foglalják a PowerShellGet modul és a NuGet-szolgáltató telepítését.

Az AIPService modul részleteinek megtekintéséhez látogasson el az AIPService oldalra a PowerShell-galéria.

Az AIPService modul telepítéséhez indítsa el a PowerShell-munkamenetet a Futtatás Rendszergazda istrator beállítással, és írja be a következőt:

Install-Module -Name AIPService

Ha a rendszer figyelmezteti a nem megbízható adattárból való telepítésre, az Y billentyűt lenyomva ellenőrizheti. Vagy nyomja le az N billentyűt, és konfigurálja a PowerShell-galéria megbízható adattárként a parancs Set-PSRepository -Name PSGallery -InstallationPolicy Trusted használatával, majd futtassa újra a parancsot az AIPService modul telepítéséhez.

Ha az AIPService modul egy korábbi verziója telepítve van a katalógusból, frissítse a legújabb verzióra a következő beírással:

Update-Module -Name AIPService

További lépések

Windows PowerShell-munkamenetben erősítse meg a telepített modul verzióját. Ez az ellenőrzés különösen fontos, ha egy régebbi verzióról frissített:

(Get-Module AIPService –ListAvailable).Version

Megjegyzés:

Ha ez a parancs nem sikerül, először futtassa az Import-Module AIPService parancsot.

A rendelkezésre álló parancsmagok megtekintéséhez írja be a következőt:

Get-Command -Module AIPService

Get-Help <cmdlet_name> A parancs segítségével megtekintheti egy adott parancsmag súgóját, és az -online paraméterrel megtekintheti a Microsoft dokumentációs webhelyének legújabb súgóját. Például:

Get-Help Connect-AipService -online

For more information:

A védelmi szolgáltatást konfiguráló parancsok futtatása előtt csatlakoznia kell a szolgáltatáshoz az Csatlakozás-AipService parancsmag használatával.

Ha befejezte a konfigurációs parancsok futtatását, ajánlott eljárásként válassza le a szolgáltatást a Disconnect-AipService parancsmag használatával. Ha nem bontja le a kapcsolatot, a rendszer egy inaktivitási időszak után automatikusan leválasztja a kapcsolatot. Az automatikus leválasztási viselkedés miatt előfordulhat, hogy időnként újra kell kapcsolódnia egy PowerShell-munkamenetben.

Megjegyzés:

Ha a védelmi szolgáltatás még nincs aktiválva, ezt az Enable-AipService parancsmaggal teheti meg, miután csatlakozott a szolgáltatáshoz.