Merge pull request Azure#40 from Azure/Pwi70064tim

Pwi70064tim

Author: TaraMeyer

Azure AD Cmdlets/AzureAD/v2/Add-AzureADDeviceRegisteredUser.md

@@ -21,6 +21,21 @@ The **Add-AzureADDeviceRegisteredUser** cmdlet adds a registered user for an Azu
 
 ## EXAMPLES
 
+### Example 1: Add a user as a registered user
+```
+PS C:\> $User = Get-AzureADUser -Top 1
+PS C:\> $Device = Get-AzureADDevice -Top 1
+PS C:\> Add-AzureADDeviceRegisteredUser -ObjectId $Device.ObjectId -RefObjectId $User.ObjectId
+```
+
+The first command gets a user by using the [Get-AzureADUser](./Get-AzureADUser.md) cmdlet, and then stores it in the $User variable. 
+
+The second command gets a device by using the [Get-AzureADDevice](./Get-AzureADDevice.md) cmdlet, and then stores it in the $Device variable.
+
+The final command adds the user in $User as the registered user for the device in $Device. 
+Both parameters use the **ObjectId** property of specified object. 
+
+
 ## PARAMETERS
 
 ### -ObjectId
@@ -60,6 +75,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## RELATED LINKS
 
+[Get-AzureADDevice](./Get-AzureADDevice.md)
+
 [Get-AzureADDeviceRegisteredUser](./Get-AzureADDeviceRegisteredUser.md)
 
+[Get-AzureADUser](./Get-AzureADUser.md)
+
 [Remove-AzureADDeviceRegisteredUser](./Remove-AzureADDeviceRegisteredUser.md)

Azure AD Cmdlets/AzureAD/v2/Add-AzureADServicePrincipalOwner.md

@@ -22,6 +22,19 @@ The **Add-AzureADServicePrincipalOwner** cmdlet adds an owner to a service princ
 
 ## EXAMPLES
 
+### Example 1: Add a user as an owner to a service principal
+```
+PS C:\> $ServicePrincipalId = (Get-AzureADServicePrincipal -Top 1).ObjectId
+PS C:\> $OwnerId = (Get-AzureADUser -Top 1).ObjectId
+PS C:\> Add-AzureADServicePrincipalOwner -ObjectId $ServicePrincipalId -RefObjectId -$OwnerId
+```
+
+The first command gets the object ID of a service principal by using the [Get-AzureADServicePrincipal](./Get-AzureADServicePrincipal.md) cmdlet, and then stores it in the $ServicePrincipalId variable. 
+
+The second command gets the object ID a user by using the [Get-AzureADUser](./Get-AzureADUser.md) cmdlet, and then stores it in the $OwnerId variable. 
+
+The final command adds the user specified by $OwnerId an owner to a service principal specified by $ServicePrincipalId.
+
 ## PARAMETERS
 
 ### -InformationAction
@@ -102,7 +115,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## RELATED LINKS
 
+[Get-AzureADServicePrincipal](./Get-AzureADServicePrincipal.md)
+
 [Get-AzureADServicePrincipalOwner](./Get-AzureADServicePrincipalOwner.md)
 
-[Remove-AzureADServicePrincipalOwner](./Remove-AzureADServicePrincipalOwner.md)
+[Get-AzureADUser](./Get-AzureADUser.md)
 
+[Remove-AzureADServicePrincipalOwner](./Remove-AzureADServicePrincipalOwner.md)

Azure AD Cmdlets/AzureAD/v2/AzureActiveDirectory.md

@@ -124,6 +124,9 @@ A collection that contains the extension properties registered with the director
 ### [Get-AzureADGroup](Get-AzureADGroup.md)
 Get a group by objectId
 
+### [Get-AzureADExtensionProperty](/.Get-AzureADExtensionProperty.md) 
+Gets  extension properties registered with Azure AD. 
+
 ### [Get-AzureADGroupAppRoleAssignment](Get-AzureADGroupAppRoleAssignment.md)
 Get group application role assignments.
 
