Skip to content

Commit 4c03b31

Browse files
authored
Merge pull request #202037 from whhender/short-term-language-updates
Updating Quickstart Language
2 parents 6689ca7 + 8dd7b3b commit 4c03b31

6 files changed

+58
-57
lines changed

articles/purview/create-azure-purview-dotnet.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
---
2-
title: 'Quickstart: Create Microsoft Purview Account using .NET SDK'
3-
description: Create a Microsoft Purview Account using .NET SDK.
2+
title: 'Quickstart: Create Microsoft Purview (formerly Azure Purview) account using .NET SDK'
3+
description: This article will guide you through creating a Microsoft Purview (formerly Azure Purview) account using .NET SDK.
44
author: nayenama
55
ms.author: nayenama
66
ms.service: purview
77
ms.devlang: csharp
88
ms.topic: quickstart
9-
ms.date: 09/27/2021
9+
ms.date: 06/17/2022
1010
ms.custom: mode-api
1111
---
12-
# Quickstart: Create a Microsoft Purview account using .NET SDK
12+
# Quickstart: Create a Microsoft Purview (formerly Azure Purview) account using .NET SDK
1313

14-
In this quickstart, you'll use the [.NET SDK](/dotnet/api/overview/azure/purviewresourceprovider) to create a Microsoft Purview account.
14+
In this quickstart, you'll use the [.NET SDK](/dotnet/api/overview/azure/purviewresourceprovider) to create a Microsoft Purview (formerly Azure Purview) account.
1515

16-
Microsoft Purview is a data governance service that helps you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, Microsoft Purview creates an up-to-date map of your information. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
16+
The Microsoft Purview governance portal surfaces tools like the Microsoft Purview Data Map and Microsoft Purview Data Catalog that help you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, the Microsoft Purview Data Map creates an up-to-date map of your information. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
1717

18-
For more information about Microsoft Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview across your organization, [see our deployment best practices](deployment-best-practices.md).
18+
For more information about the governance capabilities of Microsoft Purview, formerly Azure Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview across your organization, [see our deployment best practices](deployment-best-practices.md)
1919

2020
[!INCLUDE [purview-quickstart-prerequisites](includes/purview-quickstart-prerequisites.md)]
2121

