Public/New-ADSISite.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
function New-ADSISite
{
<#
 .SYNOPSIS
  Function to create a new Site
  
 .DESCRIPTION
  Function to create a new Site
  
 .PARAMETER SiteName
  Specifies the SiteName
  
 .PARAMETER Location
  Specifies the Location of the site
  
 .PARAMETER Credential
  Specifies the alternative credential to use.
  By default it will use the current user windows credentials.
  
 .PARAMETER ForestName
  Specifies the alternative Forest where the subnet should be created
  By default it will use the current forest.
  
 .EXAMPLE
  PS C:\> New-ADSISite -SiteName "MTL01" -Location "Montreal, QC, Canada"
  
 .NOTES
  Francois-Xavier.Cat
  LazyWinAdmin.com
  @lazywinadm
  github.com/lazywinadmin
  
 .LINK
  https://msdn.microsoft.com/en-us/library/system.directoryservices.activedirectory.activedirectorysite(v=vs.110).aspx
#>

    
    [CmdletBinding(SupportsShouldProcess = $true)]
    param
    (
        [Parameter(Mandatory = $true)]
        [Alias('Name')]
        [String]$SiteName,

        [String]$Location,

        [Alias("RunAs")]
        [System.Management.Automation.PSCredential]
        [System.Management.Automation.Credential()]
        $Credential = [System.Management.Automation.PSCredential]::Empty,

        [String]$ForestName
    )
    
    BEGIN
    {
        Add-Type -AssemblyName System.DirectoryServices.AccountManagement
        
        # Create Context splatting
        $ContextSplatting = @{ ContextType = "Forest" }
        
        IF ($PSBoundParameters['Credential']) { $ContextSplatting.Credential = $Credential }
        IF ($PSBoundParameters['ForestName']) { $ContextSplatting.ForestName = $ForestName }
        
        $Context = New-ADSIDirectoryContext @ContextSplatting
    }
    PROCESS
    {
        TRY
        {
            IF ($PSCmdlet.ShouldProcess($SiteName, "Create Site"))
            {
                $Site = New-Object -TypeName System.DirectoryServices.ActiveDirectory.ActiveDirectorySite -ArgumentList $Context, $SiteName
                $Site.Location = $Location
                $Site.Save()
                
                #$site.GetDirectoryEntry()
            }
        }
        CATCH
        {
            Write-Error $Error[0]
            break
        }
    }
    END
    {
    }
}