New-CsClientPolicy

 

上次修改主題的時間:2017-05-17

重要重要事項:
This only applies to Skype for Business Online and not to Skype for Business Server or Lync on-premises deployments.
重要重要事項:
Please note that if your organization utilizes custom policies, then the UI will no longer correctly reflect the policy values. Once they are implemented they must continue to be managed via PowerShell.

Creates a new client policy. Among other things, client policies help determine the features of 商務用 Skype Online that are made available to users; for example, you might give some users the right to transfer files while denying this right to other users.

New-CsClientPolicy -Identity <XdsIdentity> [-Description <String>]  [-DisableCalendarPresence <$true | $false>] [-DisableEmailComparisonCheck <$true | $false>] [-DisableEmoticons <$true | $false>] [-DisableFreeBusyInfo <$true | $false>] [-DisableHandsetOnLockedMachine <$true | $false>] [-DisableHtmlIm <$true | $false>] [-DisableInkIM <$true | $false>] [-DisablePoorDeviceWarnings <$true | $false>] [-DisablePoorNetworkWarnings <$true | $false>] [-DisablePresenceNote <$true | $false>] [-DisableRTFIM <$true | $false>] [-DisableSavingIM <$true | $false>] [-DisplayPhoto <NoPhoto | PhotosFromADOnly | AllPhotos>] [-EnableAppearOffline <$true | $false>] [-EnableCallLogAutoArchiving <$true | $false>] [-EnableClientAutoPopulateWithTeam <$true | $false>] [-EnableClientMusicOnHold <$true | $false>] [-EnableConversationWindowTabs <$true | $false>] [-EnableEnterpriseCustomizedHelp <$true | $false>] [-EnableExchangeContactSync <$true | $false>] [-EnableIMAutoArchiving <$true | $false>] [-EnableSkypeUI <$true | $false>] [-EnableUnencryptedFileTransfer <$true | $false>] [-EnableURL <$true | $false>] [-ExcludedContactFolders <String>] [-Force <SwitchParameter>] [-MusicOnHoldAudioFile <String> [-PlayAbbreviatedDialTone <$true | $false>] [-ShowManagePrivacyRelationships <$true | $false>] [-ShowRecentContacts <$true | $false>] [-ShowSharepointPhotoEditLink <$true | $false>] [-TracingLevel <Off | Light | Full>] [-WhatIf [<SwitchParameter>]]

The command shown in Example 1 creates a new client policy with the Identity RedmondClientPolicy. In addition to specifying the Identity, this command also includes two optional parameters and their parameter values: DisableCalendarPresenceand DisplayPhoto.

New-CsClientPolicy -Identity RedmondClientPolicy -DisableCalendarPresence $True  -DisplayPhoto "PhotosFromADOnly"

Example 2 also creates a new client policy with the Identity RedmondClientPolicy; the difference between these commands and the command used in Example 1 is that, in Example 2, the new policy is created in memory only, and is only later turned into an actual client policy. To do this, the New-CsClientPolicy cmdlet is first called along with the parameter: Identity (to specify the Identity for the new policy).

After the virtual policy has been created, the next three commands are used to modify properties for this virtual policy; for example, command 2 sets the value of the DisableCalendarPresence property to True. After all the intended modifications have been made, the final command uses the Set-CsClientPolicy cmdlet to turn this virtual policy into an actual client policy that can be assigned to users. Note that this final command is critical. If you do not call the Set-CsClientPolicy cmdlet the policy RedmondClientPolicy won't be created, and the virtual policy will disappear as soon as you end your Windows PowerShell session or delete the variable $x.

$x = New-CsClientPolicy -Identity RedmondClientPolicy 
$x.DisableCalendarPresence = $True 
$x.DisablePhonePresence = $True 
Set-CsClientPolicy -Instance $x

Client policies are applied each time a user accesses the system, regardless of where the user logs on from and regardless of the type of device the user logs on with. In addition, client policies, like other 商務用 Skype Online policies, can readily be targeted toward selected groups of users. You can even create a custom policy that gets assigned to a single user.

The New-CsClientPolicy cmdlet enables you to create new client policies at the per-user scope. If you need to make changes to an existing policy, use the Set-CsClientPolicy cmdlet instead.

註記注意事項:
Keep in mind that client policies differ from many other policies in that most of the policy settings don't have default values.

 

Parameter Required Type Description

Identity

Required

Microsoft.Rtc.Management.Xds.XdsIdentity

Unique Identity to be assigned to the new policy. New client policies can be created at the per-user scope. To create a new per-user policy, use an identity similar to this: -Identity SalesClientPolicy.

DisableCalendarPresence

Optional

System.Boolean

When set to True, calendar data taken from Microsoft Outlook will not be included in your presence information. When set to False, calendar data will be included in your presence information. For example, free/busy information will be reported in your contact card. Likewise, your status will automatically be set to Busy any time Outlook shows that you are in a meeting.

DisableEmailComparisonCheck

Optional

System.Boolean

When set to True, 商務用 Skype will not attempt to verify that any currently running instance of Microsoft Outlook belongs to the same user running 商務用 Skype; for example, the software will not verify that both Outlook and 商務用 Skype are running under Ken Myer’s user account. Instead, it will be assumed that the two applications are running under the same account and, in turn, will include contact and calendar data in Outlook with 商務用 Skype.

When set to False, 商務用 Skype will use SMTP addresses to verify that Outlook and 商務用 Skype are running under the same account. If the SMTP addresses do not match, then contact and calendar data in Outlook will not be incorporated into 商務用 Skype.

DisableEmoticons

Optional

System.Boolean

When set to True, users will not be able to send or receive emoticons in their instant messages; instead they will be see the text equivalent of those emoticons. For example, instead of seeing a graphical "smiley face," users will see the text equivalent:

: )