@@ -29,7 +29,7 @@ Download and install [Azure .NET SDK](https://azure.microsoft.com/downloads/) on
2929

3030
## Create an application in Azure Active Directory
3131

32-
1. In [Create an Azure Active Directory application](../active-directory/develop/howto-create-service-principal-portal.md#register-an-application-with-azure-ad-and-create-a-service-principal), create an application that represents the .NET application you are creating in this tutorial. For the sign-on URL, you can provide a dummy URL as shown in the article (`https://contoso.org/exampleapp`).
32+
1. In [Create an Azure Active Directory application](../active-directory/develop/howto-create-service-principal-portal.md#register-an-application-with-azure-ad-and-create-a-service-principal), create an application that represents the .NET application you're creating in this tutorial. For the sign-on URL, you can provide a dummy URL as shown in the article (`https://contoso.org/exampleapp`).
3333
1. In [Get values for signing in](../active-directory/develop/howto-create-service-principal-portal.md#get-tenant-and-app-id-values-for-signing-in), get the **application ID** and **tenant ID**, and note down these values that you use later in this tutorial.
3434
1. In [Certificates and secrets](../active-directory/develop/howto-create-service-principal-portal.md#authentication-two-options), get the **authentication key**, and note down this value that you use later in this tutorial.
3535
1. In [Assign the application to a role](../active-directory/develop/howto-create-service-principal-portal.md#assign-a-role-to-the-application), assign the application to the **Contributor** role at the subscription level so that the application can create data factories in the subscription.
@@ -99,9 +99,9 @@ Next, create a C# .NET console application in Visual Studio:
9999
};
100100
```
101101

102-
## Create a Microsoft Purview account
102+
## Create an account
103103

104-
Add the following code to the **Main** method that creates a **Microsoft Purview Account**.
104+
Add the following code to the **Main** method that will create the **Microsoft Purview Account**.
105105

106106
```csharp
107107
// Create a purview Account
@@ -163,7 +163,7 @@ Go to the **Microsoft Purview accounts** page in the [Azure portal](https://port
163163

164164
## Delete Microsoft Purview account
165165

166-
To programmatically delete a Microsoft Purview Account, add the following lines of code to the program:
166+
To programmatically delete a Microsoft Purview account, add the following lines of code to the program:
167167

168168
```csharp
169169
Console.WriteLine("Deleting the Microsoft Purview Account");
@@ -184,14 +184,14 @@ Console.WriteLine("Check Microsoft Purview account name");
184184
Console.WriteLine(client.Accounts.CheckNameAvailability(checkNameAvailabilityRequest).NameAvailable);
185185
```
186186

187-
The above code with print 'True' if the name is available and 'False' if the name is not available.
187+
The above code with print 'True' if the name is available and 'False' if the name isn't available.
188188

189189
## Next steps
190190

191-
The code in this tutorial creates a purview account, deletes a purview account and checks for name availability of purview account. You can now download the .NET SDK and learn about other resource provider actions you can perform for a Microsoft Purview account.
191+
In this quickstart, you learned how to create a Microsoft Purview (formerly Azure Purview) account, delete the account, and check for name availability. You can now download the .NET SDK and learn about other resource provider actions you can perform for a Microsoft Purview account.
192192

193-
Follow these next articles to learn how to navigate the Microsoft Purview governance portal, create a collection, and grant access to Microsoft Purview.
193+
Follow these next articles to learn how to navigate the Microsoft Purview governance portal, create a collection, and grant access to the Microsoft Purview governance portal.
194194

195195
* [How to use the Microsoft Purview governance portal](use-azure-purview-studio.md)
196+
* [Grant users permissions to the governance portal](catalog-permissions.md)
196197
* [Create a collection](quickstart-create-collection.md)
197-
* [Add users to your Microsoft Purview account](catalog-permissions.md)

articles/purview/create-azure-purview-python.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
---
2-
title: 'Quickstart: Create a Microsoft Purview account using Python'
3-
description: Create a Microsoft Purview account using Python.
2+
title: 'Quickstart: Create a Microsoft Purview (formerly Azure Purview) account using Python'
3+
description: This article will guide you through creating a Microsoft Purview (formerly Azure Purview) account using Python.
44
author: nayenama
55
ms.author: nayenama
66
ms.service: purview
77
ms.devlang: python
88
ms.topic: quickstart
9-
ms.date: 09/27/2021
9+
ms.date: 06/17/2022
1010
ms.custom: mode-api
1111
---
1212

13-
# Quickstart: Create a Microsoft Purview account using Python
13+
# Quickstart: Create a Microsoft Purview (formerly Azure Purview) account using Python
1414

15-
In this quickstart, you’ll create a Microsoft Purview account programatically using Python. [Python reference for Microsoft Purview](/python/api/azure-mgmt-purview/) is available, but this article will take you through all the steps needed to create an account with Python.
15+
In this quickstart, you’ll create a Microsoft Purview (formerly Azure Purview) account programatically using Python. [The python reference for Microsoft Purview](/python/api/azure-mgmt-purview/) is available, but this article will take you through all the steps needed to create an account with Python.
1616

17-
Microsoft Purview is a data governance service that helps you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, Microsoft Purview creates an up-to-date map of your information. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
17+
The Microsoft Purview governance portal surfaces tools like the Microsoft Purview Data Map and Microsoft Purview Data Catalog that help you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, the Microsoft Purview Data Map creates an up-to-date map of your information. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
1818

19-
For more information about Microsoft Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview across your organization, [see our deployment best practices](deployment-best-practices.md).
19+
For more information about the governance capabilities of Microsoft Purview, formerly Azure Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview across your organization, [see our deployment best practices](deployment-best-practices.md)
2020

2121
[!INCLUDE [purview-quickstart-prerequisites](includes/purview-quickstart-prerequisites.md)]
2222

@@ -200,10 +200,11 @@ pa = purview_client.accounts.begin_delete(rg_name, purview_name).result()
200200

201201
## Next steps
202202

203-
The code in this tutorial creates a purview account and deletes a purview account. You can now download the Python SDK and learn about other resource provider actions you can perform for a Microsoft Purview account.
203+
In this quickstart, you learned how to create a Microsoft Purview (formerly Azure Purview) account, delete the account, and check for name availability. You can now download the Python SDK and learn about other resource provider actions you can perform for a Microsoft Purview account.
204204

205-
Follow these next articles to learn how to navigate the Microsoft Purview governance portal, create a collection, and grant access to Microsoft Purview.
205+
Follow these next articles to learn how to navigate the Microsoft Purview governance portal, create a collection, and grant access to the Microsoft Purview governance portal.
206206

207207
* [How to use the Microsoft Purview governance portal](use-azure-purview-studio.md)
208+
* [Grant users permissions to the governance portal](catalog-permissions.md)
208209
* [Create a collection](quickstart-create-collection.md)
209-
* [Add users to your Microsoft Purview account](catalog-permissions.md)
210+

articles/purview/create-catalog-portal.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@ ms.custom: mode-ui
1010
---
1111
# Quickstart: Create an account in the Microsoft Purview governance portal
1212

13-
This quickstart describes the steps to Create a Microsft Purview (formerly Azure Purview) account through the Azure portal. Then we'll get started on the process of classifying, securing, and discovering your data in the Microsoft Purview Data Map!
13+
This quickstart describes the steps to Create a Microsoft Purview (formerly Azure Purview) account through the Azure portal. Then we'll get started on the process of classifying, securing, and discovering your data in the Microsoft Purview Data Map!
1414

15-
The Microsoft Purview governance portal surfaces tools like the Microsoft Purview Data Map and Microsoft Purview Data Catalog, that help you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, the Microsoft Purview Data Map creates an up-to-date map of your data estate. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
15+
The Microsoft Purview governance portal surfaces tools like the Microsoft Purview Data Map and Microsoft Purview Data Catalog that help you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, the Microsoft Purview Data Map creates an up-to-date map of your data estate. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
1616

17-
For more information about the governance capabilities of Microsoft Purview, formerly Azure Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview across your organization, [see our deployment best practices](deployment-best-practices.md).
17+
For more information about the governance capabilities of Microsoft Purview, formerly Azure Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview governance services across your organization, [see our deployment best practices](deployment-best-practices.md).
1818

1919
[!INCLUDE [purview-quickstart-prerequisites](includes/purview-quickstart-prerequisites.md)]
2020

articles/purview/create-catalog-powershell.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,30 @@
11
---
2-
title: 'Quickstart: Create a Microsoft Purview account with PowerShell/Azure CLI'
3-
description: This Quickstart describes how to create a Microsoft Purview account using Azure PowerShell/Azure CLI.
2+
title: 'Quickstart: Create a Microsoft Purview (formerly Azure Purview) account with PowerShell/Azure CLI'
3+
description: This Quickstart describes how to create a Microsoft Purview (formerly Azure Purview) account using Azure PowerShell/Azure CLI.
44
author: hophanms
55
ms.author: hophan
6-
ms.date: 10/28/2021
6+
ms.date: 06/17/2022
77
ms.topic: quickstart
88
ms.service: purview
99
ms.custom: devx-track-azurepowershell, mode-api, devx-track-azurecli
1010
ms.devlang: azurecli
1111
#Customer intent: As a data steward, I want create a new Microsoft Purview Account so that I can scan and classify my data.
1212
---
13-
# Quickstart: Create a Microsoft Purview account using Azure PowerShell/Azure CLI
13+
# Quickstart: Create a Microsoft Purview (formerly Azure Purview) account using Azure PowerShell/Azure CLI
1414

1515
In this Quickstart, you'll create a Microsoft Purview account using Azure PowerShell/Azure CLI. [PowerShell reference for Microsoft Purview](/powershell/module/az.purview/) is available, but this article will take you through all the steps needed to create an account with PowerShell.
1616

17-
Microsoft Purview is a data governance service that helps you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, Microsoft Purview creates an up-to-date map of your information. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
17+
The Microsoft Purview governance portal surfaces tools like the Microsoft Purview Data Map and Microsoft Purview Data Catalog that help you manage and govern your data landscape. By connecting to data across your on-premises, multi-cloud, and software-as-a-service (SaaS) sources, the Microsoft Purview Data Map creates an up-to-date map of your information. It identifies and classifies sensitive data, and provides end-to-end linage. Data consumers are able to discover data across your organization, and data administrators are able to audit, secure, and ensure right use of your data.
1818

19-
For more information about Microsoft Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview across your organization, [see our deployment best practices](deployment-best-practices.md).
19+
the governance capabilities of Microsoft Purview, formerly Azure Purview, [see our overview page](overview.md). For more information about deploying Microsoft Purview governance services across your organization, [see our deployment best practices](deployment-best-practices.md).
2020

2121
[!INCLUDE [purview-quickstart-prerequisites](includes/purview-quickstart-prerequisites.md)]
2222

2323
### Install PowerShell
2424

2525
Install either Azure PowerShell or Azure CLI in your client machine to deploy the template: [Command-line deployment](../azure-resource-manager/templates/template-tutorial-create-first-template.md?tabs=azure-cli#command-line-deployment)
2626

27-
## Create a Microsoft Purview account
27+
## Create an account
2828

2929
1. Sign in with your Azure credential
3030

@@ -58,7 +58,7 @@ For more information about Microsoft Purview, [see our overview page](overview.m
5858
5959
---
6060
61-
1. Create a resource group for your Microsoft Purview account. You can skip this step if you already have one:
61+
1. Create a resource group for your account. You can skip this step if you already have one:
6262
6363
# [PowerShell](#tab/azure-powershell)
6464
@@ -76,7 +76,7 @@ For more information about Microsoft Purview, [see our overview page](overview.m
7676
7777
---
7878
79-
1. Create or Deploy the Microsoft Purview account
79+
1. Create or Deploy the account:
8080
8181
# [PowerShell](#tab/azure-powershell)
8282
@@ -132,7 +132,7 @@ For more information about Microsoft Purview, [see our overview page](overview.m
132132
133133
1. The deployment command returns results. Look for `ProvisioningState` to see whether the deployment succeeded.
134134
135-
1. If you deployed the Microsoft Purview account using a service principal, instead of a user account, you will also need to run the below command in the Azure CLI:
135+
1. If you deployed the account using a service principal, instead of a user account, you'll also need to run the below command in the Azure CLI:
136136
137137
```azurecli
138138
az purview account add-root-collection-admin --account-name [Microsoft Purview Account Name] --resource-group [Resource Group Name] --object-id [User Object Id]
@@ -142,10 +142,10 @@ For more information about Microsoft Purview, [see our overview page](overview.m
142142
143143
## Next steps
144144
145-
In this quickstart, you learned how to create a Microsoft Purview account.
145+
In this quickstart, you learned how to create a Microsoft Purview (formerly Azure Purview) account.
146146
147-
Follow these next articles to learn how to navigate the Microsoft Purview governance portal, create a collection, and grant access to Microsoft Purview.
147+
Follow these next articles to learn how to navigate the Microsoft Purview governance portal, create a collection, and grant access to the Microsoft Purview governance portal.
148148
149149
* [How to use the Microsoft Purview governance portal](use-azure-purview-studio.md)
150-
* [Add users to your Microsoft Purview account](catalog-permissions.md)
150+
* [Grant users permissions to the governance portal](catalog-permissions.md)
151151
* [Create a collection](quickstart-create-collection.md)

0 commit comments

Comments
 (0)