Updated cloud katana docs, automation and PS scripts

Author: Cyb3rWard0g

.gitignore

@@ -5,6 +5,7 @@
 
 # Jupyter Book build
 docs/_build/
+.vscode/
 
 # User-specific files
 *.rsuser

.vscode/extensions.json

@@ -3,53 +3,49 @@ root: intro
 parts:
 - caption: Getting Started
   chapters:
-  - file: prepare
   - file: deploy/azure/intro
     sections:
     - file: deploy/azure/arm
-    - file: deploy/azure/demos
-  - file: deploy/local/intro
-    sections:
-    - file: deploy/local/demos
 - caption: Internals
   chapters:
-  - file: internals/design/intro
-  - file: internals/schema
+  - file: learn/principles/intro
+  - file: learn/schema
+  - file: learn/simulation
 - caption: Targeted Notebooks
   chapters:
-  - file: notebooks/windows/intro
+  - file: simulate/windows/intro
     sections:
-    - file: notebooks/windows/discovery/intro
+    - file: simulate/windows/discovery/intro
       sections:
-      - file: notebooks/windows/discovery/list_windows_firewall_rules_via_netsh
-      - file: notebooks/windows/discovery/list_open_egress_ports_via_.net_tcpclient_class
-  - file: notebooks/azure/intro
+      - file: simulate/windows/discovery/list_windows_firewall_rules_via_netsh
+      - file: simulate/windows/discovery/list_open_egress_ports_via_.net_tcpclient_class
+  - file: simulate/azure/intro
     sections:
-    - file: notebooks/azure/collection/intro
+    - file: simulate/azure/collection/intro
       sections:
-      - file: notebooks/azure/collection/get_my_mailbox_messages
-      - file: notebooks/azure/collection/get_user_mailbox_messages
-    - file: notebooks/azure/discovery/intro
+      - file: simulate/azure/collection/get_my_mailbox_messages
+      - file: simulate/azure/collection/get_user_mailbox_messages
+    - file: simulate/azure/discovery/intro
       sections:
-      - file: notebooks/azure/discovery/get_azure_ad_application_metadata
-      - file: notebooks/azure/discovery/get_azure_ad_directory_roles
-      - file: notebooks/azure/discovery/get_azure_ad_groups
-      - file: notebooks/azure/discovery/get_azure_ad_owners_of_an_azure_ad_group_or_directory_role
-      - file: notebooks/azure/discovery/get_azure_ad_oauth_permission_grants
-      - file: notebooks/azure/discovery/get_owners_of_an_azure_ad_application_or_service_principal
-      - file: notebooks/azure/discovery/get_azure_ad_resources_and_graph_them
-      - file: notebooks/azure/discovery/get_azure_ad_service_principal_metadata
-      - file: notebooks/azure/discovery/get_azure_ad_users
-    - file: notebooks/azure/persistence/intro
+      - file: simulate/azure/discovery/get_azure_ad_application_metadata
+      - file: simulate/azure/discovery/get_azure_ad_directory_roles
+      - file: simulate/azure/discovery/get_azure_ad_groups
+      - file: simulate/azure/discovery/get_azure_ad_owners_of_an_azure_ad_group_or_directory_role
+      - file: simulate/azure/discovery/get_azure_ad_oauth_permission_grants
+      - file: simulate/azure/discovery/get_owners_of_an_azure_ad_application_or_service_principal
+      - file: simulate/azure/discovery/get_azure_ad_resources_and_graph_them
+      - file: simulate/azure/discovery/get_azure_ad_service_principal_metadata
+      - file: simulate/azure/discovery/get_azure_ad_users
+    - file: simulate/azure/persistence/intro
       sections:
-      - file: notebooks/azure/persistence/add_new_owner_to_azure_ad_application
-      - file: notebooks/azure/persistence/add_password_to_azure_ad_application
-      - file: notebooks/azure/persistence/add_new_member_to_azure_ad_directory_role
-      - file: notebooks/azure/persistence/add_new_member_to_azure_ad_group
-      - file: notebooks/azure/persistence/add_new_owner_to_azure_ad_service_principal
-      - file: notebooks/azure/persistence/add_password_to_azure_ad_service_principal
-      - file: notebooks/azure/persistence/add_new_domain_to_azure_ad_tenant
-      - file: notebooks/azure/persistence/grant_permission_to_azure_ad_application
-      - file: notebooks/azure/persistence/create_new_azure_ad_application
-      - file: notebooks/azure/persistence/create_new_azure_ad_service_principal_for_application
-      - file: notebooks/azure/persistence/update_azure_ad_application_required_resource_access
+      - file: simulate/azure/persistence/add_new_owner_to_azure_ad_application
+      - file: simulate/azure/persistence/add_password_to_azure_ad_application
+      - file: simulate/azure/persistence/add_new_member_to_azure_ad_directory_role
+      - file: simulate/azure/persistence/add_new_member_to_azure_ad_group
+      - file: simulate/azure/persistence/add_new_owner_to_azure_ad_service_principal
+      - file: simulate/azure/persistence/add_password_to_azure_ad_service_principal
+      - file: simulate/azure/persistence/add_new_domain_to_azure_ad_tenant
+      - file: simulate/azure/persistence/grant_permission_to_azure_ad_application
+      - file: simulate/azure/persistence/create_new_azure_ad_application
+      - file: simulate/azure/persistence/create_new_azure_ad_service_principal_for_application
+      - file: simulate/azure/persistence/update_azure_ad_application_required_resource_access

.vscode/launch.json

@@ -1,10 +1,26 @@
 # Azure Resource Manager Template
 
+## Authenticate to Azure
+
+Use the Azure CLI command `az login` to authenticate to Azure AD with an account to deploy resources in Azure.
+
+```PowerShell
+az login
+```
+
+## Clone Project
+
+```PowerShell
+git clone https://github.com/Azure/Cloud-Katana
+```
+
 ## Create Resource Group
 
 Create a resource group to deploy all Cloud Katana resources in it.
 
-![](../../images/CreateResourceGroup.png)
+```PowerShell
+az group create --name MyResourceGroup --location eastus
+```
 
 ## Import Cloud Katana Tools Module
 
@@ -46,7 +62,7 @@ Once the managed identity is created, we need to grant all the required permissi
 
 **Reference**: [https://docs.microsoft.com/en-us/graph/permissions-reference#application-permissions-4](https://docs.microsoft.com/en-us/graph/permissions-reference#application-permissions-4)
 
-You can use another function from the Cloud Katana PowerShell module to grant permissions to the deployment managed identity.
+You can use another function from the Cloud Katana Tools module to grant permissions to the deployment managed identity.
 
 ```PowerShell
 Grant-CKTPermissions -SvcPrincipalId $identity.principalId -PermissionsList @('Application.ReadWrite.All','AppRoleAssignment.ReadWrite.All','DelegatedPermissionGrant.ReadWrite.All','User.Read.All') -PermissionsType application -verbose