forked from microsoftgraph/powershell-intune-samples
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
HB of localized readme files (microsoftgraph#127)
Co-authored-by: OfficeGlobal <[email protected]>
- Loading branch information
1 parent
616339a
commit 59fc607
Showing
6 changed files
with
798 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,133 @@ | ||
--- | ||
page_type: sample | ||
products: | ||
- ms-graph | ||
languages: | ||
- powershell | ||
extensions: | ||
contentType: samples | ||
technologies: | ||
- Microsoft Graph | ||
services: | ||
- Intune | ||
createdDate: 4/4/2017 9:41:27 AM | ||
--- | ||
# Ejemplos de Graph de Intune | ||
|
||
Este repositorio de scripts de ejemplo de PowerShell muestra cómo obtener acceso a los recursos del servicio Intune. Lo muestran haciendo solicitudes de la API de REST de HTTPS a la API de Microsoft Graph desde PowerShell. | ||
|
||
La documentación de Intune y Microsoft Graph se encuentra aquí [Documentación de Graph de Intune](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview). | ||
|
||
En estos ejemplos se muestran las acciones de administrador de Intune o de asociado de Microsoft habituales para administrar recursos de Intune. | ||
|
||
Los siguientes ejemplos se incluyen en este repositorio: | ||
- AdminConsent | ||
- AndroidEnterprise | ||
- AppleEnrollment | ||
- Applications | ||
- ApplicationSync | ||
- AppProtectionPolicy | ||
- Auditing | ||
- Authentication | ||
- CertificationAuthority | ||
- CheckStatus | ||
- CompanyPortalBranding | ||
- CompliancePolicy | ||
- CorporateDeviceEnrollment | ||
- DeviceConfiguration | ||
- EnrollmentRestrictions | ||
- IntuneDataExport | ||
- LOB_Application | ||
- ManagedDevices | ||
- Paging | ||
- RBAC | ||
- RemoteActionAudit | ||
- SoftwareUpdates | ||
- TermsAndConditions | ||
- UserPolicyReport | ||
|
||
Los scripts se otorgan bajo licencia "tal cual" en la licencia MIT. | ||
|
||
#### Aviso de declinación de responsabilidades | ||
Algunos ejemplos de script recuperan información de su espacio empresarial de Intune y otras crean, eliminan o actualizan los datos en el espacio empresarial de Intune. Debe comprender el impacto de cada script de ejemplo antes de ejecutarlo, los ejemplos se deben ejecutar con una cuenta de inquilino que no es de producción o "de prueba". | ||
|
||
## Usar la API de Graph de Intune | ||
La API de Graph de Intune permite el acceso mediante programación a la información de Intune para su espacio empresarial y la API realiza las mismas operaciones de Intune que las que están disponibles a través de Azure Portal. | ||
|
||
Intune proporciona datos a Microsoft Graph igual que lo hacen otros servicios en la nube, con navegación de relaciones e información sobre entidades enriquecida. Use Microsoft Graph para combinar la información de otros servicios e Intune y crear aplicaciones de servicios cruzados completas para profesionales de TI o usuarios finales. | ||
|
||
## Requisitos previos | ||
El uso de estos ejemplos de PowerShell de Intune de la API de Microsoft Graph requiere lo siguiente: | ||
* Instalar el módulo de AzureAD PowerShell ejecutando "Install-Module AzureAD" o "Install-Module AzureADPreview" desde un símbolo del sistema de PowerShell con privilegios elevados | ||
* Un espacio empresarial de Intune que admita Azure Portal con una licencia de producción o de prueba (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune) | ||
* Usar las API de Microsoft Graph para configurar las directivas y los controles de Intune requiere una licencia de Intune. | ||
* Una cuenta con permisos para administrar el servicio de Intune | ||
* PowerShell v5.0 en Windows 10 x64 (PowerShell v4.0 es un requisito mínimo para que los scripts funcionen correctamente) | ||
* Nota: En el caso de PowerShell 4.0 necesitará el módulo [PowershellGet Module for PS 4.0](https://www.microsoft.com/en-us/download/details.aspx?id=51451) para habilitar el uso de la función Install-Module | ||
* El uso de estos scripts por primera vez requiere que un administrador global del espacio empresarial acepte los permisos de la aplicación | ||
|
||
## Introducción | ||
Después de que se instalen o se cumplan los requisitos previos, lleve a cabo los siguientes pasos para usar estos scripts: | ||
|
||
#### 1. Uso del script | ||
|
||
1. Descargue el contenido del repositorio en su equipo local de Windows | ||
* Extraiga los archivos en una carpeta local (por ejemplo, C:\IntuneGraphSamples) | ||
* En el menú Inicio ejecute PowerShell x64 | ||
* Desplácese hasta el directorio (p. ej., cd C:\IntuneGraphSamples) | ||
* Por cada carpeta en el repositorio local, puede ir a ese directorio y ejecutar el script que prefiera. | ||
* Uso de script de aplicación de ejemplo: | ||
* Para usar los scripts de Administrar aplicaciones, en C:\IntuneGraphSamples, ejecute "cd .\Applications\". | ||
* Una vez en la carpeta ejecute .\Application_MDM_Get.ps1 | ||
para obtener todas las aplicaciones agregadas por MDM Esta secuencia de pasos se puede usar para cada carpeta.... | ||
|
||
#### 2. Autenticación con Microsoft Graph | ||
La primera vez que ejecute estos scripts, se le pedirá que proporcione una cuenta para autenticar con el servicio: | ||
``` | ||
Please specify your user principal name for Azure Authentication: | ||
``` | ||
Una vez que haya proporcionado un nombre principal de usuario, se abrirá una ventana emergente en la que se le solicitará la contraseña. Cuando la autenticación de Azure Active Directory se realice correctamente, el token de usuario durará una hora, cuando pase la hora en la sesión de PowerShell, se le solicitará que vuelva a autenticarse. | ||
|
||
Si está ejecutando el script por primera vez en su espacio empresarial, se mostrará un mensaje emergente en el que se indicará lo siguiente: | ||
|
||
``` | ||
Microsoft Intune PowerShell needs permission to: | ||
* Sign you in and read your profile | ||
* Read all groups | ||
* Read directory data | ||
* Read and write Microsoft Intune Device Configuration and Policies (preview) | ||
* Read and write Microsoft Intune RBAC settings (preview) | ||
* Perform user-impacting remote actions on Microsoft Intune devices (preview) | ||
* Sign in as you | ||
* Read and write Microsoft Intune devices (preview) | ||
* Read and write all groups | ||
* Read and write Microsoft Intune configuration (preview) | ||
* Read and write Microsoft Intune apps (preview) | ||
``` | ||
|
||
Nota: Si su cuenta de usuario tiene como objetivo el acceso condicional basado en el dispositivo, el dispositivo debe estar inscrito o ser compatible para poder realizar la autenticación de forma correcta. | ||
|
||
## Colaboradores | ||
|
||
Si quiere hacer su aportación a este ejemplo, vea CONTRIBUTING.MD. | ||
|
||
Este proyecto ha adoptado el Código de conducta de código abierto de Microsoft. Para obtener más información, vea Preguntas frecuentes sobre el código de conducta o póngase en contacto con [email protected] si tiene otras preguntas o comentarios. | ||
|
||
## Preguntas y comentarios | ||
|
||
Nos encantaría recibir sus comentarios sobre el ejemplo de PowerShell de Intune. Puede enviarnos sus preguntas y sugerencias a través de la sección Problemas de este repositorio. | ||
|
||
Su opinión es importante para nosotros. Conéctese con nosotros en Stack Overflow. Etiquete sus preguntas con \[MicrosoftGraph] y \[intune]. | ||
|
||
|
||
## Recursos adicionales | ||
* [Documentación de la API de Microsoft Graph](https://developer.microsoft.com/en-us/graph/docs) | ||
* [Portal de Microsoft Graph](https://developer.microsoft.com/en-us/graph/graph-explorer) | ||
* [Muestras de código de Microsoft ](https://developer.microsoft.com/en-us/graph/code-samples-and-sdks) | ||
* [Documentación de Graph de Intune](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview) | ||
|
||
## Derechos de autor | ||
Copyright (c) 2017 Microsoft. Todos los derechos reservados. | ||
|
||
Este proyecto ha adoptado el [Código de conducta de código abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/). Para obtener más información, vea [Preguntas frecuentes sobre el código de conducta](https://opensource.microsoft.com/codeofconduct/faq/) o póngase en contacto con [[email protected]](mailto:[email protected]) si tiene otras preguntas o comentarios. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,133 @@ | ||
--- | ||
page_type: sample | ||
products: | ||
- ms-graph | ||
languages: | ||
- powershell | ||
extensions: | ||
contentType: samples | ||
technologies: | ||
- Microsoft Graph | ||
services: | ||
- Intune | ||
createdDate: 4/4/2017 9:41:27 AM | ||
--- | ||
# Exemples Intune Graph | ||
|
||
Ce référentiel d’exemples de scripts PowerShell présente comment accéder aux ressources du service Intune. Les exemples illustrent l'envoi de demandes d’API RESTful HTTPS à l’API Microsoft Graph à partir de PowerShell. | ||
|
||
La documentation sur Intune et Microsoft Graph est disponible ici [Documentation Intune Graph](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview). | ||
|
||
Ces exemples illustrent des actions classiques d'administrateurs Intune ou de partenaires Microsoft pour la gestion des ressources Intune. | ||
|
||
Les exemples suivants sont inclus dans le référentiel : | ||
-AdminConsent | ||
-AndroidEnterprise | ||
-AppleEnrollment | ||
-applications | ||
-ApplicationSync | ||
-AppProtectionPolicy | ||
-Auditing | ||
-Authentication | ||
-CertificationAuthority | ||
-CheckStatus | ||
-CompanyPortalBranding | ||
-CompliancePolicy | ||
-CorporateDeviceEnrollment | ||
-DeviceConfiguration | ||
-EnrollmentRestrictions | ||
-IntuneDataExport | ||
-LOB_Application | ||
-ManagedDevices | ||
-pagination | ||
-RBAC | ||
-RemoteActionAudit | ||
-SoftwareUpdates | ||
-TermsAndConditions | ||
-UserPolicyReport | ||
|
||
Les scripts sont sous licence « en l'état » sous la Licence MIT. | ||
|
||
#### Clause d’exclusion de responsabilité | ||
Certains exemples de script récupèrent des informations de votre client Intune, alors que d’autres créent, suppriment ou mettent à jour des données dans votre client Intune. Veuillez comprendre l’influence de chaque exemple de script avant de l’exécuter ; les exemples doivent être exécutés à l’aide d’un compte client non productif ou en « test ». | ||
|
||
## Utilisation de l’API Graph Intune | ||
L’API de Microsoft Graph pour Intune permet l’accès programmatique aux informations Intune relatives à votre client ; l’API effectue les mêmes opérations Intune que celles disponibles via le Portail Azure. | ||
|
||
Intune fournit des données dans Microsoft Graph Intune de la même façon que d’autres services cloud, avec des informations d’identité enrichies et une navigation des relations. Utilisez Microsoft Graph pour combiner les informations provenant d’autres services et d’Intune et créer des applications interservices enrichies pour les professionnels de l’informatique ou des utilisateurs finaux. | ||
|
||
## Conditions préalables | ||
Pour utiliser les exemples d’API Intune PowerShell de Microsoft Graph, les éléments suivants sont nécessaires : | ||
* installer le module AzureAD PowerShell en exécutant « Install-Module AzureAD » ou « Install-Module AzureADPreview » à partir d’une invite PowerShell avec élévation de privilèges | ||
* Un client Intune qui prend en charge le Portail Azure avec une licence de production ou d’évaluation (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune) | ||
* Une licence Intune est nécessaire pour l'utilisation des API Microsoft pour configurer les stratégies et les contrôles | ||
* Un compte disposant des autorisations pour administrer le service Intune | ||
* PowerShell v5.0 sur Windows 10 x64 (PowerShell v4.0 est une condition minimale requise pour que les scripts fonctionnent correctement) | ||
* Remarque : Pour PowerShell 4.0, vous aurez besoin du [Module PowershellGet pour PS 4.0](https://www.microsoft.com/en-us/download/details.aspx?id=51451) pour activer l’utilisation de la fonctionnalité Install-Module | ||
* La première utilisation de ces scripts nécessite l'acceptation des autorisations d'application par un administrateur général du client. | ||
|
||
## Prise en main | ||
Une fois que vous avez installé ou rempli les conditions préalables, procédez comme suit pour utiliser ces scripts : | ||
|
||
#### 1. Utilisation de script | ||
|
||
1. Téléchargez le contenu du référentiel sur votre ordinateur Windows local | ||
* Faites une extraction des fichiers dans un dossier local (par exemple, C:\IntuneGraphSamples) | ||
* Exécutez PowerShell x64 dans le menu de démarrage | ||
* Accédez au répertoire (par exemple, CD C:\IntuneGraphSamples) | ||
* Pour chaque Dossier du référentiel local, vous pouvez accéder à ce répertoire, puis exécuter le script de votre choix. | ||
* Exemple d’utilisation du script d’application : | ||
* Pour utiliser les scripts Gérer les applications, à partir de C:\IntuneGraphSamples, exécutez « cd .\Applications\ » | ||
* Une fois dans le dossier, exécutez \Application_MDM_Get.ps1 | ||
pour obtenir toutes les applications ajoutées. Cette série d’étapes peut être utilisée pour chaque dossier.... | ||
|
||
#### 2. Authentification d’application à l'aide de Microsoft Graph | ||
Lorsque vous exécutez ces scripts pour la première fois, vous êtes invité à fournir un compte pour vous authentifier auprès du service : | ||
``` | ||
Please specify your user principal name for Azure Authentication: | ||
``` | ||
Une fois que vous avez fourni un nom d’utilisateur principal, une fenêtre contextuelle s’ouvre et vous invite à saisir votre mot de passe. Une fois l’authentification réussie avec Azure Active Directory, le jeton d’utilisateur est valable pendant une heure. Au-delà de cette heure au sein de la session PowerShell, vous êtes invité à vous authentifier de nouveau. | ||
|
||
Si vous exécutez le script pour la première fois chez votre client, une fenêtre contextuelle s’affiche indiquant : | ||
|
||
``` | ||
Microsoft Intune PowerShell needs permission to: | ||
* Sign you in and read your profile | ||
* Read all groups | ||
* Read directory data | ||
* Read and write Microsoft Intune Device Configuration and Policies (preview) | ||
* Read and write Microsoft Intune RBAC settings (preview) | ||
* Perform user-impacting remote actions on Microsoft Intune devices (preview) | ||
* Sign in as you | ||
* Read and write Microsoft Intune devices (preview) | ||
* Read and write all groups | ||
* Read and write Microsoft Intune configuration (preview) | ||
* Read and write Microsoft Intune apps (preview) | ||
``` | ||
|
||
Remarque : Si votre compte utilisateur est ciblé pour l’accès conditionnel basé sur l’appareil, votre appareil doit être inscrit ou être conforme pour réussir l’authentification. | ||
|
||
## Contribution | ||
|
||
Si vous souhaitez contribuer à cet exemple, voir CONTRIBUTING.MD. | ||
|
||
Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d'informations, reportez-vous à la FAQ relative au Code de conduite ou contactez [email protected] pour toute question ou tout commentaire. | ||
|
||
## Questions et commentaires | ||
|
||
Nous serions ravis de connaître votre opinion sur l’exemple Intune PowerShell. Vous pouvez nous faire part de vos questions et suggestions dans la rubrique problèmes de ce référentiel. | ||
|
||
Votre avis compte beaucoup pour nous. Communiquez avec nous sur Stack Overflow. Posez vos questions avec les tags [MicrosoftGraph] et [Intune]. | ||
|
||
|
||
## Ressources supplémentaires | ||
* [Documentation de l’API Microsoft Graph](https://developer.microsoft.com/en-us/graph/docs) | ||
* [Portail Microsoft Graph](https://developer.microsoft.com/en-us/graph/graph-explorer) | ||
* [Exemple de codes Microsoft](https://developer.microsoft.com/en-us/graph/code-samples-and-sdks) | ||
* [Documentation d'Intune Graph](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview) | ||
|
||
## Copyright | ||
Copyright (c) 2017 Microsoft. Tous droits réservés. | ||
|
||
Ce projet a adopté le [code de conduite Open Source de Microsoft](https://opensource.microsoft.com/codeofconduct/). Pour en savoir plus, reportez-vous à la [FAQ relative au code de conduite](https://opensource.microsoft.com/codeofconduct/faq/) ou contactez [[email protected]](mailto:[email protected]) pour toute question ou tout commentaire. |
Oops, something went wrong.