You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+14-13Lines changed: 14 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -1,35 +1,36 @@
1
-
# Short URL: aka.ms/office-powershell
1
+
**Short URL: aka.ms/office-powershell**
2
2
3
3
# Overview
4
-
This repository holds reference content of Office PowerShell cmdlets for help purpose. The expert knowledge around Office PowerShell is distributed among customers, MVPs, partners, product teams, support, and other community members. Consumers also have various preferences when consuming knowledge such as a website, PowerShell Get-Help, Windows app, iOS app, Android app, and others. The following diagram illustrates the point.
4
+
This repository holds reference content of Office PowerShell cmdlets for help purpose. The expert knowledge around Office PowerShell is distributed among customers, MVPs, partners, product teams, support, and other community members. Consumers have various preferences when consuming knowledge such as a website, PowerShell Get-Help, Windows app, iOS app, Android app, and others. The following diagram illustrates the point.
5
+
5
6

6
7
7
-
# Learn How To Contribute
8
+
##Learn How To Contribute
8
9
Anyone who is interested can contribute to the Microsoft Office PowerShell reference topics.
9
-
When you contribute your work will go directly into the Microsoft Office products and show up in Get-Help for the given Office cmdlet.
10
+
Your contributions will go directly into the Microsoft Office products and show up in Get-Help for the given Office cmdlet.
10
11
11
12
> Notice that if you are looking into contributing for the **PnP PowerShell cmdlets**, their documentation is automatically generated from the code, and you should be submitting your change towards the original code at https://github.com/SharePoint/PnP-powershell. See, for example, how the attributes are used in the code for the [Get-PnPList](https://github.com/SharePoint/PnP-PowerShell/blob/master/Commands/Lists/GetList.cs) cmdlet.
12
13
13
-
# Quick Start
14
+
##Quick Start
14
15
15
-
## Contribute using the GitHub website
16
+
###Contribute using the GitHub website
16
17
17
18
[](https://support.office.com/en-us/article/edit-powershell-cmdlet-in-github-dcd20227-3764-48ce-ad6e-763af8b48daf?ui=en-US&rs=en-US&ad=US)
18
19
19
-
1. Open your browser, log in to GitHub, and then navigate to https://github.com/microsoftdocs/office-docs-powershell
20
+
1. Open your browser, log in to GitHub, and navigate to https://github.com/microsoftdocs/office-docs-powershell
20
21
2. Browse to the file you want to edit. In this example, we will edit https://github.com/MicrosoftDocs/office-docs-powershell/blob/master/teams/teams-ps/teams/New-Team.md and add a link in the Related Links section.
21
22
3. Click the Edit icon which looks like a pencil in the upper right corner.
22
23

23
24
24
-
4. Your browser will then open the file in an edit window. We want to add a link. So we scroll down to the Related Links section and add the link in the correct format.
25
+
4. Your browser will open the file in an edit window. To add a link, we scroll down to the Related Links section and add the link in the correct format.
25
26

26
27
27
-
**Note** Since you are likely not a maintainer of the Git repository, GitHub will automatically 'Fork' the project into your personal GitHub account. A fork is just an exact copy of the repository in your own account so that you have total access to make edits. You are now 'editing' a copy of the project in your own GitHub account. You can always find it again by looking at your GitHub Repositories in your GitHub Profile (drop-down from your name in the top right).
28
+
**Note** Since you are likely not a maintainer of the Git repository, GitHub will automatically 'Fork' the project into your personal GitHub account. A fork is a copy of the repository in your git account. By forking, you can freely make edits without affecting the original repository. You can always find it again by looking at your GitHub Repositories in your GitHub Profile (drop-down from your name in the top right).
28
29

29
30
30
31
5. You can click the Preview changes link to see what the changes will look like.
31
32
32
-
**IMPORTANT** The layout of headings and subheadings must follow a very specific schema that is required for PowerShell Get-Help.
33
+
**IMPORTANT** The layout of headings and subheadings must follow a schema required for PowerShell Get-Help.
33
34
Any deviation will throw errors in the Pull Request. The schema can be found here: https://github.com/PowerShell/platyPS/blob/master/platyPS.schema.md
34
35
35
36
6. Once you are satisfied with your work, go to the **Propose file change** area at the bottom of the topic. Enter a title and other description information, and then click **Propose file change**.
@@ -42,9 +43,9 @@ Looking for more in-depth content? Check out the following:
42
43
*[Using more advanced tools with the PowerShell GitHub repo](repo_docs/ADVANCED.md)
43
44
*[Creating content for brand new cmdlets](repo_docs/NEW_CMDLETS.md)
44
45
45
-
# Microsoft Open Source Code of Conduct
46
+
##Microsoft Open Source Code of Conduct
46
47
47
-
## Contributing
48
+
###Contributing
48
49
49
50
This project welcomes contributions and suggestions. Most contributions require you to agree to a
50
51
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
@@ -68,7 +69,7 @@ see the [LICENSE](LICENSE) file, and grant you a license to any code in the repo
68
69
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation
69
70
may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.
70
71
The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
71
-
Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
72
+
Microsoft's general trademark guidelines can be found at https://go.microsoft.com/fwlink/?LinkID=254653.
72
73
73
74
Privacy information can be found at https://privacy.microsoft.com/en-us/
Copy file name to clipboardExpand all lines: exchange/docs-conceptual/exchange-eop/exchange-online-protection-powershell.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ Exchange Online Protection PowerShell is the administrative interface that enabl
18
18
19
19
- To create a remote PowerShell session to your Exchange Online Protection organization, see [Connect to Exchange Online Protection PowerShell](connect-to-exchange-online-protection-powershell.md).
20
20
21
-
- For a sample script that lets admins who manage multiple tenants (companies) apply configuration settings to their tenants, see [Sample script for applying EOP settings to multiple tenants](http://technet.microsoft.com/library/e87e84e1-7be0-44bf-a414-d91d60ed8817.aspx).
21
+
- For a sample script that lets admins who manage multiple tenants (companies) apply configuration settings to their tenants, see [Sample script for applying EOP settings to multiple tenants](https://technet.microsoft.com/library/e87e84e1-7be0-44bf-a414-d91d60ed8817.aspx).
22
22
23
23
- The following introductory video shows you how to connect to and use Exchange Online Protection PowerShell.
Copy file name to clipboardExpand all lines: exchange/docs-conceptual/exchange-online/connect-to-exchange-online-powershell/connect-to-exchange-online-powershell.md
+25-23Lines changed: 25 additions & 23 deletions
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ description: "Learn how to use remote PowerShell to connect to Exchange Online."
19
19
Exchange Online PowerShell allows you to manage your Exchange Online settings from the command line. You use Windows PowerShell on your local computer to create a remote PowerShell session to Exchange Online. It's a simple three-step process where you enter your Office 365 credentials, provide the required connection settings, and then import the Exchange Online cmdlets into your local Windows PowerShell session so that you can use them.
20
20
21
21
> [!IMPORTANT]
22
-
> If you want to use multi-factor authentication (MFA) to connect to Exchange Online PowerShell, you need to download and use the Exchange Online Remote PowerShell Module. For more information, see [Connect to Exchange Online PowerShell using multi-factor authentication](mfa-connect-to-exchange-online-powershell.md). If you're an Exchange Online Protection (EOP) standalone customer, and you're using the service to protect on-premises mailboxes, use the connection instructions in the topic [Connect to Exchange Online Protection PowerShell](../../exchange-eop/connect-to-exchange-online-protection-powershell.md). If your EOP subscription is Exchange Enterprise CAL with Services (includes data loss prevention (DLP) and reporting using web services), the connection instructions in this topic will work for you.
22
+
> If you want to use multi-factor authentication (MFA) to connect to Exchange Online PowerShell, you need to download and use the Exchange Online Remote PowerShell Module. For more information, see [Connect to Exchange Online PowerShell using multi-factor authentication](mfa-connect-to-exchange-online-powershell.md). <br/><br/> If you're an Exchange Online Protection (EOP) standalone customer, and you're using the service to protect on-premises mailboxes, use the connection instructions in the topic [Connect to Exchange Online Protection PowerShell](../../exchange-eop/connect-to-exchange-online-protection-powershell.md). If your EOP subscription is Exchange Enterprise CAL with Services (includes data loss prevention (DLP) and reporting using web services), the connection instructions in this topic will work for you.
23
23
24
24
## What do you need to know before you begin?
25
25
@@ -47,22 +47,23 @@ Exchange Online PowerShell allows you to manage your Exchange Online settings fr
47
47
48
48
To require all PowerShell scripts that you download from the internet are signed by a trusted publisher, run the following command in an elevated Windows PowerShell window (a Windows PowerShell window you open by selecting **Run as administrator**):
49
49
50
-
```
51
-
Set-ExecutionPolicy RemoteSigned
52
-
```
50
+
```
51
+
Set-ExecutionPolicy RemoteSigned
52
+
```
53
53
54
54
You need to configure this setting only once on your computer, not every time you connect.
55
55
56
56
> [!TIP]
57
-
> Having problems? Ask for help in the Exchange forums. Visit the forums at: [Exchange Online](https://go.microsoft.com/fwlink/p/?linkId=267542), or [Exchange Online Protection](https://go.microsoft.com/fwlink/p/?linkId=285351).
57
+
> Having problems? Ask for help in the Exchange forums. Visit the forums at: [Exchange Online](https://go.microsoft.com/fwlink/p/?linkId=267542), or [Exchange Online Protection](https://go.microsoft.com/fwlink/p/?linkId=285351).
58
58
59
59
## Connect to Exchange Online PowerShell
60
60
61
61
1. On your local computer, open Windows PowerShell and run the following command.
62
62
63
-
```
64
-
$UserCredential = Get-Credential
65
-
```
63
+
```
64
+
$UserCredential = Get-Credential
65
+
```
66
+
66
67
In the **Windows PowerShell Credential Request** dialog box, type your work or school account and password, and then click **OK**.
67
68
68
69
2. Run the following command.
@@ -71,23 +72,25 @@ Exchange Online PowerShell allows you to manage your Exchange Online settings fr
- For Office 365 operated by 21Vianet, use the _ConnectionUri_ value: `https://partner.outlook.cn/PowerShell`
78
+
79
+
- For Office 365 Germany, use the _ConnectionUri_ value: `https://outlook.office.de/powershell-liveid/`
75
80
76
-
- For Office 365 operated by 21Vianet, use the _ConnectionUri_ value: `https://partner.outlook.cn/PowerShell`
81
+
- For Office 365 Government Community Cloud High (GCC High), use the _ConnectionUri_ value: `https://outlook.office365.us/powershell-liveid/`
77
82
78
-
- For Office 365 Germany, use the _ConnectionUri_ value: `https://outlook.office.de/powershell-liveid/`
79
-
80
-
- If you're behind a proxy server, run this command first: `$ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>`, where the _ProxyAccessType_ value is `IEConfig`, `WinHttpConfig`, or `AutoDetect`.
81
-
82
-
Then, add the following parameter and value to the end of the $Session = ... command: `-SessionOption $ProxyOptions`.
83
-
84
-
For more information, see [New-PSSessionOption](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssessionoption).
83
+
- If you're behind a proxy server, run this command first: `$ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>`, where the _ProxyAccessType_ value is `IEConfig`, `WinHttpConfig`, or `AutoDetect`.
84
+
85
+
Then, add the following parameter and value to the end of the $Session = ... command: `-SessionOption $ProxyOptions`.
86
+
87
+
For more information, see [New-PSSessionOption](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/new-pssessionoption).
85
88
86
89
3. Run the following command.
87
90
88
-
```
89
-
Import-PSSession $Session -DisableNameChecking
90
-
```
91
+
```
92
+
Import-PSSession $Session -DisableNameChecking
93
+
```
91
94
92
95
> [!NOTE]
93
96
> Be sure to disconnect the remote PowerShell session when you're finished. If you close the Windows PowerShell window without disconnecting the session, you could use up all the remote PowerShell sessions available to you, and you'll need to wait for the sessions to expire. To disconnect the remote PowerShell session, run the following command.
@@ -108,7 +111,7 @@ If you receive errors, check the following requirements:
108
111
109
112
- The account you use to connect to Exchange Online must be enabled for remote PowerShell. For more information, see [Enable or disable access to Exchange Online PowerShell](../disable-access-to-exchange-online-powershell.md).
110
113
111
-
- TCP port 80 traffic needs to be open between your local computer and Office 365. It's probably open, but it's something to consider if your organization has a restrictive Internet access policy.
114
+
- TCP port 80 traffic needs to be open between your local computer and Office 365. It's probably open, but it's something to consider if your organization has a restrictive internet access policy.
112
115
113
116
## See also
114
117
@@ -124,5 +127,4 @@ The cmdlets that you use in this topic are Windows PowerShell cmdlets. For more
0 commit comments