Category: PowerShell

Add Alternate Email Address or Recovery Email Address for Office365 Administrator
In Office365, depending on the admin role of an account you may want to add an alternate email address for password recovery. This is a basically a self-service password reset for Administrators of Office365.

Quick way to do this is with PowerShell:
```
#Connect to Office365
Import-Module MSOnline
Connect-MsolService
$O365Cred = Get-Credential
$O365Session = New-PSSession â€“ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell -Credential $O365Cred -Authentication Basic -AllowRedirection
Import-PSSession $O365Session

#Check if the user has an Alternate Email Address (Recovery Address)
Get-MsolUser -UserPrincipalName [email protected] | select -ExpandProperty AlternateEmailaddresses

#Check if the user has an Alternate Email Address (Recovery Address)
Set-MsolUser -UserPrincipalName [email protected] -AlternateEmailAddresses [email protected]
```
If this setting is unset for an administrator, Office365 gives you a nice reminder about adding an alternate email address in case your primary account gets locked out.

You can add this information when first setting up the account:

It can also be added for an existing admin user by going to the Gear, Office 365 settings, and edit your settings in the â€˜meâ€™ section, you can enter your mobile phone number and alternate email there.
September 6, 2017
Map a network drive using PowerShell
Make sure you are using the latest version of PowerShell. On Windows 8/10 run it as administrator and type the following:
```
New-PSDrive â€“Name â€œZâ€ â€“PSProvider FileSystem â€“Root â€œ\\fileserver01\shareâ€ â€“Persist
```
Where:

Z – is the Drive Letter

Within ” ” is the path of the network share that will be presented as the root of the drive letter Z

The -Persist parameter so that you can not only see the name of your new drive in Windows explorer, but also know it’s still there the next time you logon.

-Name <String>
Specifies a name for the new drive. For persistent mapped network drives, type a drive letter. For temporary drives type you are not limited to drive letters.
Required? true
Position 1

-PSProvider <String>
Specifies the Windows PowerShell provider, for example, FileType or Registry.
Required? true
Position? 2

-Root <String>
Specifies the data store location, for example, \\Server\Drivers, or a registry key such as HKLM:\Software\Microsoft\Windows NT\CurrentVersion.
Required? true
Position? 3
August 16, 2017
Lists all users last logon time
As administrators we often want to check whichÂ usersÂ have not logged in for quite a while, or what accounts recently accessed a system, etc.

The following script list all users and their last logon time. With the lastloggeduser.csv we can get fancy with excel to find differences based on age and more.
```
$([ADSI]"WinNT://$env:COMPUTERNAME").Children | where {$_.SchemaClassName -eq 'user'} | select @{l='name';e={$_.name}},@{l='LastLogin';e={$_.lastlogin}} | export-csv C:\scripts\lastloggedusers.csv
```
May 8, 2017
Resolve IP Addresses from List of Host Names
If you have a list of hostnames/servers that you need IP addresses for its cumbersome to ping each server and get the ip address.

PowerShell to the rescue!

To do this we need a file called Server.txt with each server’s hostname on each line. I am storing the file in D:\Data\Servers.txt.

Once we run the script below it resolves the ip via DNS and stores to another file called D:\Data\Addresses.txt.

