From 59fc607735ac7a0aafb359922ac36b4eb2994cc9 Mon Sep 17 00:00:00 2001 From: OfficeGlobal <47977325+OfficeGlobal@users.noreply.github.com> Date: Sun, 1 Aug 2021 22:58:44 +0200 Subject: [PATCH] HB of localized readme files (#127) Co-authored-by: OfficeGlobal --- README-localized/Readme-es-es.md | 133 +++++++++++++++++++++++++++++++ README-localized/Readme-fr-fr.md | 133 +++++++++++++++++++++++++++++++ README-localized/Readme-ja-jp.md | 133 +++++++++++++++++++++++++++++++ README-localized/Readme-pt-br.md | 133 +++++++++++++++++++++++++++++++ README-localized/Readme-ru-ru.md | 133 +++++++++++++++++++++++++++++++ README-localized/Readme-zh-cn.md | 133 +++++++++++++++++++++++++++++++ 6 files changed, 798 insertions(+) create mode 100644 README-localized/Readme-es-es.md create mode 100644 README-localized/Readme-fr-fr.md create mode 100644 README-localized/Readme-ja-jp.md create mode 100644 README-localized/Readme-pt-br.md create mode 100644 README-localized/Readme-ru-ru.md create mode 100644 README-localized/Readme-zh-cn.md diff --git a/README-localized/Readme-es-es.md b/README-localized/Readme-es-es.md new file mode 100644 index 0000000..39c45d4 --- /dev/null +++ b/README-localized/Readme-es-es.md @@ -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 opencode@microsoft.com 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 [opencode@microsoft.com](mailto:opencode@microsoft.com) si tiene otras preguntas o comentarios. diff --git a/README-localized/Readme-fr-fr.md b/README-localized/Readme-fr-fr.md new file mode 100644 index 0000000..9a058be --- /dev/null +++ b/README-localized/Readme-fr-fr.md @@ -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 opencode@microsoft.com 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 [opencode@microsoft.com](mailto:opencode@microsoft.com) pour toute question ou tout commentaire. diff --git a/README-localized/Readme-ja-jp.md b/README-localized/Readme-ja-jp.md new file mode 100644 index 0000000..00b0126 --- /dev/null +++ b/README-localized/Readme-ja-jp.md @@ -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 +--- +# Intune Graph のサンプル + +この PowerShell サンプル スクリプトのリポジトリは、Intune サービス リソースにアクセスする方法を示しています。PowerShell から Microsoft Graph API に HTTPS RESTful API 要求を行うことにより、その方法を示します。 + +Intune および Microsoft Graph のドキュメントについては、「[Intune Graph のドキュメント](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview)」を参照してください。 + +これらのサンプルでは、一般的な Intune 管理者、または Intune リソースを管理するための Microsoft パートナーの操作を示します。 + +このリポジトリには、次のサンプルが含まれています: +- 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 + +スクリプトは、MIT ライセンスの下、 "現状有姿" でライセンス付与されます。 + +#### 免責事項 +一部のスクリプトサンプルでは、Intune テナントから情報を取得ます。また、他のスクリプト サンプルでは、Intune テナントでデータを作成、削除、更新します。  実行前に、各サンプルスクリプトの影響を理解してください。サンプルは、非運用テナント アカウントまたは "テスト" テナントアカウントを使用して実行する必要があります。  + +## Intune Graph API の使用 +Intune Graph API を使用すると、テナントの Intune の情報へのプログラムによるアクセスが可能となります。API は Azure Portal で使用できるものと同じ Intune 操作を実行します。   + +Intune は、豊富なエンティティ情報とリレーションシップのナビゲーションを使用して、他のクラウド サービスと同じ方法で Microsoft Graph にデータを提供します。  Microsoft Graph を使用して、他のサービスからの情報と Intune を結合し、IT プロフェッショナルやエンド ユーザー向けの豊富なサービス間アプリケーションをビルドします。      + +## 前提条件 +これらの Microsoft Graph API Intune PowerShell のサンプルを使用するには、以下が必要です。 +* 管理者特権の PowerShell プロンプトから「Install-Module AzureAD」または「Install-Module AzureADPreview」を実行して、AzureAD PowerShell モジュールをインストールすること +* 本番ライセンスまたは試用ライセンスで Azure Portal をサポートする Intune テナント (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune) +* Microsoft Graph API を使用して Intune 制御とポリシーを構成するには、Intune ライセンスが必要です。 +* Intune サービスを管理する権限を持つアカウント +* Windows 10 x64 上の PowerShell v5.0 (PowerShell v4.0 は、スクリプトが正しく機能するための最小要件です) +* 注:PowerShell 4.0 の場合、インストール モジュール機能の使用を可能にするために [PS 4.0 用PowershellGet モジュール](https://www.microsoft.com/en-us/download/details.aspx?id=51451)が必要です +* これらのスクリプトを初めて使用するために、テナントのグローバル管理者がアプリケーションのアクセス許可を受け入れる必要があります + +## はじめに +前提条件をインストールした後、または前提条件を満たした後、次の手順を実行して、これらのスクリプトを使用します。 + +#### 1.スクリプトの使用方法 + +1. ローカル Windows マシンにリポジトリのコンテンツをダウンロードします +* ローカル フォルダー (例: C:\IntuneGraphSamples) にファイルを抽出します +* スタート メニューで PowerShell x64 を実行します +* ディレクトリ (例: cd C:\IntuneGraphSamples) を参照します +* ローカル リポジトリ内のフォルダーごとに、そのディレクトリを参照し、選択したスクリプトを実行できます。 +* アプリケーション スクリプトの使用例: + * Manage Applications スクリプトを実行するには、C:\IntuneGraphSamples から、"cd .\Applications\" を実行します + * フォルダーで .\Application_MDM_Get.ps1 + を実行し、すべての MDM 追加アプリケーションを取得します。この手順のシーケンスは、各フォルダーで使用できます。 + +#### 2.Microsoft Graph で認証する +これらのスクリプトを初めて実行するときに、サービスで認証するアカウントを指定するように求められます。 +``` +Please specify your user principal name for Azure Authentication: +``` +ユーザー プリンシパル名を入力すると、パスワードの入力を求めるメッセージが表示されます。Azure Active Directory で正常に認証された後、ユーザー トークンは1時間後に、PowerShell セッション内で有効期限が切れると、再認証を求められます。 + +テナントに対して初めてスクリプトを実行する場合は、以下のメッセージが表示されます。 + +``` +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) +``` + +注:ユーザー アカウントがデバイス ベースの条件付きアクセスを対象としている場合は、認証させるために、デバイスを登録するか、準拠する必要があります。 + +## 投稿 + +このサンプルに投稿する場合は、CONTRIBUTING.MD を参照してください。 + +このプロジェクトでは、Microsoft オープン ソース倫理規定が採用されています。詳細については、「倫理規定の FAQ」を参照してください。また、その他の質問やコメントがあれば、opencode@microsoft.com までお問い合わせください。 + +## 質問とコメント + +PowerShell のサンプルに関するフィードバックをお寄せください。質問や提案は、このリポジトリの「問題」セクションで送信できます。 + +お客様からのフィードバックを重視しています。スタック オーバーフローでご連絡ください。質問には [MicrosoftGraph] と [intune] でタグ付けしてください。 + + +## その他のリソース +* [Microsoft Graph API ドキュメント](https://developer.microsoft.com/en-us/graph/docs) +* [Microsoft Graph ポータル](https://developer.microsoft.com/en-us/graph/graph-explorer) +* [Microsoft コード サンプル](https://developer.microsoft.com/en-us/graph/code-samples-and-sdks) +* [Intune Graph ドキュメント](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview) + +## 著作権 +Copyright (c) 2017 Microsoft.All rights reserved. + +このプロジェクトでは、[Microsoft オープン ソース倫理規定](https://opensource.microsoft.com/codeofconduct/) が採用されています。詳細については、「[Code of Conduct の FAQ (倫理規定の FAQ)](https://opensource.microsoft.com/codeofconduct/faq/)」を参照してください。また、その他の質問やコメントがあれば、[opencode@microsoft.com](mailto:opencode@microsoft.com) までお問い合わせください。 diff --git a/README-localized/Readme-pt-br.md b/README-localized/Readme-pt-br.md new file mode 100644 index 0000000..14e0f3b --- /dev/null +++ b/README-localized/Readme-pt-br.md @@ -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 +--- +# Exemplos de Gráficos do Intune + +Este repositório de exemplos de scripts do PowerShell mostra como acessar os recursos de serviços do Intune. Eles demonstram isso por meio de solicitações da API RESTful HTTPS à API do Microsoft Graph do PowerShell. + +É possível encontrar a documentação do Intune e do Microsoft Graph aqui [Documentação do Graph para Intune](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview). + +Esses exemplos mostram o administrador típico do Intune ou ações de parceiros da Microsoft para o gerenciamento de recursos do Intune. + +Os exemplos a seguir estão incluídos neste repositório: +- 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 + +Os scripts são licenciados no estado em que se encontram sob a Licença MIT. + +#### Aviso de isenção de responsabilidade +Algumas amostras de script recuperam informações de seu locatário do Intune e outras criam, excluem ou atualizam dados no locatário do Intune.  Compreenda o impacto de cada script de exemplo antes de executá-lo. Os exemplos devem ser executados usando uma conta de locatário de teste ou que não seja de produção.  + +## Uso da API do Graph para Intune +A API do Graph para Intune permite o acesso programático a informações do Intune para seu locatário; a API executa as mesmas operações do Intune disponibilizadas pelo Portal do Azure.   + +O Intune fornece dados para o Microsoft Graph da mesma forma que outros serviços de nuvem fazem, com informações avançadas sobre entidades e navegação de relacionamentos.  Use o Microsoft Graph para combinar informações de outros serviços e do Intune e criar aplicativos avançados com serviços variados para profissionais de TI ou usuários finais.      + +## Pré-requisitos +O uso desses exemplos do PowerShell para o Intune na API do Microsoft Graph exige o seguinte: +* Instale o módulo de PowerShell do AzureAD executando "Install-Module AzureAD" ou "Install-Module AzureADPreview" em um prompt de PowerShell elevado +* Um locatário do Intune que suporte o Portal do Azure com uma licença de produção ou de avaliação (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune) +* Usar as APIs do Microsoft Graph para configurar os controles e políticas do Intune requer uma licença do Intune +* Uma conta com permissões para administrar o serviço do Intune +* PowerShell v 5.0 no Windows 10 x64 (o PowerShell v 4.0 é o requisito mínimo para os scripts funcionarem corretamente) +* Observação: Para o PowerShell 4.0, você precisará do [Módulo PowershellGet para PS 4.0](https://www.microsoft.com/en-us/download/details.aspx?id=51451) a fim de habilitar o uso da funcionalidade Install-Module +* A primeira utilização desses scripts exige que um Administrador Global do Locatário aceite as permissões do aplicativo + +## Introdução +Após instalar ou atender aos pré-requisitos, execute as etapas a seguir para usar esses scripts: + +#### 1. Uso de script + +1. Baixe o conteúdo do repositório para o seu computador local com Windows +* Extraia os arquivos em uma pasta local (por exemplo, C:\IntuneGraphSamples) +* Execute o PowerShell x64 no menu Iniciar +* Navegue até o diretório (por exemplo, cd C:\IntuneGraphSamples) +* Você pode navegar em cada pasta do repositório local e executar o script de sua escolha +* Exemplo de uso de script de aplicativo: + * Para usar os scripts para Gerenciar Aplicativos em C:\IntuneGraphSamples, execute "cd .\Applications\" + * Quando estiver na pasta, execute .\Application_MDM_Get.ps1 + para obter todos os aplicativos MDM adicionados. Essa sequência de etapas pode ser usada em cada pasta. + +#### 2. Autenticação com o Microsoft Graph +Na primeira vez que executar estes scripts, você será solicitado a fornecer uma conta para autenticação com o serviço: +``` +Please specify your user principal name for Azure Authentication: +``` +Depois de fornecer o nome principal do usuário, um pop-up será aberto para solicitar sua senha. Após uma autenticação bem-sucedida com o Azure Active Directory, o token de usuário dura por uma hora e, quando a hora expirar dentro da sessão do PowerShell, será solicitada uma nova autenticação. + +Se você estiver executando o script pela primeira vez em seu locatário, um pop-up será apresentado: + +``` +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) +``` + +Observação: Se sua conta de usuário se destina ao acesso condicional baseado em dispositivo, seu dispositivo deve estar registrado ou em conformidade para passar na autenticação. + +## Colaboração + +Se quiser contribuir para esse exemplo, confira CONTRIBUTING.MD. + +Este projeto adotou o Código de Conduta do Código Aberto da Microsoft. Para saber mais, confira as Perguntas frequentes sobre o Código de Conduta ou contate opencode@microsoft.com se tiver outras dúvidas ou comentários. + +## Perguntas e comentários + +Gostaríamos de saber a sua opinião sobre o exemplo de PowerShell do Intune. Você pode enviar perguntas e sugestões na seção Questões deste repositório. + +Seus comentários são importantes para nós. Junte-se a nós na página do Stack Overflow. Marque as suas perguntas com \[MicrosoftGraph] e \[Inture]. + + +## Recursos adicionais +* [Documentação da API do Microsoft Graph](https://developer.microsoft.com/en-us/graph/docs) +* [Portal do Microsoft Graph](https://developer.microsoft.com/en-us/graph/graph-explorer) +* [Exemplos de códigos da Microsoft](https://developer.microsoft.com/en-us/graph/code-samples-and-sdks) +* [Documentação do Graph para Intune](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview) + +## Direitos autorais +Copyright (c) 2017 Microsoft. Todos os direitos reservados. + +Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https://opensource.microsoft.com/codeofconduct/). Para saber mais, confira as [Perguntas frequentes sobre o Código de Conduta](https://opensource.microsoft.com/codeofconduct/faq/) ou entre em contato pelo [opencode@microsoft.com](mailto:opencode@microsoft.com) se tiver outras dúvidas ou comentários. diff --git a/README-localized/Readme-ru-ru.md b/README-localized/Readme-ru-ru.md new file mode 100644 index 0000000..afec624 --- /dev/null +++ b/README-localized/Readme-ru-ru.md @@ -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 +--- +# Примеры для Intune Graph + +Этот репозиторий примеров скриптов PowerShell демонстрирует, как получать доступ к ресурсам службы Intune. Для этого совершаются HTTPS-запросы RESTful API к API Microsoft Graph из PowerShell. + +Документация для Intune и Microsoft Graph можно найти здесь [документации Intune Graph](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview). + +Эти примеры демонстрируют типичные действия администратора Intune или партнера Microsoft по управлению ресурсами Intune. + +Следующие примеры включены в этот репозиторий: +- 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 + +Скрипты лицензируются «как есть». под лицензией MIT. + +#### Заявление об отказе +Некоторые образцы сценариев получают информацию от вашего клиента Intune, а другие создают, удаляют или обновляют данные в вашем клиенте Intune.  Понять влияние каждого примера сценария до его запуска; образцы должны быть запущены с использованием непроизводственного или «тестового» счета арендатора.  + +## Использование API Graph для Intune +API-интерфейс Intune обеспечивает программный доступ к информации Intune для вашего клиента, и API выполняет те же операции Intune, что и через портал Azure.   + +Intune предоставляет данные в Microsoft Graph так же, как и другие облачные сервисы, с богатой информацией об объектах и навигацией по отношениям.  Используйте Microsoft Graph для объединения информации из других служб и Intune для создания многофункциональных межсервисных приложений для ИТ-специалистов или конечных пользователей.      + +## Предварительные требования +Для использования этих примеров Microsoft Graph API Intune PowerShell требуется следующее: +* Установите модуль AzureAD PowerShell, запустив «Install-Module AzureAD» или «Install-Module AzureADPreview» из командной строки PowerShell с повышенными привилегиями. +* Клиент Intune, который поддерживает портал Azure с помощью производственная или пробная лицензия (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune) +* Для использования API-интерфейсов Microsoft Graph для настройки элементов управления и политик Intune требуется лицензия Intune. +* Учетная запись с разрешениями на администрирование службы Intune. +* PowerShell v5.0 в Windows 10 x64 (PowerShell v4.0 является минимальным требованием для правильной работы сценариев). +* Примечание. В PowerShell 4,0 для работы с приложением PowerShell необходимо использовать модуль [PowershellGet для PS 4,0](https://www.microsoft.com/en-us/download/details.aspx?id=51451), позволяющий использовать функциональные возможности модуля +* при первом использовании этих сценариев необходимо, чтобы глобальный администратор клиента принимал разрешения приложения. + +## Начало работы +После того, как предварительные условия установлены или выполнены, выполните следующие шаги для использования этих сценариев: + +#### 1. Использование сценария + +1. Загрузите содержимое репозитория на локальный компьютер с Windows +* Извлечение файлов в локальную папку (например, C:\IntuneGraphSamples) +* Запустите PowerShell x64 из меню «Пуск» +* Перейдите в каталог (например, cd C:\IntuneGraphSamples). +* Для каждой папки в локальном репозитории вы можете перейти к этому каталогу, а затем запустить скрипт на ваш выбор +* Пример использования скрипта приложения: + * Чтобы использовать сценарии управления приложениями, в C:\IntuneGraphSamples, run "cd .\Applications\" + * Попав в папку, запустите.\Application_MDM_Get.ps1, + чтобы получить все приложения, добавленные в MDM. Эту последовательность шагов можно использовать для каждой папки .... + +#### 2. Аутентификация с помощью Microsoft Graph +При первом запуске этих сценариев вам будет предложено предоставить учетную запись для аутентификации в службе: +``` +Please specify your user principal name for Azure Authentication: +``` +После того, как вы предоставите имя пользователя, откроется всплывающее окно с запросом вашего пароля. После успешной проверки подлинности с помощью Azure Active Directory токен пользователя будет действовать в течение часа, а по истечении часа в сеансе PowerShell вам будет предложено пройти повторную проверку подлинности. + +Если вы в первый раз запускаете скрипт для своего арендатора, появится всплывающее окно с указанием: + +``` +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) +``` + +Примечание. Если ваша учетная запись предназначена для условного доступа на основе устройства, ваше устройство должно быть зарегистрировано или соответствовать требованиям для прохождения аутентификации. + +## Участие + +Если вы хотите внести свой вклад в этот образец, см. CONTRIBUTING.MD. + +В этом проекте принят кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации см. FAQ по Кодексу поведения или свяжитесь с opencode@microsoft.com с любыми дополнительными вопросами или комментариями. + +## Вопросы и комментарии + +Мы хотели бы получить ваши отзывы о образце Intune PowerShell. Вы можете присылать нам свои вопросы и предложения в разделе «Проблемы» этого репозитория. + +Ваш отзыв важен для нас. Для связи с нами используйте сайт Stack Overflow. Отметьте свои вопросы с помощью \[MicrosoftGraph] и \[intune]. + + +## Дополнительные ресурсы +* [Документация по Microsoft Graph API](https://developer.microsoft.com/en-us/graph/docs) +* [Портал Microsoft Graph](https://developer.microsoft.com/en-us/graph/graph-explorer) +* [Примеры программного кода Майкрософт](https://developer.microsoft.com/en-us/graph/code-samples-and-sdks) +* [Документация Intune Graph](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview) + +## Авторские права +(c) Корпорация Майкрософт (Microsoft Corporation), 2017. Все права защищены. + +Этот проект соответствует [Правилам поведения разработчиков открытого кода Майкрософт](https://opensource.microsoft.com/codeofconduct/). Дополнительные сведения см. в разделе [часто задаваемых вопросов о правилах поведения](https://opensource.microsoft.com/codeofconduct/faq/). Если у вас возникли вопросы или замечания, напишите нам по адресу [opencode@microsoft.com](mailto:opencode@microsoft.com). diff --git a/README-localized/Readme-zh-cn.md b/README-localized/Readme-zh-cn.md new file mode 100644 index 0000000..b9db01a --- /dev/null +++ b/README-localized/Readme-zh-cn.md @@ -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 +--- +# Intune Graph 示例 + +此 PowerShell 示例脚本的存储库演示如何访问 Intune 服务资源。他们通过从 PowerShell 向 Microsoft Graph API 发出 HTTPS RESTful API 请求来证明这一点。 + +有关 Intune 和 Microsoft Graph 的文档,请查看[Intune Graph 文档](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview)。 + +这些示例演示了 Intune 管理员或 Microsoft 合作伙伴管理 Intune 资源的典型操作。 + +下列示例包含在此存储库中: +- 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 + +在 MIT 许可下,脚本按“原样”授予许可。 + +#### 免责声明 +部分脚本示例从 Intune 租户检索信息,其他脚本在 Intune 租户中创建、删除或更新数据。  运行前,了解每个示例脚本的影响。应使用非生产或“测试”租户帐户运行示例。  + +## 使用 Intune Graph API +Intune Graph API 允许以编程方式访问租户的 Intune 信息,API 会执行 的 Intune 操作与通过 Azure 门户执行的操作相同。   + +Intune 向 Microsoft Graph 提供数据的方式与其他云服务相同,具有丰富的实体信息和关系导航。  使用 Microsoft Graph 将来自其他服务和 Intune 的信息进行组合,为 IT 专业人员和最终用户构建丰富的跨服务应用程序。      + +## 先决条件 +使用这些 Microsoft Graph API Intune PowerShell 示例需要下列内容: +* 通过在提升的 PowerShell 命令提示符处运行 'Install-Module AzureAD' 或 'Install-Module AzureADPreview' 安装 AzureAD PowerShell 模块 +* 具有生产或试用许可证,支持 Azure 门户的 Intune 租户 (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune) +* 使用 Microsoft Graph APIs 来配置 Intune 控件和策略需要 Intune 许可证。 +* 一个具有管理 Intune 服务权限的账户 +* 适用于 Windows 10 x64 的 PowerShell v5.0(PowerShell v4.0 是正确运行脚本的最低要求) +* 注意:对于PowerShell 4.0 ,将需要 [PowershellGet Module for PS 4.0](https://www.microsoft.com/en-us/download/details.aspx?id=51451) 以启用使用安装模块功能 +* 首次使用这些脚本,需要租户的全局管理员接受应用的权限 + +## 开始使用 +安装或满足先决条件后,执行以下步骤以使用这些脚本: + +#### 1.脚本使用 + +1. 下载存储库的内容至本地 Windows 计算机 +* 提取文件至本地文件夹(如:C:\IntuneGraphSamples) +* 从开始菜单运行 PowerShell x64 +* 浏览至目录(如 cd C:\IntuneGraphSamples) +* 对于本地存储库中的各文件夹,可浏览至目录并随后运行选定的脚本 +* 示例应用脚本使用: + * 如果要使用来自 C:\IntuneGraphSamples 的“管理应用脚本”,运行 "cd .\Applications\" + * 在文件夹中运行 .\Application_MDM_Get.ps1 + 以获得所有 MDM 添加的应用后,此步骤顺序可用于各文件夹.... + +#### 2.使用 Microsoft Graph 验证身份 +首次运行这些脚本时,系统将要求提供账户,对这些服务进行身份验证: +``` +Please specify your user principal name for Azure Authentication: +``` +提供用户主体名称后,弹出窗口将打开密码提示。成功使用 Azure Active Directory 验证身份后,用户令牌将持续一小时,在 PowerShell 会话内一小时结束后,系统将要求重新进行身份验证。 + +如果首次针对租户运行脚本,弹出窗口将出现,注明: + +``` +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) +``` + +注意:如果用户账户面向基于设备的条件性访问,设备必须注册或兼容,才能通过身份验证。 + +## 参与 + +如果想要参与本示例,请参阅 CONTRIBUTING.MD。 + +此项目已采用“Microsoft 开放源代码行为准则”。有关详细信息,请参阅“行为准则常见问题解答”。如有其他任何问题或意见,也可联系 opencode@microsoft.com。 + +## 问题和意见 + +我们乐意倾听你有关 Intune PowerShell 示例的反馈。你可通过该存储库中的“问题”部分向我们发送问题和建议。 + +我们非常重视你的反馈意见。请在堆栈溢出上与我们联系。使用 \[MicrosoftGraph]和 \[intune] 标记出你的问题。 + + +## 其他资源 +* [Microsoft Graph API 文档](https://developer.microsoft.com/en-us/graph/docs) +* [Microsoft Graph 门户](https://developer.microsoft.com/en-us/graph/graph-explorer) +* [Microsoft 代码示例](https://developer.microsoft.com/en-us/graph/code-samples-and-sdks) +* [Intune Graph 文档](https://developer.microsoft.com/en-us/graph/docs/api-reference/beta/resources/intune_graph_overview) + +## 版权信息 +版权所有 (c) 2017 Microsoft。保留所有权利。 + +此项目已采用 [Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。有关详细信息,请参阅[行为准则常见问题解答](https://opensource.microsoft.com/codeofconduct/faq/)。如有其他任何问题或意见,也可联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。