ghjconan's blog

Windows PowerShell每周提示(42)：在通知区域显示一条消息

ghjconan — Sun, 17 Aug 2008 11:32:34 GMT

老实说，当脚本作家处理组成Windows界面的图形用户元素时经常上当受骗。无可否认编写VBScritpt的人在使用HTA（HTML应用程序）时做了很多酷事。然而，HTA限制了能在Web页面中使用的控件及用户界面元素。正如HTA有可能达到的酷那样，这些程序（及编写他们的人）还没有能够涉及到在羽翼丰满的编程语言中真正酷的用户界面元素。

例如，脚本专家经常被问及编写VBscript的人如何在通知区域（位于屏幕右下角的小区域，操作系统及程序的消息经常会在这里出现）显示一条消息。每一次被问及此问题时，我们的回答总是一样的：抱歉，无法实现。

噢，如果编写Windows PowerShell脚本的人问起同样问题的话……

怎么了？为什么我们希望编写Windows PowerShell脚本的人询问这个问题？这很简单：因为，这样的话，我们会有一个比较好的回答。事实证明，你能使用.NET Framework在通知区域内显示消息。因为Windows PowerShell能完全访问.NET Framework，这就意味着你能在通知区域内显示消息。

不，我们没有在开玩笑。真的能使用Windows PowerShell在通知区域内显示消息。如果你不能的话，我们就不会毫无理由的将类似以下的脚本放在此处：