@@ -136,6 +139,9 @@ Get owners of a group.
 ### [Get-AzureADMSGroup](Get-AzureADMSGroup.md)
 Retrieves a group from the directory
 
+### [Get-AzureADMSGroup](./Get-AzureADMSGroup.md) 
+Gets information about groups in Azure AD. 
+
 ### [Get-AzureADOAuth2PermissionGrant](Get-AzureADOAuth2PermissionGrant.md)
 Get a list of all oAuth2PermissionGrants granted by users within the directory.
 
@@ -261,6 +267,9 @@ Assign a group of users to an application role.
 
 ### [New-AzureADMSInvitation](New-AzureADMSInvitation.md)
 
+### [New-AzureADMSGroup](./New-AzureADMSGroup) 
+Creates an Azure AD group. 
+
 ### [New-AzureADObjectSetting](New-AzureADObjectSetting.md)
 Creates a settings object in Azure Active Directory.
 
@@ -346,6 +355,9 @@ Removes an owner from a group.
 ### [Remove-AzureADMSGroup](Remove-AzureADMSGroup.md)
 This cmdlet removes a group from the directory
 
+### [Remove-AzureADMSGroup](./Remove-AzureADMSGroup.md) 
+Removes an Azure AD group. 
+
 ### [Remove-AzureADOAuth2PermissionGrant](Remove-AzureADOAuth2PermissionGrant.md)
 Delete an oAuth2PermissionGrant.
 
@@ -392,6 +404,12 @@ Invalidates all of the currently signed in user's refresh tokens issued to appli
 ### [Revoke-AzureADUserAllRefreshToken](Revoke-AzureADUserAllRefreshToken.md)
 Invalidates all of the user's refresh tokens issued to applications (as well as session cookies in a user's browser), by resetting the refreshTokensValidFromDateTime user property to the current date-time
 
+### [Revoke-AzureADSignedInUserAllRefreshToken](./Revoke-AzureADSignedInUserAllRefreshToken.md) 
+Invalidates the refresh tokens issued to applications for the current user.  
+
+### [Revoke-AzureADUserAllRefreshToken](./Revoke-AzureADUserAllRefreshToken.md) 
+Invalidates the refresh tokens issued to applications for a user. 
+
 ### [Select-AzureADGroupIdsContactIsMemberOf](Select-AzureADGroupIdsContactIsMemberOf.md)
 From a list of groups Ids select those that the contact is a member of.
 
@@ -431,6 +449,9 @@ Updates a specific group in Azure Active Directory
 ### [Set-AzureADMSGroup](Set-AzureADMSGroup.md)
 Set a group's attributes
 
+### [Set-AzureADMSGroup](./Set-AzureADMSGroup.md) 
+Changes attribute values on an Azure AD group. 
+
 ### [Set-AzureADObjectSetting](Set-AzureADObjectSetting.md)
 Updates settings in Azure Active Directory.
 

Azure AD Cmdlets/AzureAD/v2/Disconnect-AzureAD.md

@@ -22,6 +22,13 @@ The **Disconnect-AzureAD** cmdlet disconnects the current session from an Azure
 
 ## EXAMPLES
 
+### Example 1: Disconnect your session from a tenant
+```
+PS C:\> Disconnect-AzureAD
+```
+
+This command disconnects your session from a tenant.
+
 ## PARAMETERS
 
 ### -InformationAction
@@ -105,4 +112,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## RELATED LINKS
 
 [Connect-AzureAD](./Connect-AzureAD.md)
-

Azure AD Cmdlets/AzureAD/v2/Enable-AzureADDirectoryRole.md

@@ -22,6 +22,35 @@ The **Enable-AzureADDirectoryRole** cmdlet activates an existing directory role
 
 ## EXAMPLES
 
