Ps Partition Access

Problem this snippet solves:

This Powershell application illustrates how to get and set the users management partitions.

Code :

#----------------------------------------------------------------------------
# The contents of this file are subject to the "END USER LICENSE AGREEMENT FOR F5
# Software Development Kit for iControl"; you may not use this file except in
# compliance with the License. The License is included in the iControl
# Software Development Kit.
#
# Software distributed under the License is distributed on an "AS IS"
# basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
# the License for the specific language governing rights and limitations
# under the License.
#
# The Original Code is iControl Code and related documentation
# distributed by F5.
#
# The Initial Developer of the Original Code is F5 Networks,
# Inc. Seattle, WA, USA. Portions created by F5 are Copyright (C) 1996-2010 F5 Networks,
# Inc. All Rights Reserved.  iControl (TM) is a registered trademark of F5 Networks, Inc.
#
# Alternatively, the contents of this file may be used under the terms
# of the GNU General Public License (the "GPL"), in which case the
# provisions of GPL are applicable instead of those above.  If you wish
# to allow use of your version of this file only under the terms of the
# GPL and not to allow others to use your version of this file under the
# License, indicate your decision by deleting the provisions above and
# replace them with the notice and other provisions required by the GPL.
# If you do not delete the provisions above, a recipient may use your
# version of this file under either the License or the GPL.
#----------------------------------------------------------------------------
param (
  $hostname = $null,
  $user = $null,
  $pass = $null,
  $partition = $null
);

Set-PSDebug -strict;

#-------------------------------------------------------------------------
function Write-Usage()
#-------------------------------------------------------------------------
{
  Write-Host "Usage: PartitionAccess.ps1 host uid pwd [partition_name]";
  exit;
}

#-------------------------------------------------------------------------
function Get-ActivePartition
#-------------------------------------------------------------------------
{
  $active = $(Get-F5.iControl).ManagementPartition.get_active_partition();
  "Active Partition : $active";
}

#-------------------------------------------------------------------------
function Get-AvailablePartitions
#-------------------------------------------------------------------------
{
  $UserPermissionA = $(Get-F5.iControl).ManagementUserManagement.get_my_permission();
  "Available User Partitions";
  "-------------------------";
  foreach($UserPermission in $UserPermissionA)
  {
    $role = $UserPermission.role;
    $partition = $UserPermission.partition;
    "  $partition : $role";
  }
  "-------------------------";
}

#-------------------------------------------------------------------------
function Set-ActivePartition
#-------------------------------------------------------------------------
{
  param([string]$partition);
  if ($partition)
  {
    $(Get-F5.iControl).ManagementPartition.set_active_partition($partition);
  }
}

#-------------------------------------------------------------------------
function Do-Initialize()
#-------------------------------------------------------------------------
{
  if ( (Get-PSSnapin | Where-Object { $_.Name -eq "iControlSnapIn"}) -eq $null )
  {
    Add-PSSnapIn iControlSnapIn
  }
  $success = Initialize-F5.iControl -HostName $hostname -Username $user -Password $pass;
  
  return $success;
}

#-------------------------------------------------------------------------
# Main Application Logic
#-------------------------------------------------------------------------
if ( ($hostname -eq $null) -or ($user -eq $null) -or ($pass -eq $null) )
{
  Write-Usage;
}

if ( Do-Initialize )
{
  if ( $partition )
  {
    Set-ActivePartition -partition $partition;
    Get-ActivePartition;
  }
  else
  {
    Get-ActivePartition;
    Get-AvailablePartitions;
  }
}
else
{
  Write-Error "ERROR: iControl subsystem not initialized"
}