[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")

$objNotifyIcon = New-Object System.Windows.Forms.NotifyIcon

$objNotifyIcon.Icon = "C:\Scripts\Forms\Folder.ico"

$objNotifyIcon.BalloonTipIcon = "Error"

$objNotifyIcon.BalloonTipText = "A file needed to complete the operation could not be found."

$objNotifyIcon.BalloonTipTitle = "File Not Found"

$objNotifyIcon.Visible = $True

$objNotifyIcon.ShowBalloonTip(10000)

让我们证明下这个脚本是如何工作的，并让你知道如何在你的自己脚本中使用这些代码。最开始，我们使用以下这行代码来加载.NET Framework类 System.Windows.Forms的一个实例：

[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")

如果万一你对这行代码开始处的[void]感到疑惑的话，那么它的作用只是避免在加载System.Windows.Form类时出现状态信息。如果不使用[void]，那么当我们每次运行脚本时将看到以下信息：

GAC Version Location--- ------- --------True v2.0.50727 C:\WINDOWS\assembly\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.For...

不管这信息对你而言是否值得一读，只是我们真的不需要每次运行脚本都显示该这信息。

在加载System.Windows.Forms类以后我们使用New-Object cmdlet来创建System.Windows.Forms.NotifyIcon类的实例。如你猜测的那样，这是让我们可以配置及在通知区域显示信息的.NET类。

$objNotifyIcon = New-Object System.Windows.Forms.NotifyIcon

接下来我们需要定义通知的几个属性。尤其是，我们需要对以下项目赋值：

属性

描述

Icon

这是在通知区域出现的图标。图标必须为16像素宽16像素高。如果你有图标编辑软件那么你能自己创建图标，如果你没有的话那么在你的计算机（或者互联网）上搜索.ICO文件。请确保在你对Icon属性赋值时你指定了完整路径：$objNotifyIcon.Icon = "C:\Scripts\Forms\Folder.ico".

BalloonTipIcon

这是在通知内显示的图标（看下面的插图）。你能在以下有操作系统提供的图标中选择：Info、Warning及Error。在我们的例子中，我们将BalloonTipIcon设置为Error。

BalloonTipText

真正被显示的信息。对这个脚本而言我们将BalloonTipText设置为“A file needed to complete the operation could not be found.”

BalloonTipTitle

通知的标题。例如，File Not Found。

更形象的来说是这样：

无论相信与否，我们几乎已经完成了。在设置Visible属性为真（$True）后，我们要做的是调用ShowBalloonTip方法来显示通知：

$objNotifyIcon.ShowBalloonTip(10000)

有几个关于ShowBalloonTip方法的注意事项。一件事是，你注意到我们向ShowBallonTip传递了10000这个参数了么？好的，理论上，这数字表明了我们想要通知在自动消失之前在屏幕上停留的时间。因为一秒由1000毫秒组成，10000这这意味着，理论上，我们想要通知在屏幕上停留10秒，然后匆匆道别。这看上去很简单。那么为什么我们要说“理论上”？这是因为受到一些外部因素影响。例如，当在通知区域显示通知时，操作系统加上了相关限制。通常来说，通知必须在屏幕上停留至少10秒但不超过30秒。这是什么意思？让我们这样解释：假设你向ShowBalloonTip传递了300000这个参数值，认为这将使通知在屏幕上显示5分钟（300000毫秒）。尽管实际上，通知在屏幕上不会待那么久。操作系统将会在这之前打断它。同样的，如果你将参数设为1，并认为通知将在屏幕上显示1毫秒然后消失。这也将不会正常运行：Windows将会确保通知消失之前已经显示了允许显示时间的最小值。

不仅是这样，时间也取决于在计算机上正在发生的活动。如果系统处于空闲状态，那么倒计时将不会开始直到发生了一些活动行为。在这种情况下，通知可能在显示了几小时后才会消失。

注意.当然你能通过点击来结束一个通知。也就是说，我们应当指出，任何超时了的通知将会消失，但是图标将仍然显示在通知区域，知道你的鼠标划过该区域。然后，如果你通过点击关闭了通知那么图标也会消失。

不管通知将会在屏幕上停留多少时间，它看上去都像是这样的：

不坏吧？

另一件需要记住的是，在通知显示期间，你的脚本将继续运行。脚本不会自动暂停来等待通知消失。这应当没什么问题，只是你应当注意。

下面是一个酷提示：你能在任意时间改变通知。例如，下面有一个脚本来显示文件正在从C:\Windows文件夹中提取的通知。一旦Get-ChildItem完成了收集文件的工作，BalloonTipText及BalloonTipTitle属性将被更新，来说明文件已经提取完成。当Visible属性设为真并且ShowBallonTip方法被调用时，这个“新的”通知将会替代前一个通知。

下面是代码：

[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")

$objNotifyIcon = New-Object System.Windows.Forms.NotifyIcon

$objNotifyIcon.Icon = "C:\Scripts\Forms\Folder.ico"

$objNotifyIcon.BalloonTipIcon = "Info"

$objNotifyIcon.BalloonTipText = "Retrieving files from C:\Windows."

$objNotifyIcon.BalloonTipTitle = "Retrieving Files"

$objNotifyIcon.Visible = $True

$objNotifyIcon.ShowBalloonTip(10000)

Get-ChildItem C:\Windows

$objNotifyIcon.BalloonTipText = "The script has finished running."

$objNotifyIcon.BalloonTipTitle = "Files retrieved."

$objNotifyIcon.Visible = $True

$objNotifyIcon.ShowBalloonTip(10000)

这是编写系统管理脚本的人几年来梦寐以求的事。

本周的专栏也到此结束了。脚本编辑已经等得不耐烦了，并在想我们到底什么时候将本文交付编辑。别担心，脚本编辑，我们刚想这么做。

下周见。

英文原文

http://www.microsoft.com/technet/scriptcenter/resources/pstips/may08/pstip0523.mspx

PowerShell学习笔记（13）：UC时代的用户对象创建（下）

ghjconan — Tue, 05 Aug 2008 14:14:25 GMT

第三节统一开启帐号的实现

在上一节中，我们已经实现了了组织架构树，主要目的是方便帐号管理员通过图形界面来选择新建帐号所在OU，而不需要手动输入长串的DN。在本节中我们将利用相关Cmdlets实现帐号的开启。

下面让我们先来看看代码，然后再分析具体代码的作用：

function CreateUser 
{
    $objForm.Cursor = "WaitCursor"
    $objUDN = $objTxtUserDisplayName.Text
    $objUPN = $objTxtUserPrincipalName.Text
    $objUserTitle = $objTxtUserTitle.Text
    $objUserDep = $objTxtUserOU.Text
    $objUserTel = $objTxtUserTel.Text
    $objUserSN = $objTxtUserStaffNum.Text
    $objSAM = $objUPN.split("@")[0]
    $objSN = $objUDN.SubString(0,1)
    $objGN = $objUDN.SubString(1)
    $objCenter = $objTxtUserCenter.Text    
    if ($objCenter -eq "")
    {
        [Windows.Forms.Messagebox]::Show("必须设置用户所在中心!","警告", [Windows.Forms.MessageBoxButtons]::OK, [Windows.Forms.MessageBoxIcon]::Warning)
    }
    else
    {
        $objInfo = "用户显示名：$objUDN`n用户登录名：$objUPN`n职务：$objUserTitle`n部门：$objUserDep`n电话：$objUserTel`n工号：$objUserSN`n所在中心：$objCenter"
        $objReturn = [Windows.Forms.Messagebox]::Show($objInfo,"新建帐号", [Windows.Forms.MessageBoxButtons]::OKCancel, [Windows.Forms.MessageBoxIcon]::Information)
    }
    if ($objReturn -eq "OK")
    {
        New-QADUser -ParentContainer $objCurrentOUDN -Name $objUDN `
        -UserPrincipalName $objUPN -SamAccountName $objSAM `
        -Company "Contoso" `
        -UserPassword 'abcd@123' -Title $objUserTitle -Department $objUserDep `
        -telephoneNumber $objUserTel -ObjectAttributes @{employeeID = $objUSN; `
        userWorkstations = "Contoso-$objUserTel"; `
        displayname=$objUDN;sn=$objSN;givenName=$objGN}                
        Enable-QADUser "contoso\$objSAM"
        Set-QADUser -Identity "contoso\$objSAM" -UserMustChangePassword $True
        $objUserDN = (Get-QADUser $objSAM).DN
        $colGroups = Get-QADGroup $objCenter.SubString(0,2)
        foreach ($objGroup in $colGroups)
        {
            Add-QADGroupMember -Identity $objGroup.DN -Member $objUserDN
        }                
        Enable-Mailbox     -Identity $objUserDN -Alias $objSAM -Database 'MailServer\First Storage Group\Mailbox Database'
        #Enable OC
        Set-QADUser -Identity $objUserDN -ObjectAttributes @{"msRTCSIP-ArchivingEnabled"=2;"msRTCSIP-OptionFlags"=320;`
        "msRTCSIP-PrimaryHomeServer"="CN=LC Services,CN=Microsoft,CN=pool,CN=Pools,CN=RTC Service,CN=Microsoft,CN=System,DC=contoso,DC=com";`
        "msRTCSIP-PrimaryUserAddress"="sip:$objUPN";"msRTCSIP-UserEnabled"=$True}
        $objTxtUserDisplayName.Text = ""
        $objTxtUserPrincipalName.Text = "@contoso.com"
        $objTxtUserTitle.Text = ""
        $objTxtUserTel.Text = ""
        $objTxtUserStaffNum.Text = ""
        $objTxtUserCenter.Text = ""
        $objTxtUserOU.Text = ""
        $objForm.Cursor = "Default"
    }
    else
    {
        $objForm.Cursor = "Default"
    }
}

在代码的最开始我们将窗体的Cursor属性设置为“WaitCursor”，具体作用就是让鼠标呈现忙碌状态，这是用户很熟悉的一种操作体验。接着我们将文本控件的值赋值给变量，供后续调用。这里需要注意的是Split和SubString两个方法。因为我们的图形界面让用户输入了比较少量的信息，但这些信息对于创建一个普通的用户帐号而言还是有所欠缺的，因此需要使用一定方法从已知信息中得到我们想要的信息。而示例中Split的作用是从UserPrincipalName的属性值中分离出sAMAccountName的属性值，说穿了就是@前面的部分，即我们平时登录域时所使用的帐号。而SubString的作用与VBScript中的Left，Right和Mid方法类似,示例代码中的作用是从显示名中分离出姓和名（对应的AD属性名分别是sn和givenName）。接着为了防止用户没有从左侧树形结构中选择新建用户所在OU，我们需要使用判断语句来处理这个可能发生的错误并提醒用户。如果发生错误，那么将会出现以下提示：

利用MessageBox我们可以很轻松的弹出Windows下的标准信息框，不过比较可惜的是MessageBox是无法被实例化的，也就是说你想用$MsgBox来替代[Windows.Forms.Messagebox]是无法实现的。只能使用示例代码中的方法来调用。如果输入信息没有问题的话，还是会出现一个消息框提示用户核对输入信息：

这里需要注意的是我首先将显示内容保存到变量之中，之间的换行使用`n实现。

接着我们要根据使用者具体点击了哪个按钮进行判断。如果是确定，那么就执行添加用户的代码，如果是取消那么要将鼠标恢复成默认状态。那么让我们着重看一下添加用户的代码。其实利用New-QADUser cmdlet的话新建帐号并不是难事，只要将参数和参数值一一对应即可。相关参数也是非常明了的，比如-ParentContainer指的就是用户所在OU，-Name对应的是AD中的cn属性，-UserPassword参数为用户设置密码（想必厌恶在ADUC中为新建帐号两次输入密码的人不在少数吧？这次我们更省力，只要在写代码的时候输入一遍就可以了）。不过New-QADUser cmdlet本身并不会附带上AD中所有属性名的参数，因为这会使得cmdlet的参数列表十分复杂。因此Quest的开发人员定义了-ObjectAttributes参数，允许我们使用哈希表来定义属性。我这里使用该参数定义了工号，显示名，姓和名，以及用户允许登录到的工作站（假设工作站的命名规则是以字符串Contoso-后跟四位电话分机号实现的）。

然后我们使用Enable-QADUser cmdlet启用用户帐号并用Set-QADUser cmdlet与-UserMustChangePassword参数使得用户下次登录时必须更改密码。到这里新建域账号的工作就所剩无几了，最后我们要做的是将用户添加到相关的组中。在说明代码之前我们先假设一个前提，即我们的环境中为不同的中心建立了两个组，一个是AD用户组，另外一个是Exchange的联系人组。两者的CN相同，但是sAMAccountName不同，如图所示：

再为用户添加组之前，我们首先要取得新建用户的DN。然后根据用户的选择检索相关的OU对象。因为环境决定了用户必定会添加到两个组，因此我们得到的结果将是一个数组。所以我们使用foreach循环遍历这个数组得到其中每个组的DN属性，然后使用Add-QADGroupMember cmdlet来将用户添加到组里面。支持新建域账号的代码就结束了，这是新建帐号中最复杂的一部分。

启用邮箱就很简单了，了解Exchange 2007的朋友都知道我们当我们使用MMC启用邮箱时，最后向导都会给出使用PowerShell开启邮箱的命令，我们只需利用这个命令即可。所要做的只是将其中的参数值利用变量进行替换。总的来说启用邮箱并不难。

接着轮到启用OCS帐号了。也许大家曾今和我一样把这件事想的很复杂，因为Resource Kit里面有一个脚本来启用OCS帐号，而这个脚本非常复杂，事实上这个脚本是自LCS时代沿袭过来的，那么都到UC时代了，有没有简单点的方法呢？产品组自然考虑的很周到，我们只需要设置用户的几个AD属性即可，使用的cmdlet同样是Set-QADUser。相关资料诸位可以阅读OCS_ADGuide文档中的Active Directory属性部分的内容。这涉及到具体的部署环境，在我所处的实际生产环境中，我们为用户启用了聊天记录存档，因此需要将msRTCSIP-ArchivingEnabled属性值设为2，也就是存档内部通信。而msRTCSIP-OptionFlags则是几个设置的叠加。比如我们允许用户邀请匿名用户加入会议并启用了增强状态，那么其结果就是64+256=320。（插一句，有可能诸位下到的中文文档将256代表的EnabledForEnhancedPresence翻译成了允许用户使用公共 IM 连接，这个翻译是错误的。）接着我们要添加用户所在的池的FQDN，其对应的属性是msRTCSIP-PrimaryHomeServer，该值需要查阅你的具体环境中的相关值。然后是用户的SIP地址，因为环境中UPN地址和邮件地址相同，我们就直接使用已知的UPN值。最后我们为用户启用OCS帐号，其对应的是属性为msRTCSIP-UserEnabled。至此，OCS帐号的启用也顺利完成了。接着我们进行扫尾工作，将文本框的内容清空（代表UPN的文本框则保留域的名称，方便用户再次新建帐号），最后将鼠标恢复成默认状态。

新建帐号的工作大致算是完成了，但是为了避免用户的一些输入错误，我们还需要添加辅助代码来避免输入错误的发生。首先我们想要实现这样一个功能，当文本框内的内容为空时给用户一定提示，但并非强制用户必须输入相关内容。以下是代码：

function CheckTextBox($InputObject)
{
    if ($InputObject.Text -eq "") 
    {
        $InputObject.BackColor = "LightCoral"
    }
    else
    {
        $InputObject.BackColor = "White"
    }
}

代码非常简单，当检测到文本框为空时，将该文本框的背景色设置为LightCoral，其效果如下图所示：

因为我们想要使该函数在输入焦点离开当前文本框时生效，所以我们添加了以下代码：

$objTxtUserDisplayName.Add_Leave({CheckTextBox($objTxtUserDisplayName)})

接下来我们要重点检查用户登录名，还是先放上代码：

function CheckUPN 
{
    $objTemp = $objTxtUserPrincipalName.Text
    $objChkResult = [regex]::Match($objTemp,"\w+@contoso.com")
    if ($objChkResult.Success -eq $true)
    {
        $objChkUser = Get-QADUser $objTemp
        if ($objChkUser -ne $null) 
        {
            [Windows.Forms.Messagebox]::Show("该用户名已存在，请重新输入！","错误", [Windows.Forms.MessageBoxButtons]::OK, [Windows.Forms.MessageBoxIcon]::Stop)
            $objTxtUserPrincipalName.Focus()
            $objTxtUserPrincipalName.SelectAll()
        }            
    }
    else
    {
        [Windows.Forms.Messagebox]::Show("用户名错误，请重新输入！","错误", [Windows.Forms.MessageBoxButtons]::OK, [Windows.Forms.MessageBoxIcon]::Stop)
        $objTxtUserPrincipalName.Focus()
        $objTxtUserPrincipalName.SelectAll()
    }

在代码开始，我们首先需要获得用户输入的信息，然后将其存放在名为$objTemp的变量中。然后利用正则表达式（[regex],代码中使用的还是很简单的一种表达式）对输入信息进行检查，并将检查结果存放在相关变量中。一旦用户输入了错误的信息我们使用MessageBox弹出提示，然后为用户全选文本框内的用户名方便用户重新输入正确信息。而即便用户输入的信息正确，我们也需要检查用户输入的用户名是否已存在，如果已存在那么还是需要用户重新输入信息。

同样，为了使函数生效，我们需要添加以下代码：

$objTxtUserPrincipalName.Add_Leave({CheckTextBox($objTxtUserPrincipalName);CheckUPN})

在第一节中我提到了，使用;来分隔在同一事件中所要执行的不同函数，事实上我们完全可以把文本框的检查代码写在一起，然后利用switch语句判断不同的文本框，这里我就不去实现相关代码了，有兴趣的朋友不妨动手试试。

结束语

以上就是UC时代的用户帐号创建的所有内容，我个人感觉是真正的用户创建是非常简单的，因为有现成的cmdlet来帮助我们完成。但是我在文章开头提到最终帐号的开启并不是由我负责，所以我们需要创建一个GUI界面来降低帐号管理员的刚接手帐号开启工作时的不适感，并尽可能简化开启的流程，这使我们不得不考虑很多问题。使用普通MMC开启域、邮件、OCS帐号可能需要几分钟的时间，而如果使用以上脚本那么这个过程可能在半分钟内就完成了。这就是PowerShell的魅力吧。

那么就此结束本文，向耐心读完全文的朋友表示由衷地感谢。

注：文中代码仅供交流学习使用，尚有很大改善余地。