Set-MDMGlobalGatewayConfig
2/9/2009
The Set-MDMGlobalGatewayConfig cmdlet updates the global virtual private network (VPN) settings that all computers that are running Mobile Device Manager Gateway Server share.
Syntax
Set-MDMGlobalGatewayConfig [-Algorithm <CryptAlgorithmTypes>] [-DHGroup <DhGroupTypes>] [-DPDTimeout <int>] [-IKELifetime <int>] [-IPSecLifetime <int>] [-confirm] [-whatif] [<CommonParameters>]
Set-MDMGlobalGatewayConfig [-Config] <MDMGlobalGatewayConfig> [-confirm] [-whatif] [<CommonParameters>]
Parameters
The following describes the Set-MDMGlobalGatewayConfig cmdlet parameters.
- Config <MDMGlobalGatewayConfig>
Accepts an MDMGlobalGatewayConfig object.
- Algorithm <CryptAlgorithmTypes>
Specifies the allowed IPsec cryptographic algorithms. This is an unordered, comma-delimited list of the supported algorithms. MDM Gateway Server uses the strongest algorithms first and falls back to less strong algorithms if it is necessary. The acceptable values are any combination of None, CryptAes, and Crypt3Des. The default value is CryptAes.
- DHGroup <DhGroupTypes>
The Diffie-Hellman Groups used for key exchange. This is an unordered, comma-delimited list of the supported D-H Groups. MDM Gateway Server uses the strongest D-H Groups first and falls back to less strong groups, if it is necessary. The acceptable values are any combinations of None, Group2, Group5, Group14, Group15, or Group16. The default value is Group14.
- DPDTimeout <Int32>
Specifies the number of idle seconds after which MDM Gateway Server initiates a dead peer detection. The minimum value is 60. The default is value is 900.
- IKELifetime <Int32>
Specifies the number of seconds after which MDM Gateway Server initiates an Internet Key Exchange (IKE) SA rekey. The minimum value is 60 and the maximum value is 604,800 (seven days). The default value is 28,800 (8 hours). Note that MDM Gateway Server disconnects all managed devices when this value is changed.
- IPSecLifetime <Int32>
Specifies the number of seconds after which MDM Gateway Server initiates an IPsec SA rekey. The minimum value is 60 and the maximum value is 604,800 (seven days). The default value is 25,200 (seven hours). Note that MDM Gateway Server disconnects all managed devices when this value is changed.
- WhatIf
Informs you of what changes would be made if the action were to be performed (the cmdlet is not executed).
- Confirm
Prompts you for confirmation before the cmdlet executes.
- CommonParameters
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. For more information, at the MDM Shell prompt, type get-help about_commonparameters.
Input Type
The Set-MDMGlobalGatewayConfig cmdlet accepts an MDMGlobalGatewayConfig object through the pipeline. To see all the properties for this object, at the MDM Shell prompt, type Get-MDMGlobalGatewayConfig | Get-Member.
Output Type
None
Examples
This Set-MDMGlobalGatewayConfig command example sets the global gateway configuration to the following settings.
DPDTimeout |
1000 |
IKELifetime |
30,000 |
IPSecLifeTime |
30,000 |
DHGroup |
Group5,Group14 |
Algorithm |
CryptAES,Crypt3DES |
C:\PS>Set-MDMGlobalGatewayConfig -DPDTimeout 1000 -IKELifetime 30000 -IPSecLifeTime 30000 -DHGroup Group5,Group14 -Algorithm CryptAES,Crypt3DES
Cmdlet Help
To view this information online, at the MDM Shell prompt, type:
get-help Set-MDMGlobalGatewayConfig -detailed, or get-help Set-MDMGlobalGatewayConfig -full