+### Example 1: Enable a directory role
+```
+PS C:\> $InviterRole = Get-AzureADDirectoryRoleTemplate | Where-Object {$_.DisplayName -eq "Guest Inviter"}
+PS C:\> $InviterRole
+
+ObjectId                             DisplayName   Description
+--------                             -----------   -----------
+95e79109-95c0-4d8e-aee3-d01accf2d47b Guest Inviter Guest Inviter has access to invite guest users.
+
+PS C:\> $Role = New-Object Microsoft.Open.AzureAD.Model.DirectoryRole
+PS C:\> $Role.RoleTemplateId = $InviterRole.ObjectId
+PS C:\> Enable-AzureADDirectoryRole -DirectoryRole $Role
+
+ObjectId                             DisplayName   Description
+--------                             -----------   -----------
+03618579-3c16-4765-9539-86d9163ee3d9 Guest Inviter Guest Inviter has access to invite guest users.
+```
+
+The first command gets an inviter role that has the display name Guest Inviter by using the [Get-AzureADDirectoryRoleTemplate](./Get-AzureADDirectoryRoleTemplate.md) cmdlet. 
+The command stores Guest Inviter in the $InviterRole variable. 
+
+The second command displays the contents of $InviterRole.
+
+The third command creates a **DirectoryRole** object, and then stores it in the $Role variable.
+
+The forth command modifies the **RoleTemplateId** property of $Role to be the role in $InviterRole.
+
+The final command enables the directory role in $Role.
+
 ## PARAMETERS
 
 ### -DirectoryRole
@@ -89,4 +118,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 [Get-AzureADDirectoryRole](./Get-AzureADDirectoryRole.md)
 
-
+[Get-AzureADDirectoryRoleTemplate](./Get-AzureADDirectoryRoleTemplate.md)

Azure AD Cmdlets/AzureAD/v2/Get-AzureADContact.md

@@ -29,6 +29,17 @@ The **Get-AzureADContact** cmdlet gets a contact from Azure Active Directory.
 
 ## EXAMPLES
 
+### Example 1 Retrieve all contact objects in the directory
+```
+PS C:\> Get-AzureADContact
+
+ObjectId                             Mail                DisplayName
+--------                             ----                -----------
+b052db07-e7ec-4c0e-b481-a5ba550b9ee7 [email protected] Contoso Contact
+```
+
+This command retrieves all contact objects in the directory.
+
 ## PARAMETERS
 
 ### -Filter

Azure AD Cmdlets/AzureAD/v2/Get-AzureADContactDirectReport.md

@@ -22,6 +22,16 @@ The **Get-AzureADContactDirectReport** cmdlet gets the direct reports for a cont
 
 ## EXAMPLES
 
+### Example 1: Get the direct reports of a contact
+```
+PS C:\> $Contact = Get-AzureADContact -Top 1
+PS C:\> Get-AzureADContactDirectReport -ObjectId $Contact.ObjectId
+```
+
+The first command gets a contact by using the [Get-AzureADContact](./Get-AzureADContact.md) cmdlet, and then stores it in the $Contact variable.
+
+The second command gets the direct reports for $Contact.
+
 ## PARAMETERS
 
 ### -InformationAction
@@ -104,3 +114,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## RELATED LINKS
 
+[Get-AzureADContact](./Get-AzureADContact.md)

Azure AD Cmdlets/AzureAD/v2/Get-AzureADContactManager.md

@@ -22,6 +22,17 @@ The **Get-AzureADContactManager** cmdlet gets the manager of a contact in Azure
 
 ## EXAMPLES
 
+### Example 1: Get the manager of a contact
+```
+PS C:\> $Contact = Get-AzureADContact -Top 1
+PS C:\> Get-AzureADContactManager -ObjectId $Contact.ObjectId
+```
+
+The first command gets a contact by using the [Get-AzureADContact](./Get-AzureADContact.md) cmdlet, and then stores it in the $Contact variable.
+
+The second command gets the manager for $Contact.
+
+
 ## PARAMETERS
 
 ### -InformationAction
@@ -88,8 +99,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 
 ## RELATED LINKS