When set to False, users will be able to include emoticons in their instant messages, and to view emoticons in instant messages they receive.

DisableFreeBusyInfo

Optional

System.Boolean

When set to True, free/busy information retrieved from Microsoft Outlook will not be displayed in your contact card. When set to False, free/busy information is displayed in your contact card. For example, your contact card might include a note similar to this:

Calendar: Free until 2:00 PM

DisableHandsetOnLockedMachine

Optional

System.Boolean

When set to True, users will not be able to use their Polycom handset if the computer that the handset is connected to is locked. To use the handset, users will first have to unlock the computer.

When set to False, users will be allowed to use their Polycom handset even if the computer the handset is connected to is locked.

DisableHtmlIm

Optional

System.Boolean

When set to True, any HTML text copied from a webpage will be converted to plain text when pasted into an instant message. When set to False, HTML formatting (such as font size and color, drop-down lists, and buttons) will be retained when pasted into an instant message.

Note that, even when set to False, scripts and other potentially malicious items (such as tags that play a sound) will not be copied into an instant message. You can copy and paste buttons and other controls into a message, but any scripts attached to those controls will automatically be removed.

DisableInkIM

Optional

System.Boolean

When set to True, users will not be allowed to receive instant messages containing Tablet PC ink. (Ink is a technology that enables you to insert handwritten notes into a document.) When set to False, users will be allowed to receive messages that contain Tablet PC ink.

DisablePoorDeviceWarnings

Optional

System.Boolean

When set to True, 商務用 Skype won't issue warnings (for example, upon startup, in the Tuning Wizard, and in the Conversation window) if an audio or video device is not working correctly. When set to False, these warnings will be issued.

DisablePoorNetworkWarnings

Optional

System.Boolean

When set to True, 商務用 Skype will not display warnings about poor network quality.

DisablePresenceNote

Optional

System.Boolean

When set to True, any Out of Office message you configure in Microsoft Outlook will not be displayed as part of your presence information. When set to False, your Out of Office message will be displayed any time a user holds the mouse over your name in their Contacts list.

DisableRTFIM

Optional

System.Boolean

When both this setting and the DisableHtmlIm setting are set to True, prevents rich text formatting (for example, different fonts, font sizes, and font colors) from being used in instant messages; instead, all messages sent and received will be converted to plain text format. When set to False, rich text formatting will be allowed in instant messages.

DisableSavingIM

Optional

System.Boolean

When set to True, the options for saving an instant messaging session are removed from the menu bar in the 商務用 Skype Conversation window. When set to False, these options are available in the Conversation window.

Note that setting this value to True removes the menu options that make it easy for users to save instant messaging transcripts. However, it does not prevent users from copying all the text in a transcript to the clipboard, pasting that text into another application, and then saving the transcript that way.

DisplayPhoto

Optional

Microsoft.Rtc.Management.WritableConfig.Policy.Client.DisplayPhoto

Determines whether or not photos (of both the user and his or her contacts) will be displayed in 商務用 Skype. Valid settings are:

NoPhoto - Photos are not displayed in 商務用 Skype.

PhotosFromADOnly - Only photos that have been published in Active Directory can be displayed.

AllPhotos - Either Active Directory or custom photos can be displayed.

The default value is AllPhotos.

EnableAppearOffline

Optional

System.Boolean

When set to True an additional presence state, Appear Offline, is available in 商務用 Skype. This state makes it appear as though the user is offline; however, he or she will actually be online and available to answer phone calls and respond to instant messages. When set to False, the Appear Offline presence state will not be available in 商務用 Skype.

EnableCallLogAutoArchiving

Optional

System.Boolean

When set to True, information about your incoming and outgoing phone calls is automatically saved to the Conversation History folder in Microsoft Outlook. (The actual call itself is not recorded. What is recorded is information such as who took part in the call; the length of the call; and whether this was an incoming or an outgoing call.) When set to False, this information is not saved to Outlook.

EnableClientMusicOnHold

Optional

System.Boolean

When set to True, music will be played any time a caller is placed on hold. When set to False, music will not be played any time a caller is placed on hold. The default value is False.