[su_note note_color=”#fafae8″]All the IP addresses are getting pulled from their DNS value.Â [/su_note]
```
function Get-HostToIP($hostname) {     
    $result = [system.Net.Dns]::GetHostByName($hostname)     
    $result.AddressList | ForEach-Object {$_.IPAddressToString } 
} 
 
Get-Content "D:\Data\Servers.txt" | ForEach-Object {(Get-HostToIP($_)) >> d:\data\Addresses.txt}
```
April 25, 2017
Connecting to a remote domain controller using PowerShell
Covering one of the basic day to day task if you are a Windows Administrator; connecting to the domain controller. Â I try to minimize logging onto servers as much as possible. Â Your thought should be around connecting to the server remotely and doing the work as needed instead of natively logging on to it.

I will be discussing two approaches below to connect to a domain controller:
1. Connecting from a client machine on the same domain
2. Connecting from a client machine on a different domain or a workstation/server
Before we get started, and regardless of which approach you take below, the following will need to be installed on the client Windows machine. Primarily you need to get the Active Directory Module for Windows PowerShell installed.

Installing the Active Directory Module

GUI:

The Active Directory for Windows PowerShell is already built-in into Windows Server operating systems (starting from Windows Server 2008 R2), but it is not enabled by default.

On Windows Server 2016, you can install the AD for PowerShell module from theÂ Server ManagerÂ (Add Roles and Features -> Features -> Remote Server Administration Tools -> Role Administration Tools -> AD DS and AD LDS ToolsÂ -> Active Directory module for Windows PowerShell).

PowerShell:

You can also install the module from the PowerShell console using the command:
```
Install-WindowsFeature -Name "RSAT-AD-PowerShell" â€“IncludeAllSubFeature
```
The RSAT-AD-PowerShell can be installed not only on the domain controllers, but also on any domain member server or even a workstation. The PowerShell Active Directory Module is installed automatically when you deploying the Active Directory Domain ServicesÂ (AD DS) role (when promoting server to AD domain controller).

Approach 1: Connecting from a client machine on the same domain

First step you need to do is find all of your domain controllers and allow remote connections to it.

Logon to your one of your domain controllers and open up PowerShell:
```
winrm quickconfig
```
[su_note note_color=”#fafae8″]You need to do this once on each domain controller so you can remotely connect to each one of them at a later time.[/su_note]

You can read more about WinRM here.

Alternatively, the following command can be ran in an elevated Powershell console on the DC. This enables WinRM and configures the firewall so that it can accept incoming commands.
```
Enable-PSRemoting
```
Once that is done you are ready to connect to your domain controller.

Make sure your system is configured to run PowerShell scripts.
```
#Set the ExecutionPolicy to allow execution of scripts
Set-ExecutionPolicy Unrestricted
```
Copy the content below and paste it into your PowerShell Editor. Rename your value of “yourdomaincontroller” to your actual DC Server name.
```
#ConnectAD.ps1
#Connect to your Domain Controller(DC)
#Change the value after the -ComputerName to your know DC

$session = New-PSSession -ComputerName "yourdomaincontroller" -Credential (Get-Credential)
Invoke-Command $session -Scriptblock { Import-Module ActiveDirectory }
Import-PSSession -Session $session -module ActiveDirectory
```
Now all command you enter will be applied to the DC.

To check if your connection is successful. Try the command below to get a list of all of your domain controllers.
```
#Get a list of all domain controllers in your environment
Get-ADDomainController -Filter * | Select-Object name
```
Approach 2: Connecting from a client machine on a different domain or a workstation

Windows Remoting works perfectly for same domain situations, and the set-up is relatively straight-forward. It’s extremely powerful when it works, and offers a highly flexible way to securely execute commands remotely.

Problems arise however when trying to use WinRM in mixed domain environments, or where only one machine is on a domain. This requires some additional configuration steps outlined below.

Logon to your one of your domain controllers and open up PowerShell and run the following:
```
Enable-PSRemoting
```
The following registry key needs to be added to the target domain controllers:
```
New-ItemProperty -name LocalAccountTokenFilterPolicy -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System -propertyType DWord -value 1
```
Make sure the ports are open:

By default, WS-Man andÂ PowerShellÂ remoting useÂ portÂ 5985 and 5986 for connections over HTTP and HTTPS, respectively.

The module is interacting with AD through theÂ Active Directory Web ServiceÂ that must be installed on your domain controller (communication is performed over the TCP portÂ 9389).

[su_note note_color=”#f9f4ca” text_color=”#000000″ radius=”2″]In some environments, you may need to check if the server authentication certs are valid and not expired. Also, in some situations I have seen that if the client is not resolving the FQDN, it is because the DNSzone doesn’t exist in the source domain. Either the zone can be added, or the host file can be modified to add the DC’s FQDN. [/su_note]

Trusted Hosts:

Adding the client IP or name can help avoid errors.

Depending on your environment and what is allowed or not one of the following should work for your situation.

View the computers of TrustedHosts list

To view the list of TrustedHosts added to the machine, type the following command. By default, its value is blank.
```
Get-Item WSMan:\localhost\Client\TrustedHosts
```
Add all computers to the TrustedHosts list

Using the Set-Item cmdlet and the wildcard you can add all the computers to the TrustedHosts list with the following command.
```
Set-Item WSMan:\localhost\Client\TrustedHosts -Value *
```
Add all domain computers to the TrustedHosts list

In the following command, replace .yourdomain.com with your own domain name.
```
Set-Item WSMan:\localhost\Client\TrustedHosts *.yourdomain.com
```
Add specific computers to the TrustedHosts list

You can add specific computers you choose based on their hostname by separating them with a comma (,) using the following command.
```
Set-Item WSMan:\localhost\Client\TrustedHosts -Value <ComputerName>,[<ComputerName>]
```
Where ComputerName can be in the Server01 or Server01.yourdomain.com format
Add a computer to an existing list of TrustedHosts

If you have already added some computers to the TrustedHosts list and want to add an additional computer, without deleting the previous entries, you should use the following method. This is because the TrustedHosts list is updated based on the last Set-Item command you have run overwriting the previous entries.

Use the following command to save the current TrustedHosts computer list to a curList variable.
```
$currentList = (Get-Item WSMan:\localhost\Client\TrustedHosts).value
```
To add a computer to the current list, type the following command by specifying both the variable you created and the computer name you are going to add.
```
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "$currentList , Server01"
```
Alternatively, to avoid using a variable, add the -Concatenate switch to the Set-Item command to add both new and previous entries. For example:
```
Set-Item WSMan:\localhost\Client\TrustedHosts -Concatenate -Value Server02
```
Add computers to the TrustedHosts list using the IP address

Similarly to the previous commands, you can use an IPv4 or IPv6 address. In the case of IPv6, you have to type the address between [].
```
Set-Item WSMan:\localhost\Client\TrustedHosts -Value 10.10.10.1,[0:0:0:0:0:0:0:0]
```
Add computers to the TrustedHosts list using multiple IP address (Most common)
```
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "10.10.10.1, 10.10.10.2"
```
Another way to add trusted hosts is via an elevated Command Prompt:
```
winrm set winrm/config/client @{TrustedHosts="10.0.2.33"}
```
Importing the AD Module:
Before using any cmdlets of the Active Directory module, you need to import it to your PowerShell session (on Windows Server 2012 R2/ Windows 8.1 and newer the module is imported automatically).
```
Import-Module ActiveDirectory
```
With this configuration, it’s now possible to authenticate and execute a command remotely with explicit credentials.

Lets check if it is working:
```
Enter-PSSession -ComputerName 10.0.2.33 -Credential $Credentials
```
It WORKS! 🙂

Common Errors & Solutions:

Error:Â WinRM service started.Â Set-WSManQuickConfig : <f:WSManFaultâ€¦.Â WinRM firewall exception will not work since one of the network connection types on this machine is set to Publicâ€¦â€¦Â Change the network connection type to either Domain or Private and try again.

Solution:Â
```
Enable-PSRemoting -SkipNetworkProfileCheck -Force
```
Explanation:

The above error message indicates that we have set the network to Public in order to enable PowerShell Remoting. Several ways exist to change the connection type. For some reason that only Microsoft knows, you canâ€™t do this in the Network and Sharing Center.

Error:Â Enter-PSSession : Connecting to remote server 10.0.2.33 failed with the following error message : The WinRM client cannot process the requestâ€¦.

Solution:
```
winrm set winrm/config/client @{TrustedHosts="10.0.2.33"}
```
Explanation:

In an Active Directory environment, you can just use the computer name to connect to a remote machine. If you remotely connect to a standalone machine, you usually have to use the IP address instead. If you try to connect to the remote computer with theÂ Enter-PSSession cmdlet using the IP address of the remote machine, PowerShell will throw the above error.

Error:Â Cannot connect to host…

Solution:

Check with your network/ firewall team ifÂ the port 5985, 5986, and 9389 are open.

Explanation:Â

Most of the times the ports are overlooked and are the root cause as to why the connection is not working
April 25, 2017