+[Get-AzureADContact](./Get-AzureADContact.md) 
 
 [Remove-AzureADContactManager](./Remove-AzureADContactManager.md)
-[Set-AzureADContactManager](./Set-AzureADContactManager.md)
-
 
+[Set-AzureADContactManager](./Set-AzureADContactManager.md)

Azure AD Cmdlets/AzureAD/v2/Get-AzureADContactMembership.md

@@ -22,6 +22,20 @@ The **Get-AzureADContactMembership** cmdlet gets a contact membership in Azure A
 
 ## EXAMPLES
 
+### Example 1: Get the memberships of a contact
+```
+PS C:\> $Contact = Get-AzureADContact -Top 1
+PS C:\> Get-AzureADContactMembership -ObjectId $Contact.ObjectId
+
+ObjectId                             ObjectType
+--------                             ----------
+0015df25-808e-4715-9c24-a6929c25c201 Group
+```
+
+The first command gets a contact by using the [Get-AzureADContact](./Get-AzureADContact.md) cmdlet, and then stores it in the $Contact variable.
+
+The second command gets the memberships for $Contact.
+
 ## PARAMETERS
 
 ### -InformationAction
@@ -104,3 +118,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## RELATED LINKS
 
+[Get-AzureADContact](./Get-AzureADContact.md)

Azure AD Cmdlets/AzureAD/v2/Get-AzureADContract.md

@@ -29,6 +29,13 @@ The **Get-AzureADContract** cmdlet gets a contract from Azure Active Directory.
 
 ## EXAMPLES
 
+### Example 1: Get all contracts in the directory
+```
+Get-AzureADContract
+```
+
+This command gets all contracts in the directory.
+
 ## PARAMETERS
 
 ### -Filter
@@ -125,4 +132,3 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 
 ## RELATED LINKS
-

Azure AD Cmdlets/AzureAD/v2/Get-AzureADDeviceRegisteredOwner.md

@@ -21,6 +21,16 @@ The **Get-AzureADDeviceRegisteredOwner** cmdlet gets the registered owner of a d
 
 ## EXAMPLES
 
+### Example 1: Retrieve the registered owner of a device
+```
+PS C:\> $DevId = (Get-AzureADDevice -Top 1).ObjectId
+PS C:\> Get-AzureADDeviceRegisteredOwner -ObjectId $DevId
+```
+
+The first command gets the object ID of a device by using the [Get-AzureADDevice](./Get-AzureADDevice.md) cmdlet, and then stores it in the $DevId variable.  
+
+The second command gets the registered owner of the device in $DevId.
+
 ## PARAMETERS
 
 ### -ObjectId
@@ -62,5 +72,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## RELATED LINKS
 
 [Add-AzureADDeviceRegisteredOwner](./Add-AzureADDeviceRegisteredOwner.md)
-[Remove-AzureADDeviceRegisteredOwner](./Remove-AzureADDeviceRegisteredOwner.md)
 
+[Get-AzureADDevice](./Get-AzureADDevice.md)
+
+[Remove-AzureADDeviceRegisteredOwner](./Remove-AzureADDeviceRegisteredOwner.md)

Azure AD Cmdlets/AzureAD/v2/Get-AzureADDeviceRegisteredUser.md

@@ -21,6 +21,16 @@ The **Get-AzureADDeviceRegisteredUser** cmdlet gets a registered user for an Azu
 
 ## EXAMPLES
 
+### Example 1: Retrieve the registered users of a device
+```
+PS C:\> $DevId = (Get-AzureADDevice -Top 1).ObjectId
+PS C:\> Get-AzureADDeviceRegisteredUser -ObjectId $DevId
+```
+
+The first command gets the object ID of a device by using the [Get-AzureADDevice](./Get-AzureADDevice.md) cmdlet, and then stores it in the $DevId variable.  
+
+The second command gets the registered users of the device in $DevId.
+
 ## PARAMETERS
 
 ### -ObjectId