EnableConversationWindowTabs

Optional

System.Boolean

When set to True, supplemental information related to an instant messaging session will be displayed in a separate browser window. This type of information is available only for custom applications that use the Microsoft Unified Communications APIs. For example, customer service or support team personnel can automatically access related information while chatting with someone.

When set to False, supplemental information will not be displayed in a separate browser window. Although the user can still take part in an instant messaging session he or she will not have access to any additional information that accompanies the session.

EnableEnterpriseCustomizedHelp

Optional

System.Boolean

When set to True, users who click the Help menu in 商務用 Skype will be given custom help set up by the organization.

EnableExchangeContactSync

Optional

System.Boolean

When set to True (the default value) 商務用 Skype creates a corresponding personal contact in Microsoft Outlook for each person on a user’s 商務用 Skype Contacts list.

EnableIMAutoArchiving

Optional

System.Boolean

When set to True, a transcript of every instant messaging session that a user takes part in will be saved to the Conversation History folder in Microsoft Outlook. When set to False, these transcripts will not be saved automatically. (However, users will have the option to manually save instant messaging transcripts.)

EnableSkypeUI

Optional

System.Boolean

When set to True, this parameter allows administrators to enable the 商務用 Skype user interface instead of the Lync interface for the 商務用 Skype client.

EnableUnencryptedFileTransfer

Optional

System.Boolean

When set to True, users will be allowed to exchange files with external users whose instant messaging software does not support encrypted file transfers. When set to False, users will only be able to exchange files with external users who have software that supports encrypted file transfers.

EnableURL

Optional

System.Boolean

When set to True, hyperlinks embedded in an instant message will be "clickable;" that is, users can click that link and their web browser will open to the specified location. When set to False, hyperlinks will appear in instant messages as plain text. To navigate to the location, users will need to copy the link text and paste it into their web browser.

ExcludedContactFolders

Optional

System.String

Indicates which Microsoft Outlook contact folders (if any) should not be searched any time 商務用 Skype searches for new contacts. Multiple folders can be specified by separating the folder names using semicolons; for example, -ExcludedContactFolders "SenderPhotoContacts;OtherContacts".

Force

Optional

System.Management.Automation.SwitchParameter

Suppresses the display of any non-fatal error message that might occur when running the command.

IMWarning

Optional

System.String

When configured, the specified message appears in the Conversation window each time a user takes part in an instant messaging session. For example, if IMWarning is set to "All information is the property of Litwareinc" then that message will appear in the Conversation window each time a user takes part in an instant messaging session.

If set to a null value ($Null), then no message appears in the Conversation window.

Your warning message should be limited to 256 characters, and can only contain plain text. You can't use any formatting (such as boldface or italics) and you can't have clickable URLs within the text.

MusicOnHoldAudioFile

Optional

System.String

Path to the audio file to be played when a caller is placed on hold. If a value is configured for this property, then music on hold will be enabled and users will not be allowed to disable the feature. If no value is configured for this property, then users can specify their own music-on-hold file, provided that EnableClientMusicOnHold is set to True.

PlayAbbreviatedDialTone

Optional

System.Boolean

When set to True, a 3-second dial tone will be played any time a 商務用 Skype-compatible handset is taken off the hook. (A 商務用 Skype handset looks like a standard telephone, but plugs into a USB port on a computer and is used to make 商務用 Skype calls rather than "regular" phone calls.) When set to False, a 30-second dial tone is played any time a 商務用 Skype-compatible handset is taken off the hook.

ShowManagePrivacyRelationships

Optional

System.Boolean

When set to True, shows the Relationships option in the 商務用 Skype Contacts list window. When set to False, hides the Relationships option.

The default value is False.

ShowRecentContacts

Optional

System.Boolean

When set to true, users that have been recently contacted (for example, in IM), will be automaticallly added to recent contacts in the 商務用 Skype client.

ShowSharepointPhotoEditLink

Optional

System.Boolean

If set to true, 商務用 Skype will include a link that enables users to edit the personal photo stored on SharePoint. The default value is false, which means that 商務用 Skype won't include a link to SharePoint.

TracingLevel

Optional

Microsoft.Rtc.Management.WritableConfig.Policy.Client.TracingLevel

Enables you to manage event tracing and logging in 商務用 Skype. Allowed values are:

Off – Tracing is disabled and the user cannot change this setting.

Light – Minimal tracing is performed, and the user cannot change this setting.

Full – Verbose tracing is performed, and the user cannot change this setting.

By default TracingLevel is set to Light.

WhatIf

Optional

System.Management.Automation.SwitchParameter

WhatIf 參數會指示命令模擬它將對物件採取的動作。透過使用 WhatIf 參數,不需要套用任何變更,就能檢視變更。您不需要利用 WhatIf 參數指定值。

None. The New-CsClientPolicy cmdlet does not accept pipelined input.

The New-CsClientPolicy cmdlet creates new instances of the Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy object.

 
顯示: