Assigns a Skype for Business external access policy to a user.
Grant-DraCsExternalAccessPolicy -Domain <String> -PolicyName <String> [-Online <SwitchParameter>] -Identifier <String> [-DRARestServer <String>] [-DRARestPort <Int32>] [-IgnoreCertificateErrors <SwitchParameter>] [-Force <SwitchParameter>] [-Timeout <Int32>] [<CommonParameters>]
The Grant-DraCsExternalAccessPolicy cmdlet assigns a Skype for Business external access policy to the specified user. For Skype for Business Online external access policy we need to add 'Online' parameter in cmdlet.
|
Attribute / Description |
Parameters / Values |
||||
|---|---|---|---|---|---|
|
Required |
Position |
Default Value |
Accept Pipeline input? |
Accept wildcard characters? |
|
|
PolicyName <String> The name of the policy to be assigned. |
true |
named |
|
true (ByPropertyName) |
false |
|
Online [<SwitchParameter>] Flag indicating Skype for Business Online Cmdlet. |
false |
named |
|
true (ByPropertyName) |
false |
|
Identifier <String> The name or distinguished name of an existing Active Directory object. When the name is specified, an additional call to the DRA Server is needed to obtain the distinguished name for the object. |
true |
named |
|
true (ByPropertyName) |
false |
|
Domain <String> The domain of the object in fqdn format. For example: mydomain.corp |
true |
named |
|
true (ByPropertyName) |
false |
|
DRARestServer [<String>] The name of the computer running the DRA Rest Service. The requested DRA operation will execute on this server. If the parameter is not specified, the value defaults to 'localhost'. |
false |
named |
|
true (ByPropertyName) |
false |
|
DRARestPort [<Int32>] The port where the DRA REST Service listens for requests. If the parameter is not specified, the value defaults to 8755. |
false |
named |
8755 |
true (ByPropertyName) |
false |
|
IgnoreCertificateErrors [<SwitchParameter>] Allows the request to bypass any SSL certificate errors, such as the InvalidOperation error that occurs when the REST Service is bound to a self-signed certificate. |
false |
named |
|
false |
false |
|
Force [<SwitchParameter>] Suppresses any request for user input and supplies a 'yes' response. For example: -Force with a delete request will perform the delete without presenting the confirmation request to the user. |
false |
named |
|
false |
false |
|
Timeout [<Int32>] The number of seconds to wait before the request to the DRA REST server times out. To specify an infinite timeout, you can set this parameter to -1. |
false |
named |
100 seconds |
false |
false |
|
<CommonParameters> Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see About CommonParameters. |
|
|
|
|
|
NOTE:For more information, type "Get-Help Grant-DraCsExternalAccessPolicy -detailed". For technical information, type "Get-Help Grant-DraCsExternalAccessPolicy -full".
Example 28-6 1
PS C:\>Grant-DraCsExternalAccessPolicy -Domain MyDomain.corp -Identifier "CN=Bob Jones,OU=Accounting,DC=MyDomain,DC=corp" -PolicyName FederationAndPICDefault
This example assigns the FederationAndPICDefault policy to the user Bob Jones.
Example 28-7 2
PS C:\>Grant-DraCsExternalAccessPolicy -Domain MyDomain.corp -Identifier "CN=Bob Jones,OU=Accounting,DC=MyDomain,DC=corp" -PolicyName FederationAndPICDefault -Online
This example assigns the FederationAndPICDefault policy to the user Bob Jones. We need to add the 'Online' parameter for the Skype for Business Online cmdlet.