Adam's AD Admin

Update : version 0.992  now available including DFS-r Hot on the heals of my AD sites module , I have been looking at some file system functions.  This module is driven primarily by my own needs, but after a prompt on the powergui website from someone after a way of managing DFS with powershell (thanks packetboy), this is what I have come up with.  All help files are included with examples, but I will publish the help and examples over time. Requirements This module has been built on a Windows 2008 R2 platform and therefore the DFS functions will be based around the 2008 R2 version of DFSUTIL.  This is not to say that it is not compatible with anything earlier, it has just not been tested. Installation and use Download the zip file and extract to your modules folder. This can be found by running "explorer $pshome\modules" from a PowerShell console. To use, run "import-module Filesystem" Command list and Help To retrieve the list of commands and get he

This is the first update / bug fix for my module AADSites.  The latest release can be downloaded  here . For more info on the module see here . AADSites - Update 1 In version 0.91, the following has been changed : Fixed Issue in confirm-AADSitelink where a null value caused an error Added Each of get-aadsite, get-aadsitelink, and get-aadsubnet now no longer require an identity to be supplied. If identity is null, then all objects are returned. Updated Help files have been tweaked in most functions cheers Adam

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function enables you to check the options of a site are correct. NAME Confirm-AADSite SYNOPSIS Confirms the values provided match the configured site settings SYNTAX Confirm-AADSite [-Identity]  [[-SiteLinks] ] [[-description] ] [[-location] ] [ ] DESCRIPTION This function allows you to validate the settings of an AD Site. You can supply any combination of sitelinks, description or location to check and the function will return true or false whether the values match or not. PARAMETERS -Identity Mandatory - The name of the object you want to confirm. Position 0. -SiteLinks Optional - The sitelinks of the site you want to confirm Accepts 1 or more sitelinks, comma separated. Position 1. -description Optional - The description of the site you want to confirm Position 2. -location Optional - The location of the site you want to con

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function enables you to confirm the options of a sitelink are correct. NAME Confirm-AADSitelink SYNOPSIS Confirms the values provided match the configured sitelink settings SYNTAX Confirm-AADSitelink [-Identity] [[-Sites] ] [[-cost] ] [[-frequency] ] [[-description] ] [ ] DESCRIPTION This function allows you to validate the settings of an AD Sitelink. You can supply any combination of sites, cost, frequency or description to check and the function will return true or false whether the values match or not. PARAMETERS -Identity Mandatory - The name of the object you want to confirm. Position 0. -Sites Optional - The sites of the sitelink you want to confirm. Accepts 1 or more sites, comma separated. Position 1. -cost Optional - The cost of the sitelink you want to confirm Position 2. -frequency Optional - The frequency of replica

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function enables you to confirm the options of a subnet are correct. NAME Confirm-AADSubnet SYNOPSIS Confirms the values provided match the configured subnet settings SYNTAX Confirm-AADSubnet [-Identity] [[-description] ] [[-location] ] [[-site] ] [ ] DESCRIPTION This function allows you to validate the settings of an AD Subnet. You can supply any combination of site, description or location to check and the function will return true or false whether the values match or not. PARAMETERS -Identity Mandatory - The name of the object you want to confirm. Position 0. -description Optional - The description of the subnet you want to confirm Position 2. -location Optional - The location of the subnet you want to confirm Position 3. -site Optional - The site that the subnet belongs to. Position 1. -------------------------- EXAMPLE 1

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function returns a sites and services object with the specified name and type. NAME Get-AADServicesObject SYNOPSIS Returns an AD object that matches the name and type supplied SYNTAX Get-AADServicesObject [-Identity] [-Type] [ ] DESCRIPTION Returns an AD object, if one exists, that matches the name and type. Returns $null if nothing found PARAMETERS -Identity Mandatory - The name of the object you want to return. Position 0. -Type Mandatory - The type of the object to check. Accepts site, subnet or sitelink. Position 1. -------------------------- EXAMPLE 1 -------------------------- Simple usage get-AADServicesObject -identity Sitename -type Site -------------------------- EXAMPLE 2 -------------------------- Simple usage get-AADServicesObject -identity Sitelinkname -type Sitelink -------------------------- EXAMPLE 3 ----------

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function returns all attributes of an AD site. NAME Get-AADsite SYNOPSIS Returns the AD site object that matches the name supplied SYNTAX Get-AADsite [-Identity] [ ] DESCRIPTION Returns the AD site object, if one exists, that matches the name given Returns $null if nothing found PARAMETERS -Identity Mandatory - The name of the object you want to return. Position 0. -------------------------- EXAMPLE 1 -------------------------- Simple usage get-AADSite -identity Sitename

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function returns all the attributes of an AD Sitelink. NAME Get-AADsitelink SYNOPSIS Returns the AD sitelink object that matches the name supplied SYNTAX Get-AADsitelink [-Identity] [ ] DESCRIPTION Returns the AD site object, if one exists, that matches the name given Returns $null if nothing found PARAMETERS -Identity Mandatory - The name of the object you want to return. Position 0. -------------------------- EXAMPLE 1 -------------------------- Simple usage get-AADSitelink -identity Sitename

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function returns all attributes of an AD subnet. NAME Get-AADsubnet SYNOPSIS Returns the AD subnet object that matches the name supplied SYNTAX Get-AADsubnet [-Identity] [ ] DESCRIPTION Returns the AD subnet object, if one exists, that matches the name given Returns $null if nothing found PARAMETERS -Identity Mandatory - The name of the object you want to return. Position 0. -------------------------- EXAMPLE 1 -------------------------- Simple usage get-AADSubnet -identity 10.0.1.0/24

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function moves a subnet to a different site. This can be useful to adjust the site topology slightly, or preparation for removal of a site.  NAME Move-AADSubnetToSite SYNOPSIS Move a subnet to a different site SYNTAX Move-AADSubnetToSite [-Identity] [-site] [ ] DESCRIPTION Move a subnet to a different site Returns true if successful and false if not.   PARAMETERS -Identity Mandatory - The name of the subnet you want to move. Position 0. -site Mandatory - The name of the site to move to. Position 0. -------------------------- EXAMPLE 1 -------------------------- Simple usage move-AADSubnetToSite -identity 192.168.1.0/24 -site Sitename -------------------------- EXAMPLE 2 -------------------------- Simple usage - using positional parameters move-AADSubnetToSite 192.168.1.0/24 Sitename

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function enables you to create a new site.  On Create options available to set include the site links that the site is a member of, the location field and the description. NAME New-AADSite SYNOPSIS Create a new AD site object SYNTAX New-AADSite [-name] [[-SiteLinks] ] [[-Location] ] [[-Description] ] [ ] DESCRIPTION This function enables you to create a new AD Site. You can supply any combination of sitelinks, description or location to add to the new site PARAMETERS -name Mandatory - The name of the object you want to create. Position 0. -SiteLinks Optional - The sitelinks of the site you want to add it to Position 1. -Location Optional - The location of the site you want to set Position 3. -Description Optional - The description of the site you want to set Position 2. -------------------------- EXAMPLE 1 --------------------

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function enables you to create a new sitelink.  Options available to set on create include the sites that are members of the site linkt, the description, cost and frequency of replication.  NAME New-AADSiteLink SYNOPSIS Creates a new AD sitelink object SYNTAX New-AADSiteLink [-name] [-Sites] [[-cost] ] [[-frequency] ] [[-description] ] [ ] DESCRIPTION This function enables you to create a new AD Sitelink. You can supply any combination of sites, cost, frequency or description to set PARAMETERS -name Mandatory - The name of the object you want to create. Position 0. -Sites Optional - The sites you want to add to the site link. Accepts 1 or more sites, comma separated. Position 1. -cost Optional - The cost of the sitelink you want to set Position 2. -frequency Optional - The frequency of replication the sitelink (in minutes) you want t

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function enables you to create a new AD subnet.  Options you can set on create include the site that the subnet is a member of, the location field and the description. NAME New-AADSubnet SYNOPSIS Creates a new AD subnet object SYNTAX New-AADSubnet [-name] [-Site] [[-Description] ] [[-Location] ] [ ] DESCRIPTION This function enables you to create a new AD Subnet. You can supply any combination of site, description or location to set PARAMETERS -name Mandatory - The name of the object you want to create. Position 0. -Site Mandatory - The site that the subnet belongs to. Position 1. -Description Optional - The description of the subnet you want to set Position 2. -Location Optional - The location of the subnet you want to set Position 3. -------------------------- EXAMPLE 1 -------------------------- Simple usage new-AADSubnet

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function enables you to update the options of a site.  These include the site links that the site is a member of, the location field and the description. NAME Set-AADSite SYNOPSIS Sets the values of an AD site object SYNTAX Set-AADSite [-Identity]  [[-SiteLinks] ] [[-description] ] [[-location] ] [ ] DESCRIPTION This function allows you to set the values of an AD Site. You can supply any combination of sitelinks, description or location to set PARAMETERS -Identity Mandatory - The name of the object you want to set. Position 0. -SiteLinks Optional - The sitelinks of the site you want to set Position 1. -description Optional - The description of the site you want to set Position 2. -location Optional - The location of the site you want to set Position 3. -------------------------- EXAMPLE 1 -------------------------- Simple usag

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function allows you to update the option of sitelink.  These include the sites that are members of the sitelink, the cost, the replication frequency and the description. NAME Set-AADSitelink SYNOPSIS Sets the values of an AD sitelink object SYNTAX Set-AADSitelink [-Identity] [[-Sites] ] [[-cost] ] [[-frequency] ] [[-description] ] [ ] DESCRIPTION This function allows you to set the values of an AD Sitelink. You can supply any combination of sites, cost, frequency or description to set PARAMETERS -Identity Mandatory - The name of the object you want to change. Position 0. -Sites Optional - The sites of the sitelink you want to set. Accepts 1 or more sites, comma separated. Position 1. -cost Optional - The cost of the sitelink you want to set Position 2. -frequency Optional - The frequency of replication the sitelink (in minutes

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . This function allows you to change the description and location attributes of a subnet and also the site it is associated with. NAME Set-AADSubnet SYNOPSIS Sets the values of an AD subnet object SYNTAX Set-AADSubnet [-Identity] [[-description] ] [[-location] ] [[-site] ] [ ] DESCRIPTION This function allows you to set the values of an AD Subnet. You can supply any combination of site, description or location to set PARAMETERS -Identity Mandatory - The name of the object you want to set. Position 0. -description Optional - The description of the subnet you want to set Position 2. -location Optional - The location of the subnet you want to set Position 3. -site Optional - The site that the subnet belongs to. Position 1. -------------------------- EXAMPLE 1 -------------------------- Simple usage PS C:\> set-AADSubnet -I

This function is part of my AADSites module, which can be downloaded here .  For more info on the module see here . Test-AADServicesObject returns true or false against a object name and type.  Can be used to check or confirm the existance of a Site / Subnet / Sitelink object in AD. NAME Test-AADServicesObject SYNOPSIS Checks to see whether an AD object exists with the name and type supplied SYNTAX Test-AADServicesObject [-Identity] [-Type] [ ] DESCRIPTION Checks to see whether an AD object exists with the name and type supplied. returns true if exists and false if not. PARAMETERS -Identity Mandatory - The name of the object you want to check. Position 0. -Type Mandatory - The type of the object to check. Accepts site, subnet or sitelink. Position 1. -------------------------- EXAMPLE 1 -------------------------- Simple usage PS C:\> Test-AADServicesObject -identity Sitename -type Site -------------------------- EXAMPLE 2